msagentadmin administrationコマンド
msagentadmin administration コマンドを実行して、Microsoft application agent のロックボックス操作を実行し、バックアップを一覧表示および削除することができます。また、msagentadmin administration コマンドを実行して、Data Domain Cloud Tierの操作を実行し、Data Domainストレージ ユニットのストリーム制限を確認することもできます。
注: 特定のバックアップおよびリストア操作の場合、Microsoft application agent は、msagentadmin コマンドに加えてddbmadmin コマンドもサポートします。ただし、ddbmadmin コマンドは推奨されません。
ここでは、msagentadmin administration コマンドの詳細について示します。
msagentadmin管理コマンドを使用したロックボックス操作
ロックボックスは、Microsoft application agent がログイン認証情報などの機密データを保存して、不正アクセスからそのデータを保護するために使用される暗号化されたファイルです。すべてのロックボックス操作を実行するには、管理ユーザーがmsagentadmin administration コマンドを実行する必要があります。ロックボックスの構成 に、すべてのロックボックス操作の詳細が記載されています。
管理者ユーザーとして、適切なパラメーターを指定してmsagentadmin administration コマンドを実行することにより、ロックボックスを作成、登録、管理する必要があります。
ロックボックスを作成するには、次のコマンドを実行します。
msagentadmin administration --createLB [--lockbox <lockbox_directory> ] [--debug 9]
ロックボックスのディレクトリーを指定しなかった場合は、デフォルトのディレクトリー(C:\Program Files\DPSAPPS\common\lockbox )が使用されます。
ロックボックスをインポートするには、次のコマンドを実行します。
msagentadmin administration --updateLB -a LOCKBOX_IMPORT=yes -a LOCKBOX_PATH=<lockbox_directory>
このコマンドは、ロックボックスがデフォルト以外のディレクトリーに作成される場合、およびロックボックスを最新バージョンにアップデート(インポート)する必要がある場合に便利です。
認証情報をロックボックスに登録するには、次のコマンドを実行します。
msagentadmin administration --registerLB --config <config_file_path> [--confirm] [--debug 9]
構成ファイルとロックボックスから認証情報を削除するには、次のコマンドを実行します。
msagentadmin administration --deleteLB --config <config_file_path> [--confirm] [--debug 9]
ロックボックスへのアクセスをリモート ホストに許可するには、次のコマンドを実行します。
msagentadmin administration --grantLB [--lockbox <lockbox_directory> ] [-a "LOCKBOX_REMOTE_HOST=<hostname_to_add> "] [-a "VIRTUAL_HOST=yes"] [--debug 9]
リモート ホストがロックボックスに対して持っているアクセスを取り消すには、次のコマンドを実行します。
msagentadmin administration --revokeLB [--lockbox <lockbox_directory> ] [-a "LOCKBOX_REMOTE_HOST=<hostname_to_delete> "] [--debug 9]
ロックボックスをリセットするには、次のコマンドを実行します。
msagentadmin administration --updateLB [--lockbox <lockbox_directory> ] [--debug 9]
ロックボックスのカスタム パスフレーズを作成するには、次のコマンドを実行します。
msagentadmin administration --updateLB -a SET_LOCKBOX_PASSPHRASE=TRUE -a LOCKBOX_PATH=<lockbox_directory>
このコマンドを入力すると、次のプロンプトが表示されます。このプロンプトを使用してパスフレーズを設定します。
Enter a passphrase (refer to the administration guide for passphrase complexity requirements):
Confirm the passphrase:
次の出力が表示されます。
The passphrase for the lockbox '<lockbox> ' in the directory '<lockbox_directory> ' has been updated.
注: このカスタム パスフレーズは次の複雑な要件を満たす必要がある。
文字長は最低9文字。
最低1大文字の大文字を含む。
最低1大文字の小文字を含む。
最低1文字の特殊文字を含む。
最低1文字の数字を含む。
パスフレーズは、ロックボックスにアクセスできないホストにアクセスしてリストアするために使用される場合があります。
カスタム パスフレーズを使用してロックボックスをリセットするには、次のコマンドを実行します。
msagentadmin administration --updateLB -a USE_LOCKBOX_PASSPHRASE=TRUE -a LOCKBOX_PATH=<lockbox_directory>
このコマンドを入力すると、次のプロンプトが表示されます。このプロンプトを使用してパスフレーズを設定します。
Enter a previously set passphrase:
次の出力が表示されます。
The lockbox '<lockbox> ' in the directory '<lockbox_directory> ' has been reset.
ロックボックスのSystem Stable Value( SSV)の閾値に、セキュリティが低い場合のカスタム セキュリティ オプションを作成するには、次のコマンドを実行します。
msagentadmin administration --updateLB -a SET_LOCKBOX_SECURITY="custom" -a LOCKBOX_PATH=<lockbox_directory>
このコマンドは、通常のシステム アップデートの後にロックボックスが頻繁にアクセス不能になる場合に便利です。ただし、ロックボックスをリセットするために、セキュリティ レベルをカスタマイズする代わりに、パスフレーズを使用することをお勧めします。
msagentadmin管理コマンドを使用したバックアップの一覧表示
バックアップを一覧表示する、またはファイルを保存するには、次の構文のmsagentadmin administration コマンドを実行します。
msagentadmin administration {--list | --listfiles} --ddhost "<server_name> " --ddpath "<name_and_path_of_storage_unit >" --dduser "<DD_Boost_username >" --appID "msapp_bbb " --before <end_time> [<optional_parameters> ]
ここで、
{--list | --listfiles}
リスト操作のタイプを指定する。次のパラメーターのうちの1つのみを選択する必要がある。
--ddhost "<server_name> "
データベースのバックアップ先にしたストレージ ユニットが置かれているサーバーの名前を指定する。
--ddpath "/<storage_unit_name_and_path> "
データベースをバックアップしたストレージ ユニットの名前とパスを指定する。
--dduser "<DD_Boost_user> "
DD Boostユーザーのユーザー名を指定する。
--appID "msapp_bbb"
バックアップを検索するアプリケーションID(ネームスペース)を指定する。msapp_bbb for Exchange Serverを指定する。
--appID パラメーターに-n エイリアスを使用できます。
--before <end_time>
任意の日付と時刻、日付、曜日、時刻か、その前に作成されたバックアップのみを一覧表示する。
例えば、now 、3/31/2016 15:00:00 、Tuesday などです。
--before パラメーターに-e エイリアスを使用できます。
msagentadmin管理コマンドのオプション パラメーター では、msagentadmin administration コマンドで使用できるオプション パラメーターを説明します。
msagentadminリスト コマンドの例 に、msagentadmin administration リスト コマンドの例が記載されています。
msagentadmin管理コマンドを使用したバックアップの削除
msagentadmin administration コマンドを実行して、バックアップまたはセーブ セットを削除できます。このコマンドは、最初にバックアップを一覧表示してから削除します。
注:
Data Domainのバックアップ コピーがPowerProtect Data Manager保護ポリシーのスケジュールを使用して管理される場合、期限切れのバックアップ コピーはスケジュールに従って削除されます。これらのバックアップ コピーは、msagentadmin administration コマンド経由で削除してはいけません。
このコマンドを使用してPowerProtect Data Managerによって管理されているバックアップコピーを削除しようとすると、エラー メッセージが表示されます。
バックアップまたはセーブ セットを削除するには、次の構文でmsagentadmin administration コマンドを実行します。
msagentadmin administration --delete --ddhost "<name> " --ddpath "/<storage_unit_name_and_path> " --dduser "<DD_Boost_user> " --appID "msapp_bbb" <optional_parameters>
ここで、
--delete
削除操作を指定する。
--ddhost "<name> "
データベースをバックアップしたストレージ ユニットを含むData Domainサーバーの名前を指定する。
--ddpath "/<storage_unit_name_and_path> "
データベースをバックアップしたストレージ ユニットの名前とパスを指定する。
--dduser "<DD_Boost_user> "
DD Boostユーザーのユーザー名を指定する。
--appID "msapp_bbb"
バックアップを検索するアプリケーションID(ネームスペース)を指定する。msapp_bbb for Exchange Serverを指定する。
--appID パラメーターに-n エイリアスを使用できます。
msagentadmin管理コマンドのオプション パラメーター では、msagentadmin administration コマンドで使用できるオプション パラメーターを説明します。
msagentadmin削除コマンドの例 に、msagentadmin administration 削除コマンドの例を示します。
msagentadmin管理コマンドを使用したData Domain Cloud Tier操作
--move パラメーターでmsagentadmin administration コマンドを実行し、バックアップをマークして、Data Domainストレージ ユニットからData Domain Cloud Tierに移動させる必要があります。--recall パラメーターでコマンドを実行し、Data Domain Cloud TierからData Domainストレージ ユニットにセーブ セットをリコールする必要があります。Data Domain Cloud Tierでのセーブセットの移動とリコール に、msagentadmin administration コマンドを使用したクラウド階層操作の実行の詳細が記載されています。
Data Domain Cloud Tier操作の場合、次のように適切なパラメーターを指定して、msagentadmin administration コマンドを実行します。
セーブ セットをData Domain Cloud Tierデバイスに移動するには、次のコマンドを実行します。
msagentadmin administration --move --ddhost "<Data_Domain_server_name >" --ddpath "<name_and_path_of_storage_unit >" --dduser "<DDBoost_username >" --appID "msapp_bbb" [<optional_parameters> ]
ここで、
--move
セーブセットを移動する操作を指定する。
--move パラメーターに-m エイリアスを使用できます。
--ddhost "<name> "
データベースをバックアップしたストレージ ユニットを含むData Domainサーバーの名前を指定する。
--ddpath "/<storage_unit_name_and_path> "
データベースをバックアップしたストレージ ユニットの名前とパスを指定する。
--dduser "<DDBoost_user> "
DD Boostユーザーのユーザー名を指定する。
--appID "msapp_bbb"
バックアップを検索するアプリケーションID(ネームスペース)を指定する。msapp_bbb for Exchange Serverを指定する。
--appID パラメーターに-n エイリアスを使用できます。
注意: 後でセーブ セットをマークする場合は、その前にマークしたセーブ セットを--after パラメーターおよび--before パラメーターでマークしないでください。以前マーキングされたセーブセットをマーキングしている場合、データ移動のパフォーマンスに影響することがあります。
msagentadmin管理コマンドのオプション パラメーター では、msagentadmin administration コマンドで使用できるオプション パラメーターを説明します。
Data Domain Cloud Tierへのセーブセットの移動 に、Data Domain Cloud Tierデバイスへの移動のためにセーブ セットをマーキングするコマンド例を示します。
セーブ セットをData Domain Cloud Tierデバイスからリコールするには、次のコマンドを実行します。
msagentadmin administration --recall --ddhost "<Data_Domain_server_name >" --ddpath "<name_and_path_of_storage_unit >" --dduser "<DDBoost_username >" --appID "msapp_bbb" [<optional_parameters> ]
ここで、
--recall
セーブセットをリコールする操作を指定する。
--recall パラメーターに-r エイリアスを使用できます。
--ddhost "<name> "
データベースをバックアップしたストレージ ユニットを含むData Domainサーバーの名前を指定する。
--ddpath "/<storage_unit_name_and_path> "
データベースをバックアップしたストレージ ユニットの名前とパスを指定する。
--dduser "<DDBoost_user> "
DD Boostユーザーのユーザー名を指定する。
--appID "msapp_bbb"
バックアップを検索するアプリケーションID(ネームスペース)を指定する。msapp_bbb for Exchange Serverを指定する。
--appID パラメーターに-n エイリアスを使用できます。
msagentadmin管理コマンドのオプション パラメーター では、msagentadmin administration コマンドで使用できるオプション パラメーターを説明します。
Data Domain Cloud Tierからのセーブセットのリコール に、セーブ セットをData Domain Cloud Tierデバイスからリコールするコマンド例を示します。
msagentadmin管理コマンドを使用したストリーム制限の確認
Data Domain operating systemコマンドまたはData Domain管理GUIを使用して、次のData Domainリソースの使用に制限を設定できます。
Data Domain operating systemは、容量またはストリームの使用量のソフト リミットとハード リミットをサポートします。Data Domain管理者は、各アプリケーション エージェント ホストまたは制限されるホスト セットに異なるストレージ ユニットを作成する必要があります。
ストレージ ユニットのストリーム制限を判別するためには、次のコマンドを実行します。
msagentadmin administration --listSU --config <full_path_to_the_configuration_file> [--debug 9]
このコマンドのサンプル出力を次に示します。
active write streams: 11
active read streams: 0
soft limit write streams: none
soft limit read streams: none
soft limit combined streams: 40
hard limit combined streams: 60
DDリソースの使用制限の構成 で、使用量制限について詳しく説明します。