22.7 使用 Migrate 代理程式註冊工作負載並探查詳細資料

Migrate 代理程式是一個指令行公用程式，使用它可將來源工作負載註冊到 PlateSpin Migrate 伺服器，以及透過 HTTPS (TCP/443) 將有關工作負載的詳細資料傳送到伺服器。透過註冊可以新增無法探查的工作負載，例如︰

在沒有站對站 VPN 的情況下，將 Migrate 伺服器部署到雲端時
當企業網路或規則限制禁止開啟用於自動探查的連接埠時

使用 Migrate 代理程式，無需開啟任何內傳連接埠 (如 SMB 或 NetBIOS) 即可移轉 Windows 工作負載。只需開啟 HTTPS (TCP/443) 和一個複製連接埠 (預設為 TCP/3725)，以使來源 Windows 工作負載能夠進行外傳通訊。對於來源 Linux 工作負載，您還需要開啟 SSH 連接埠 (TCP/22)。請參閱節 2.6.2, 工作負載註冊的要求。

當您在來源工作負載上使用 Migrate 代理程式時，來源工作負載會聯絡目標工作負載以進行資料傳輸。在伺服器層級控制聯絡方向。您必須在 Migrate 伺服器上重新設定複製連接埠方向 (SourceListensForConnection=False)。請參閱設定複製連接埠的聯絡方向。

必須在每個來源工作負載上安裝 Migrate 代理程式。使用 register 選項時，Migrate 代理程式會在工作負載本地執行探查，並透過 HTTPS (TCP/443) 將其詳細資料傳送到 Migrate 伺服器。註冊工作負載後，請使用 Migrate Web 介面來設定要將工作負載移轉至部署了 Migrate 伺服器例項的目標雲端的工作。

註冊的工作負載與探查的工作負載存在以下方面的差異︰

註冊的來源工作負載不會將來源身分證明儲存在 Migrate 伺服器上。
您必須使用 Migrate 代理程式在註冊的來源工作負載中安裝、升級和移除 Windows PlateSpin 驅動程式。
在刪除所註冊來源工作負載的合約後，必須手動從工作負載上移除 OFX 控制器。請參閱清理 Linux 工作負載。

如需 Migrate 代理程式指令的相關資訊，請參閱Migrate 代理程式公用程式。

22.7.1 使用 Migrate 代理程式註冊和探查 Windows 工作負載

開始之前，請確定您的來源 Windows 工作負載和網路設定符合Migrate 代理程式公用程式的要求。對於 Windows 工作負載，Migrate 代理程式公用程式需要管理員權限才能執行指令。

以管理員身分登入來源 Windows 工作負載。
確定該工作負載上已開啟 TCP 連接埠 443。
下載適用於 Windows 的 Migrate 代理程式公用程式。將 MigrateAgent.cli.exe 檔案儲存到工作負載上某個方便存取的位置。

請參閱適用於 Windows 的 Migrate 代理程式公用程式。
在管理員提示下，導覽到該檔案的儲存位置，然後輸入以下指令檢視指令說明︰
```
MigrateAgent.cli.exe help
```
將工作負載註冊到相應的 Migrate 伺服器雲端例項。輸入
```
MigrateAgent.cli.exe /register /psserver=ps_dns_or_ipaddr <username> /password=<password>
```
提供有權新增工作負載的 PlateSpin Migrate 伺服器管理員層級使用者的身分證明。您可以將 /password= 選項與密碼、-pwdfile= 選項與包含密碼的檔案路徑配合使用，或者不在指令序列中指定密碼。如果您未在指令行中包含密碼，程序檔將提示您輸入密碼。當您輸入密碼時，密碼會被隱藏，不會顯示在程序清單中。

例如︰
```
Migrate.Agent.cli.exe /register /psserver=10.10.10.101 /username=jsmith /password=jspwd
```
附註：如果您修改了 Migrate 伺服器的公用 IP 位址，則必須在為該伺服器設定的每個來源 Windows 工作負載上執行以下指令，以修改 IP 位址。
```
MigrateAgent.cli.exe /config /setting=psserver:<new-ps-dns-or-ipaddr>
```
例如︰
```
MigrateAgent.cli.exe /config /setting=psserver:10.10.20.202
```

