G.3 適用於 Linux 的 Migrate 代理程式公用程式

在安裝或使用 Migrate 代理程式之前，請確定您的系統符合Migrate 代理程式公用程式的要求。

G.3.1 在來源 Linux 工作負載上下載並安裝 Migrate 代理程式

在安裝適用於 Linux 的 Migrate 代理程式公用程式之前，請確定來源機器已安裝 GNU C Library (glibc) 2.11.3 或更新版本。

請務必下載適合來源 Linux 機器架構的應用程式。檔案案名區分大小寫。

64 位元︰ MigrateAgent-x86_64.tar.gz
32 位元︰ MigrateAgent-x86.tar.gz

若要在來源工作負載中下載並安裝適用於 Linux 的 Migrate 代理程式公用程式︰

以 root 使用者身分登入來源 Linux 工作負載。
使用以下方法之一獲取 MigrateAgent-arch.tar.gz 檔案。

請以合適的架構 (x86_64 或 x86) 取代 arch。
- 從 Web 介面下載壓縮檔案︰
  1. 在網頁瀏覽器中，啟動 PlateSpin Migrate Web 介面並登入。
    
    https://<Your_PlateSpin_Server >/Migrate
    
    請以您 PlateSpin Migrate 伺服器的 DNS 名稱或 IP 位址取代 Your_PlateSpin_Server。
  2. 按一下下載索引標籤。
  3. 按一下相應 Linux 平台 (x86_64 或 x86) 的 Migrate 代理程式應用程式連結，然後儲存 MigrateAgent-arch.tar.gz 檔案。
  -或-
- 使用 wget 指令從 PlateSpin 伺服器複製該檔案。
  
  附註：如果 PlateSpin 伺服器主機上的作業系統僅接受 TLS 1.2 連接，請在來源 Linux 工作負載上使用 wget 1.16.1 或更高版本。
  1. 啟動終端機，然後輸入
    wget --no-check-certificate --http-user=<username> --http-password=<password> https://<Your_PlateSpin_Server>/Migrate/Downloads/MigrateAgent-<arch>.tar.gpz
    
    請以您 PlateSpin Migrate 伺服器的 DNS 名稱或 IP 位址取代 Your_PlateSpin_Server。請以 x86_64 或 x86 取代 arch。
在歸檔管理員中開啟 MigrateAgent-arch.tar.gz 檔案，然後將 MigrateAgent 目錄及其內容擷取到根目錄 (/)。

或者，在外圍程序提示中輸入
```
tar xvf MigrateAgent-<arch>.tar.gz
```
請以 x86_64 或 x86 取代 arch。
將目錄切換到 /MigrateAgent 目錄，然後列出其內容。在終端機中輸入︰
```
cd MigrateAgent
ls
```
該目錄包含 commands 檔案和 MigrateAgent 指令檔案。
輸入以下指令，以檢視指令說明︰
```
./MigrateAgent -h
```

G.3.2 適用於 Linux 的 Migrate 代理程式指令

執行 Migrate 代理程式公用程式所用的語法為︰

./MigrateAgent [Command] [-h]

表 G-2 描述了 Linux 上 MigrateAgent.cli.exe 指令可用的選項和引數。

表 G-2 適用於 Linux 的 Migrate 代理程式公用程式的指令選項和引數

