Data Online Migration：代理管理

建立代理

代理支援公網和專用網路（專線或VPN）兩種網路類型，請按需選擇適合的網路類型。建立代理時需關聯已有通道，請提前建立好通道。建立通道的相關操作，請參見通道管理。

1. 登入阿里雲線上遷移服務管理主控台。

2. 在左側導覽列，選擇代理管理

3. 在代理管理頁面，單擊新建代理。

4. 在新建代理對話方塊，配置如下參數，並單擊确定。

   參數	是否必填	說明
   名稱	是	代理名稱。 代理名稱不可為空，長度為3~63個字元。 支援英文小寫字母、數字和特殊字元短劃線（-）和底線（_），且區分大小寫。 UTF-8編碼並且不能以短劃線（-）和底線（_）開頭。
   网络类型	是	代理的網路連接方式，包含如下兩種： VPC（推薦）：代理通過VPC連到線上遷移服務端。此方式要求部署代理程式的機器能夠訪問線上遷移服務對應地區的內網網域名稱。例如，若您在華北2（北京）地區使用遷移服務，則代理機器必須能夠訪問線上遷移服務華北2（北京）地區的內網網域名稱{TunnelId}.cn-beijing.mgw-tc-internal.aliyuncs.com。建議您使用與線上遷移服務控制台相同地區的ECS執行個體來部署代理程式。 公網：代理通過公網連到線上遷移服務端。此方式要求部署代理程式的機器能夠訪問線上遷移服務對應地區的公網網域名稱。例如，若您在華北2（北京）地區使用遷移服務，則代理機器必須能夠訪問線上遷移服務華北2（北京）地區的公網網域名稱{TunnelId}.cn-beijing.mgw-tc.aliyuncs.com。 說明 TunnelId表示通道ID。 您可以通過ping命令測試代理程式到遷移服務的連通性。
   部署方式	是	代理的部署方式。目前只支援獨立進程部署方式。
   通道	是	代理所屬的通道，一個代理只允許關聯一個通道，代理的頻寬受通道總頻寬影響。 例如：名稱為tunnel-1的通道，設定最高頻寬為10 Gbit/s，tunnel-1關聯3個代理，分別為agent-1，agent-2和agent-3，則3個代理的總頻寬之和最高為10 Gbit/s。如果agent-1設定3 Gbit/s的頻寬，則agent-2和agent-3僅有7 Gbit/s的頻寬可用，請提前規劃並謹慎分配頻寬。

產生部署代理程式指令碼

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "mgw:VerifyAgentTunnel",
      "Resource": "*"
    }
  ]
}

部署代理程式

代理擴容

擴容代理時，先建立新代理並產生部署指令碼，完成代理部署後，在地址管理頁面修改對應地址並關聯新代理即可。整個擴容過程對遷移中的任務無影響，無需對任務進行任何操作。

1. 建立新代理，詳情請參見建立代理。

2. 產生部署代理程式指令碼，詳情請參見產生部署代理程式指令碼。

3. 部署代理程式，詳情請參見部署代理程式。

4. 將新建立的代理添加到資料地址中，具體操作步驟如下：

   1. 在左側導覽列，選擇地址管理。

   2. 單擊地址管理頁面操作欄的修改選項，彈出修改地址 彈出框。

   3. 在彈出框裡點擊代理下拉框，勾選需要關聯的代理。

   4. 點擊確定。

代理縮容

代理縮容時，先在地址管理頁面修改對應地址，移除需要剔除的代理。完成移除後，在代理管理頁面刪除對應代理；如確認該機器僅用於遷移且不會影響其他業務，可選擇釋放代理機器。整個縮容過程對遷移中的任務無影響，無需對任務進行任何操作。

1. 移除需要剔除的代理，具體操作步驟如下：

   1. 登入線上遷移控制台，在左側導覽列，選擇地址管理。

   2. 單擊地址管理頁面操作欄的修改選項，彈出修改地址框。

   3. 在彈出框裡點擊代理下拉框，從下拉框中移除需要剔除的代理。

   4. 點擊確定。