驗證 PlateSpin 控制器是否正在執行。輸入

MigrateAgent.cli.exe /status

如果該控制器正在執行，則狀態報告結果如下所示：

PlateSpin 控制器精靈正在執行並已向伺服器 10.165.x.x 註冊。
未安裝 PlateSpin blockwatch 驅動程式。

22.7.2 使用 Migrate 代理程式註冊和探查 Linux 工作負載

開始之前，請確定您的來源工作負載和網路設定符合Migrate 代理程式公用程式的要求。Linux 主要考量包括：

若要使用適用於 Linux 的 Migrate 代理程式公用程式，來源機器上需要安裝 GNU C Library (glibc) 2.11.3 或更新版本。
Migrate 代理程式需要 root 層級存取權限才能執行指令。非 root 使用者必須是授權 sudo 使用者。

對於非 root 使用者，在 Migrate 代理程式指令中輸入 sudo 以使用 root 權限執行這些指令。例如︰
```
sudo ./MigrateAgent -h
```
如果系統提示您輸入密碼，請提供您登入使用的非 root 系統使用者名稱的密碼。

附註：在 AWS 中，必須執行 sudo -i 並在 root 外圍程序中執行指令。使用節 22.7.3, 針對 AWS 中的工作負載使用 Migrate 代理程式註冊和探查 Linux 工作負載中的註冊程序。

若要註冊來源 Linux 工作負載：

以 root 使用者身分或具有 root 層級存取權限的非 root 使用者身分登入來源 Linux 工作負載。
確定該工作負載上已開啟 TCP 連接埠 443。
下載適用於 Linux 的 Migrate 代理程式公用程式。將下載的檔案擷取到 /MigrateAgent 目錄。

請參閱適用於 Linux 的 Migrate 代理程式公用程式。
在終端機中導覽到 /MigrateAgent 目錄，然後輸入以下指令以檢視指令說明︰
```
./MigrateAgent -h
```
將工作負載註冊到相應的 Migrate 伺服器雲端例項。輸入
```
./MigrateAgent register [-h] <ps_dns_or_ipaddr> <ps_username> [[-p <user_password>] | [-pf <passwordfile_path>]]
```
指定雲端 PlateSpin Migrate 伺服器例項的 IP 位址或 DNS 名稱。提供有權新增工作負載的 PlateSpin Migrate 伺服器管理員層級使用者的身分證明。您可以將 -p 選項與密碼、-pf 選項與包含密碼的檔案路徑配合使用，或者不在指令序列中指定密碼。如果您未在指令行中包含密碼，程序檔將提示您輸入密碼。當您輸入密碼時，密碼會被隱藏，不會顯示在程序清單中。

例如︰
```
./MigrateAgent register 10.10.10.101 jsmith -p jspwd 
```
附註：如果您修改了 Migrate 伺服器的公用 IP 位址，則必須在為該伺服器設定的每個來源 Linux 工作負載上執行以下指令，以修改 IP 位址。
```
./MigrateAgent configure <ps_dns_or_ipaddr> <new-ps-dns-or-ipaddr>
```
例如︰
```
./MigrateAgent configure 10.10.10.101 10.10.20.202
```

驗證 PlateSpin 控制器是否正在執行。輸入

./MigrateAgent status

如果該控制器正在執行，則狀態報告結果如下所示：

PlateSpin 控制器精靈正在執行並已向伺服器 10.165.x.x 註冊。
未安裝 PlateSpin blockwatch 驅動程式。

22.7.3 針對 AWS 中的工作負載使用 Migrate 代理程式註冊和探查 Linux 工作負載

PlateSpin Migrate Web 介面支援將 Amazon Web Services EC2 虛擬機器例項移轉至 Microsoft Azure，無需 VPN。對於 Azure 中的虛擬機器，工作負載的來源工作負載作業系統和架構必須受支援。如需此情境的移轉要求，請參閱節 12.0, 雲端到雲端移轉的先決條件。