使用率	描述
指令
register <伺服器> <使用者> [[-p 密碼] \| [-pf <密碼檔案路徑>]] 對於伺服器，請指定 PlateSpin Migrate 伺服器的 DNS 名稱或 IP 位址。對於使用者，請指定有權新增工作負載的管理員層級使用者的有效 PlateSpin 伺服器使用者名稱。對於密碼，請執行以下其中一項操作︰使用 -p 選項，並在指令中輸入指定 PlateSpin 使用者名稱的密碼。 -p mypassword 使用 -pf 選項指定包含所指定 PlateSpin 使用者名稱的密碼的檔案路徑。 -pf /tmp/jsmith-password-file.txt 不在指令中指定密碼。系統將提示您在指令行中輸入密碼。範例︰ ./MigrateAgent register 10.10.10.101 jsmith -p jspwd	將此機器註冊為指定伺服器上的工作負載。此指令還會檢查指定的 PlateSpin 伺服器中是否有驅動程式升級。可讓您新增無法探查的工作負載。註冊的工作負載與探查的工作負載存在以下方面的差異︰註冊的來源工作負載不會儲存來源身分證明。您必須使用 Migrate 代理程式在註冊的來源工作負載中安裝、升級和移除 Linux blkwatch 驅動程式。在刪除所註冊來源工作負載的合約後，必須手動從工作負載上移除 OFX 控制器。請參閱節 42.2.2, 清理 Linux 工作負載。
status [<伺服器>] 對於伺服器，請指定 PlateSpin Migrate 伺服器的 DNS 名稱或 IP 位址。	顯示 PlateSpin 控制器和驅動程式的安裝狀態。如果您指定了 PlateSpin 伺服器，該指令會檢查伺服器中是否有驅動程式升級。
driver-install [<伺服器>] 對於伺服器，請指定 PlateSpin Migrate 伺服器的 DNS 名稱或 IP 位址。	安裝相應的 PlateSpin blkwatch 驅動程式。如果您指定了 PlateSpin 伺服器，該指令會檢查伺服器中是否有驅動程式升級。
driver-upgrade [<伺服器>] 對於伺服器，請指定 PlateSpin Migrate 伺服器的 DNS 名稱或 IP 位址。	升級已安裝的 PlateSpin blkwatch 驅動程式。如果您指定了 PlateSpin 伺服器，該指令會檢查伺服器中是否有驅動程式升級。
driver-uninstall	從來源 Linux 工作負載中解除安裝已安裝的 PlateSpin blkwatch 驅動程式。
configure <伺服器> <新伺服器> 對於伺服器，請指定 PlateSpin Migrate 伺服器的 DNS 名稱或 IP 位址。對於新伺服器，請指定 PlateSpin Migrate 伺服器的新 DNS 名稱或 IP 位址。範例︰ ./MigrateAgent configure 10.10.10.10 10.10.20.20	停止 OFX 控制器 (ofxcontroller) 服務、用新位址修改 OFX 控制器組態檔案，然後重新啟動該服務。如果您修改了 PlateSpin 伺服器的公用 IP 位址，則必須在為該伺服器設定的每個來源工作負載上都執行此指令。
指令選項
server	指定 PlateSpin Migrate 伺服器的 DNS 名稱或 IP 位址。當您呼叫 status、driver-install 或 driver-upgrade 選項時，從指定的伺服器下載 blkwatch 驅動程式。
user	指定有權新增工作負載的管理員層級使用者的 PlateSpin 伺服器使用者名稱。
選項
-h、--help	顯示指令的用法和選項。
-p、--password -p <使用者密碼>	指定 PlateSpin 伺服器使用者名稱的密碼。如果您未在指令行中包含密碼，程序檔將提示您輸入密碼。當您輸入密碼時，密碼會被隱藏，不會顯示在程序清單中。請勿將此選項與 passwordfile 選項結合使用。
-pf、--passwordfile -pf <密碼檔案路徑>	指定包含所指定 PlateSpin 伺服器使用者名稱的密碼的檔案路徑。請勿將此選項與 password 選項結合使用。
記錄
logging.json	包含有關記錄 Migrate 代理程式公用程式動作的 JSON 格式記錄組態設定。若要檢視記錄設定，請使用 cat 指令︰ cat MigrateAgent/logging.json 可在文字編輯器中編輯該檔案。可透過將 "level︰" 值從 "DEBUG" 變更為 "INFO" 或 "ERROR"，來設定記錄層級。例如︰ "level": "DEBUG" 或 "level": "INFO" 或 "level": "ERROR" 記錄的訊息預設會寫入 MigrateAgent 目錄中的 MigrateAgent.log 檔案。可在 logging.json 檔案中修改記錄檔案名稱設定。
MigrateAgent.log	包含針對 MigrateAgent 指令記錄的訊息。若要檢視該記錄，請使用 cat 指令。 cat MigrateAgent.log