2. 清理代理

   1. 線上遷移控制台刪除代理

      1. 在左側導覽列，選擇代理管理。

      2. 單擊代理管理頁面操作欄中的删除選項，彈出確認刪除對話方塊。

      3. 點擊确定。

3. 釋放代理機器（可選）

   如果您確認該機器僅用於遷移目的，並且確保刪除後不會對其他業務造成影響，則可以釋放該代理機器。

代理升級

1. 暫停遷移任務，具體操作步驟如下：

   1. 登入線上遷移控制台，在左側導覽列，選擇遷移任務。

   2. 點擊遷移任務頁面操作欄中的管理選項，進入遷移任務詳情頁面。

   3. 在遷移任務詳情頁面的下方歷史欄中，點擊暂停 。遷移任務詳情頁面展示資料移轉進度（包括資料量和檔案數完成比例餅圖、頻寬及平均遷移檔案數折線圖）以及歷史執行記錄表格。在歷史表格的操作列中，單擊暫停可暫停當前正在執行的遷移任務。

2. 停止代理機器上的代理程式，具體操作步驟如下：

   1. 登入代理機器，進入到代理程式根目錄（例如/root/aliyun_import_agent_online_res）。

   2. 執行bash bin/stop.sh，等待代理程式停止。

3. 查看舊的代理版本號碼，具體操作步驟如下：

   1. 登入代理機器，執行./bin/drs_import_agent -v 命令，記錄下版本號碼Version。

      [r xxx : aliyun_import_agent_online_res]# ./bin/drs_import_agent -v
      Version: 1.4.2.992
      BuildTime: 2024-11-11_16:04:36_CST
      Bu xxx p_ts-1.5.6

4. 部署代理程式，具體操作步驟如下：

   1. 產生部署代理程式指令碼，詳情請參見產生部署代理程式指令碼。

   2. 部署代理程式，詳情請參見部署代理程式。

5. 查看代理是否升級成功，具體操作步驟如下：

   1. 登入代理機器，進入到代理程式根目錄（例如/root/aliyun_import_agent_online_res）。

   2. 執行./bin/drs_import_agent -v 命令，跟舊的版本號碼進行比對，如果版本號碼更新，則說明代理升級成功。

代理進程的查看、啟動與停止

1. 查看代理進程的步驟如下：

   1. 登入代理機器，進入到代理程式根目錄（例如/root/aliyun_import_agent_online_res）。

   2. 執行ps -ef | grep drs_import_agent，可看到進程資訊，如進程號、運行目錄等。執行以下命令，確認 drs_import_agent 進程已成功運行。

      [root@xxx aliyun_import_agent_online_res]# ps -ef | grep drs_import_agent
      root     19182     1  1 14:35 pts/0    00:00:05 /xxx/aliyun_import_agent_online_res/bin/drs_import_agent -c /xxx/aliyun_import_agent_online_res/config/agent-config.properties
      root     20305 18122  0 14:40 pts/0    00:00:00 grep --color=auto drs_import_agent

   3. 代理運行時會產生記錄檔，預設產生在代理程式根目錄的logs/下，記錄檔會根據您部署時指定的日誌佔用空間參數自動滾動。

2. 啟動代理進程的步驟如下：

   1. 登入代理機器，進入到代理程式根目錄（例如/root/aliyun_import_agent_online_res）。

   2. 首先查看代理進程，確認進程不存在時，執行bash bin/start.sh來啟動代理進程。

3. 停止代理進程的步驟如下：

   1. 登入代理機器，進入到代理程式根目錄（例如/root/aliyun_import_agent_online_res）。

   2. 執行bash bin/stop.sh，等待代理程式停止。

   3. 當代理停止後，登入遷移服務控制台，查看此代理執行個體的狀態，確認為“串連異常”，則說明代理已完全停止。

代理關鍵配置參數

部署代理程式時，會根據您在控制台產生的代理部署命令來個人化配置代理的運行參數。這些參數都儲存在部署代理程式根目錄的config/目錄下的agent-config.properties檔案中（例如/root/aliyun_import_agent_online_res/config/agent-config.properties）。

當配置項修改完成並儲存後，必須重新啟動代理進程才會生效。