8.0 MigrateAgent 公用程式

MigrateAgent (MigrateAgent.cli.exe) 是一個指令行公用程式,可用於安裝、升級、查詢或解除安裝區塊式傳輸驅動程式。雖然安裝、解除安裝或升級驅動程式時一律需要重新開機,但在您執行這些動作並因此需要將伺服器重新開機時,MigrateAgent 可讓您更好地進行控制。例如,您可以使用 MigrateAgent 在排定的停機時間安裝驅動程式,而不用在第一次複製時進行安裝。

MigrateAgent 公用程式的語法為︰

MigrateAgent.cli.exe [Option] [/psserver=%IP%]

表 8-1 描述了 MigrateAgent.cli.exe 指令可用的選項和參數。

表 8-1 MigrateAgent 指令的選項和參數

使用率

描述

選項

h|?|help

顯示指令的用法和選項。

logs|view-logs

開啟應用程式記錄目錄。

status

顯示 PlateSpin 控制器和驅動程式的安裝狀態。

din|driver-install

安裝 PlateSpin 驅動程式。

dup|driver-upgrade

升級 PlateSpin 驅動程式。

dun|driver-uninstall

解除安裝 PlateSpin 驅動程式。

參數

/psserver=%IP%

如果您呼叫了 statusdriver-installdriver-upgrade 選項,該參數可從指定的伺服器下載區塊式傳輸驅動程式。

MigrateAgent 公用程式中捆綁了區塊式傳輸驅動程式的一個副本。您也可以指定 /psserver= 指令行參數,以在呼叫 statusdriver-installdriver-upgrade 選項時從 PlateSpin 伺服器下載驅動程式。當使用新驅動程式套件修正了伺服器,但 MigrateAgent 指令行公用程式未得到修正時,此方法十分有用。

附註:為了避免混淆,MigrateAgent 的建議用法是安裝、解除安裝或升級驅動程式,然後在執行複製之前重新開機。

每次安裝、升級或解除安裝驅動程式後,都應該將系統重新開機。重新開機會強制停止正在執行的驅動程式,並在系統重新啟動時強制套用新驅動程式。如果您在複製之前未將系統重新開機,來源會繼續如同該操作未完成一般運作。例如,如果您安裝了驅動程式但未將系統重新開機,則在複製期間,來源會如同驅動程式未安裝一般運作。同樣,如果您升級了驅動程式但未重新開機,則來源在複製期間將會繼續使用正在執行的驅動程式,直到您將系統重新開機。

如果安裝的驅動程式版本不同於正在執行的驅動程式版本,status 選項會提醒使用者重新開機。例如:

C:\MigrateAgent\MigrateAgent.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
    The PlateSpin Controller service is not installed
   
PlateSpin Driver Status
    Installed Driver Version: 8.0.0.11
    Running Driver Version: Not running. Reboot to load the driver.
    Upgrade Available: No

PlateSpin 會建立一個任務警告使用者,必須重新開機才能完成驅動程式的安裝或升級。該通知將會顯示在「任務」清單中 (圖 8-1)。在複製期間,該通知將會顯示在「指令詳細資料」頁面上 (圖 8-2)。

圖 8-1 重新開機通知任務

圖 8-2 複製期間的重新開機通知

將來源機器重新開機即會套用並啟動已安裝或升級的驅動程式。如果驅動程式是最近安裝的,則在重新開機之後,需要執行一次完整複製或伺服器同步複製,以確保擷取來源的所有變更。「狀態」欄位中會以警告形式通知使用者需要進行此伺服器同步複製 (圖 8-3)。後續的增量複製不顯示警告即會完成。

圖 8-3 需要伺服器同步通知