Replication Manager Application Agent CLI ユーザーズガイド
オペレーション定義ファイルは,拡張コマンドを使用するシステムの構成に合わせて作成します。作成したオペレーション定義ファイルは,拡張コマンドを実行する各サーバの次のディレクトリに格納します。
<Application Agentのインストール先>\DRM\script\conf\
オペレーション定義ファイルを所定のディレクトリに格納したあとは,オペレーション定義ファイルチェックツールを実行して,オペレーション定義ファイルの内容のチェックと,拡張コマンド用一時ディレクトリの自動生成をします。
- この項の構成
- (1) オペレーション定義ファイルの配置
- (2) オペレーション定義ファイルの形式
- (3) オペレーション定義ファイルの作成例
オペレーション定義ファイルは,拡張コマンドを実行する各サーバに配置します。データベースサーバがクラスタ構成の場合は,バックアップ対象となるクラスタリソース(マウントポイントまたはファイル)が定義されているすべてのサーバに,同一のオペレーション定義ファイルを配置します。バックアップサーバを使用する場合は,データベースサーバとバックアップサーバとで同一のオペレーション定義ファイルを配置してください。
オペレーション定義ファイルの配置例を次の図に示します。
図3-12 オペレーション定義ファイルの配置例(バックアップ対象がSQL Serverデータベースの場合)
この例では,クラスタを構成するデータベースサーバA(サーバ名:DBServer_A)およびデータベースサーバB(サーバ名:DBServer_B)で,仮想サーバC(サーバ名:VServer_C)が動作しています。
データベースサーバAおよびデータベースサーバB上にはSQL Serverインスタンス「INSTANCE_1」が在り,クラスタリソースとして仮想サーバCが定義されています。
この場合,データベースサーバA,データベースサーバBおよびバックアップサーバ(サーバ名:BKServer)には,「INSTANCE_1」に関するオペレーション定義ファイルを配置します。
オペレーション定義ファイルは,処理の対象を一意に特定するオペレーションIDに対応して,次のような名称で作成します。
<Application Agentのインストール先>\DRM\script\conf\_<オペレーションID>.dat
オペレーション定義ファイルのサンプルは,次の場所にあります。
<Application Agentのインストール先>\DRM\script\sample
オペレーション定義ファイルの指定項目と指定する内容およびデータの最大バイト数を次の表に示します。
表3-49 オペレーション定義ファイルの指定項目と指定する内容およびデータの最大バイト数(バックアップ対象がSQL Serverデータベースの場合)
指定項目 指定内容 最大バイト数※ BACKUP_OBJECT バックアップ対象の種別を示す文字列を指定します。
「MSSQL」と指定します。32 DB_SERVER_NAME データベースサーバ名を指定します。
クラスタ構成の場合は,クラスタリソースに対応する仮想サーバ名を指定します。この仮想サーバ名は,Application Agentの構成定義ファイル(init.conf)の「DRM_DB_PATH=<共有ディスク上のディレクトリ>;<仮想サーバ名>」に定義されている必要があります。128 INSTANCE_NAME SQL Serverインスタンス名を指定します。空白を含む場合は引用符(")で囲んで記述します。
DEFAULTを指定した場合,SQL Serverの既定インスタンス名が選択されます。128 TARGET_NAME バックアップするデータベース名を指定します。
この指定はバックアップ実行時だけ有効です。リストア実行時のデータベース指定には使用されません。
コンマで区切って複数指定できます。空白を含む場合は引用符(")で囲んで記述します。指定を省略した場合,インスタンス単位にバックアップが実行されます。
TARGET_NAMEにバックアップするデータベース名を指定した場合,EX_DRM_SQL_BACKUPコマンドの-systemオプションは指定できません。1,024 FTP_HOME_DIR バックアップサーバを使用する場合,バックアップサーバのIISで指定したFTPサービスのホームディレクトリ名を指定します。
バックアップサーバを使用しない場合は,サンプルの値から変更しないでください。128 FTP_SUB_DIR バックアップサーバを使用する場合,FTPサービスのホームディレクトリ(FTP_HOME_DIRで指定したバックアップサーバのディレクトリ)の下に作成するサブディレクトリの名前を指定します。
ここで指定したディレクトリの配下に,拡張コマンド用一時ディレクトリが自動で作成されます。拡張コマンド用一時ディレクトリの詳細は,「3.14.9 拡張コマンド用一時ディレクトリの確認」を参照してください。
バックアップサーバを使用しない場合は,サンプルの値から変更しないでください。128 SET_DRM_HOSTNAME データベースサーバの構成を指定します。クラスタ構成の場合は「1」,クラスタ構成でない場合は「0」を指定します。 1
- 注※
- 複数指定するときに使用するコンマも1バイトと見なします。ヘッダ部分「<指定項目名>=」はバイト数に含みません。
クラスタ構成のシステムを想定して,オペレーション定義ファイルを作成する例について説明します。
この例の前提条件は次のとおりです。
- クラスタを構成するデータベースサーバA(サーバ名:DBServer_A)およびデータベースサーバB(サーバ名:DBServer_B)で,仮想サーバC(サーバ名:VServer_C)が動作している。
- データベースサーバAおよびデータベースサーバB上にはSQL Serverインスタンス「INSTANCE_1」が在り,クラスタリソースとして仮想サーバCが定義されている。
- データベースサーバAおよびデータベースサーバBに,クラスタグループ「SQLCG_1」が在り,次の表に示すクラスタリソースが登録されている。
表3-50 クラスタリソースの例(バックアップ対象がSQL Serverデータベースの場合)
クラスタグループ名 仮想サーバ SQL Server
インスタンス名SQLCG_1 VServer_C INSTANCE_1 - バックアップサーバ(サーバ名:BKServer)上でIISのFTPサービスが設定され,FTPサービスが起動されている。FTPサイトのホームディレクトリは「C:\FTP_ROOT」とする。
- FTPサブディレクトリは「script」とする。
- データベースサーバAが現用サーバ,データベースサーバBが待機サーバとして設定されていて,共有ディスクとして「G:」を使用している。
- 「INSTANCE_1」に対してdrmsqlinitコマンドが実行されている。
- 環境設定ファイル「init.conf」に「DRM_DB_PATH=<共有ディスク上のディレクトリ名>;<仮想サーバ名>」が設定されている。
- データベースサーバA,データベースサーバBで,次の表に示すVDIメタファイル格納ディレクトリが作成されている。
- ディクショナリマップファイル格納ディレクトリにApplication Agentが拡張コマンド用一時ディレクトリを自動作成できる権限がある。
- 拡張コマンド用一時ディレクトリが自動作成されるディスクに,次の一時ファイルが格納できる十分な空き容量がある。
- バックアップID記録ファイル
- バックアップ情報のファイル
- VDIメタファイル
- 拡張コマンド用一時ディレクトリの命名規則に従ってディレクトリが自動生成されたときに,ディレクトリの長さがOSの制限を超えない。
サーバ名 VDIメタファイル格納ディレクトリ DBServer_A
DBServer_BG:\MSSQL\VServer_C\INSTANCE_1\META この例では,次の表に示すオペレーションIDに対応するオペレーション定義ファイルを作成します。
表3-52 オペレーション定義ファイルを作成するオペレーションID(バックアップ対象がSQL Serverでクラスタ構成の場合)
オペレーションID 対象データベースサーバ 対象インスタンスおよびデータベース Operation_A VServer_C INSTANCE_1の全体 クラスタ構成の場合にオペレーション定義ファイルを作成するには:
- 現用サーバ(データベースサーバA)にオペレーション定義ファイルを作成し,必要な項目を設定します。
次のファイルを作成します。
<Application Agentのインストール先>\DRM\script\conf\_Operation_A.dat
「<Application Agentのインストール先>\DRM\script\conf\_Operation_A.dat」の記述例を次に示します。
BACKUP_OBJECT=MSSQL DB_SERVER_NAME=VServer_C INSTANCE_NAME=INSTANCE_1 TARGET_NAME= FTP_HOME_DIR=C:\FTP_ROOT FTP_SUB_DIR=script SET_DRM_HOSTNAME=1- 現用サーバ(データベースサーバA)でオペレーション定義ファイルのチェックツール「EX_DRM_SQL_DEF_CHECK」を実行します。
EX_DRM_SQL_DEF_CHECK <オペレーションID> -dbオペレーション定義ファイルのチェックが実行されます。また,拡張コマンド用一時ディレクトリが自動生成されます。
エラーがあった場合はファイルの指定内容を修正し,チェックツールを再度実行します。- 現用サーバ(データベースサーバA)で作成したオペレーション定義ファイルをバックアップサーバにコピーします。
次のフォルダにコピーします。
<Application Agentのインストール先>\DRM\script\conf\- バックアップサーバでオペレーション定義ファイルのチェックツール「EX_DRM_SQL_DEF_CHECK」を実行します。
EX_DRM_SQL_DEF_CHECK <オペレーションID> -bkオペレーション定義ファイルのチェックが実行されます。また,拡張コマンド用一時ディレクトリやVDIメタファイル格納ディレクトリが自動生成されます。
エラーがあった場合は,バックアップサーバの構成をオペレーション定義ファイルの内容に合わせて変更するか,オペレーション定義ファイルの内容をバックアップサーバの構成に合わせて変更してください。バックアップサーバの構成を変更する場合は,チェックツールを再度実行します。オペレーション定義ファイルの内容を変更した場合は,データベースサーバにも同一のファイルを格納し,チェックツールを再度実行します。- 現用サーバ(データベースサーバA)で作成したオペレーション定義ファイルを待機サーバ(データベースサーバB)にコピーします。
次のディレクトリにコピーします。
<Application Agentのインストール先>\DRM\script\conf\- 待機サーバ(データベースサーバB)でオペレーション定義ファイルのチェックツール「EX_DRM_SQL_DEF_CHECK」を実行します。
EX_DRM_SQL_DEF_CHECK <オペレーションID> -db
All Rights Reserved. Copyright© 2014, 2020, Hitachi, Ltd.