開始之前，請確定您的來源 Linux 工作負載和網路設定符合Migrate 代理程式公用程式的要求。對於 AWS 中 Linux 工作負載，Linux 主要考量包括：

若要使用適用於 Linux 的 Migrate 代理程式公用程式，來源機器上需要安裝 GNU C Library (glibc) 2.11.3 或更新版本。
Migrate 代理程式需要 root 層級存取權限才能執行指令。非 root 使用者必須是授權 sudo 使用者。

附註：對於 Amazon Web Services 中的來源 Linux 工作負載，AMI 範本會自動建立允許使用 sudo 的預設非 root 系統使用者帳戶。此帳戶的使用者名稱因 AMI 提供者而異。對於 Amazon Linux 影像，大多數 Linux 套裝作業系統的非 root 使用者名稱為 ec2-user。CentOS AMI 的使用者名稱為 centos。如需詳細資訊，請參閱 AMI 提供者文件。

在 AWS 中，非 root 使用者必須執行 sudo -i 指令才能存取 root 外圍程序，然後才能執行 Migrate 代理程式指令。在每個 Migrate 代理程式公用程式指令中輸入 sudo 可能導致在某些來源工作負載上執行失敗。
SSH 的 AWS 登入需要提供您為 AWS EC2 金鑰組建立的私密金鑰檔案的本地路徑。

若要將 AWS 中的來源工作負載註冊到您的 Migrate 伺服器：

使用具有 root 層級存取權限的系統使用者名稱和私密金鑰檔案的本地路徑登入 AWS 中的來源 Linux 工作負載。
確定該工作負載上已開啟 TCP 連接埠 443。
下載適用於 Linux 的 Migrate 代理程式公用程式。將下載的檔案擷取到 /MigrateAgent 目錄。

請參閱適用於 Linux 的 Migrate 代理程式公用程式。
在終端機中，導覽至 /MigrateAgent 目錄。
(非 root 使用者) 在伺服器主控台中，執行 sudo -i。輸入
```
sudo -i
```
此指令會將您置於 root 外圍程序中，在其中您將以 root 使用者身分執行指令。終端機提示此時會顯示 root 而不是您的非 root 使用者名稱，例如 ec2-user。

如果 Linux 提示您輸入密碼，請提供您所登入使用者名稱的密碼。
輸入以下指令，以檢視 Migrate 代理程式指令説明：
```
./MigrateAgent -h
```
將工作負載註冊到相應的 Migrate 伺服器雲端例項。輸入
```
./MigrateAgent register [-h] <ps_dns_or_ipaddr> <ps_username> [[-p <user_password>] | [-pf <passwordfile_path>]]
```
指定雲端 PlateSpin Migrate 伺服器例項的 IP 位址或 DNS 名稱。提供有權新增工作負載的 PlateSpin Migrate 伺服器管理員層級使用者的身分證明。您可以將 -p 選項與密碼、-pf 選項與包含密碼的檔案路徑配合使用，或者不在指令序列中指定密碼。如果您未在指令行中包含密碼，程序檔將提示您輸入密碼。當您輸入密碼時，密碼會被隱藏，不會顯示在程序清單中。

例如︰
```
./MigrateAgent register 10.10.10.101 jsmith -p jspwd 
```
附註：如果您修改了 Migrate 伺服器的公用 IP 位址，則必須在為該伺服器設定的每個來源 Linux 工作負載上執行以下指令，以修改 IP 位址。
```
./MigrateAgent configure <ps_dns_or_ipaddr> <new-ps-dns-or-ipaddr>
```
例如︰
```
./MigrateAgent configure 10.10.10.101 10.10.20.202
```

驗證 PlateSpin 控制器是否正在來源工作負載上執行。輸入

./MigrateAgent status

如果該控制器正在執行，則狀態報告結果如下所示：

PlateSpin 控制器精靈正在執行並已向伺服器 10.165.x.x 註冊。
未安裝 PlateSpin blockwatch 驅動程式。

(非 root 使用者) 結束 sudo -i root 外圍程序。按 Ctrl+D 或輸入
```
exit
```
終端機提示此時會顯示您的非 root 使用者名稱，例如 ec2-user。