代理管理

创建代理

代理支持公网和专有网络（专线或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）。

当配置项修改完成并保存后，必须重新启动代理进程才能生效。