7.0 ProtectAgentユーティリティ
ProtectAgent (ProtectAgent.cli.exe)は、ブロックベース転送ドライバのインストール、アップグレード、クエリ、またはアンインストールに使用できるコマンドラインユーティリティです。ドライバをインストール、アンインストール、またはアップグレードする場合は常に再起動する必要がありますが、ProtectAgentを使用すると、アクションを実行するタイミング、つまりサーバを再起動するタイミングを詳細に制御できます。たとえば、ProtectAgentを使用して、ドライバのインストールを、最初のレプリケーションの実行中ではなく、スケジュールされたダウンタイム中に実行できます。
ProtectAgentユーティリティの構文は次のとおりです。
ProtectAgent.cli.exe [Option] [/psserver=%IP%]
表 7-1では、ProtectAgent.cli.exeコマンドで使用できるオプションとスイッチについて説明します。
表 7-1 ProtectAgentコマンドのオプションとスイッチ
|
使用法 |
説明 |
|---|---|
|
オプション |
|
|
h|?|help |
このコマンドの使用方法とオプションを表示します。 |
|
logs|view-logs |
アプリケーションログディレクトリを開きます。 |
|
status |
PlateSpinのコントローラとドライバのインストールステータスを表示します。 |
|
din|driver-install |
PlateSpinドライバをインストールします。 |
|
dup|driver-upgrade |
PlateSpinドライバをアップグレードします。 |
|
dun|driver-uninstall |
PlateSpinドライバをアンインストールします。 |
|
スイッチ |
|
|
/psserver=%IP% |
status、driver-install、またはdriver-upgradeの各オプションの呼び出し時に、指定されたサーバからブロックベース転送ドライバをダウンロードします。 |
ProtectAgentユーティリティには、ブロックベース転送ドライバがバンドルされています。別の方法として、status、driver-install、またはdriver-upgradeの各オプションの呼び出し時にPlateSpin Serverからドライバをダウンロードするために、/psserver=コマンドラインスイッチを指定することができます。この方法は、サーバには新しいドライバパッケージでパッチが適用されていても、ProtectAgentコマンドラインユーティリティにはパッチが適用されていない場合に便利です。
メモ:混乱を避けるために、ProtectAgentを使用する場合は、ドライバをインストール、アンインストール、またはアップグレードした後、レプリケーションを実行する前に再起動することをお勧めします。
システムは、ドライバをインストール、アップグレード、またはアンインストールするたびに再起動する必要があります。再起動により、実行中のドライバは停止し、新しいドライバがシステム再起動時に適用されます。レプリケーションの前にシステムを再起動しなかった場合、ソースはそれらの操作が完了していないかのように動作を続行します。たとえば、ドライバをインストールした後でシステムを再起動しなかった場合、ソースは、レプリケーション中にインストールされたドライバがないかのように動作します。同様に、ドライバをアップグレードした後で再起動しなかった場合、ソースは、システムを再起動するまで実行中のドライバをレプリケーション時に使用し続けます。
インストールされたドライバのバージョンと実行中のドライバのバージョンが異なる場合、statusオプションの出力によって、再起動が必要であることが示されます。次に例を示します。
C:\ProtectAgent\ProtectAgent.cli.exe /status
Step 1 of 2: Querying the PlateSpin controller service
Done
Step 2 of 2: Querying the installed PlateSpin driver version
Done
The task completed successfully
PlateSpin Controller Service Status
Status: Running
Version: 9.9.9.9
Last Successful Contact: 1/5/2015 12:14:25 PM
PlateSpin Driver Status
Installed Driver Version: 8.0.0.11
Running Driver Version: Not running. Reboot to load the driver.
Upgrade Available: No
PlateSpinは、ドライバのインストールまたはアップグレードを完了するために再起動が必要であることをユーザに警告するタスクを作成します。この通知は、［Tasks (タスク)］リスト(図 7-1)に表示されます。レプリケーション中は、この通知が［コマンドの詳細］ページ(図 7-2)に表示されます。
図 7-1 再起動通知タスク
図 7-2 レプリケーション中の再起動通知
ソースマシンを再起動すると、インストールまたはアップグレードしたドライバが適用されて起動します。ドライバが最近インストールされた場合、ソースのすべての変更が反映されていることを保証するために、再起動後に完全レプリケーションまたはサーバ同期レプリケーションを1回実行する必要があります。このサーバ同期レプリケーションは、[Status (ステータス)]フィールドで警告として表示されます(図 7-3)。それ以降の増分レプリケーションは、警告なしで完了します。
図 7-3 サーバ同期の必要性の通知
