安装Windows版的SMS-Agent

操作场景

您需要在源端服务器上安装迁移Agent并且输入目的端服务器所在华为云账号的AK/SK，迁移Agent启动成功后会收集源端服务器信息并自动发送给主机迁移服务。

Windows版的SMS-Agent安装有两种方式：基于图形界面（Windows Server 2019/Windows Server 2016/Windows Server 2012/Windows 10/Windows 8.1）、基于命令行界面（Windows Server 2008/Windows 7）。

必须使用Administrator用户登录Windows服务器。

前提条件

• 已获取目的端服务器所在华为云账号的AK/SK。
  • 如果您使用IAM用户进行迁移，具体请参见如何获取AK/SK?（IAM用户）。
  • 如果您直接使用账号进行迁移，具体请参见如何获取AK/SK?（账号）。
• 已获取源端服务器Administrator用户权限。
• 源端服务器的OS类型需要包含在兼容性列表中。
• 源端服务器中未安装杀毒软件，杀毒软件可能会导致Agent启动失败。

  若启动Agent时出现“IO监控启动失败”，请参考启动Agent时出现“IO监控启动失败”，该如何处理。

获取SMS-Agent安装文件

1. 登录目的端管理控制台。
2. 单击“服务列表”，选择“迁移 > 主机迁移服务”。

   进入“主机迁移服务”页面。

3. 在左侧导航树中，选择“迁移Agent”。

   进入“迁移Agent”页面。

4. 单击Windows Agent下载窗格中的“下载”，下载相应的迁移Agent。
   • 图形界面（Windows Server 2019/Windows Server 2016/Windows Server 2012/Windows 10/Windows 8.1）：请选择“Windows Agent(Python3)”，将“SMS-Agent-Py3.exe”保存到本地。
   • 命令行界面（Windows Server 2008/Windows 7）：请选择“Windows Agent(Python2)”，将“SMS-Agent-Py2.exe”保存到本地。

5. （可选）对迁移Agent进行软件完整性校验，具体参见如何对迁移Agent进行软件完整性校验？。

安装SMS-Agent（Windows Server 2019/Windows Server 2016/Windows Server 2012/Windows 10/Windows 8.1）

1. 请将“SMS-Agent-Py3.exe”文件上传至源端服务器。
2. 使用Administrator用户登录源端服务器，双击获取到的“SMS-Agent-Py3.exe”文件。

   进入SMS-Agent安装界面。

3. 单击“安装”，等待安装完成。
4. 单击“完成”，进入SMS-Agent图形界面。
5. 输入目的端服务器所在华为云账号的AK和SK，单击“启动”。

   弹出“注意”界面。

   若不使用HTTPS代理，请选择：直连。

   若使用HTTPS代理，请选择：使用代理，并输入代理服务器IP、端口、代理用户名、密码。

   

   • 代理服务器为一种特殊网络服务，当您的源端无法通过公网访问华为云时，可以通过代理服务器访问华为云，代理服务器需用户自行配置。
   • 代理服务器IP非目的端地址。
   • 图1中仅为示例说明，具体HTTPS代理服务器信息，请根据实际情况填写。
   • 代理仅用于专线/VPN场景下源端到服务端的注册，不用于数据迁移过程。
   图1 启动Agent
   

6. 请您仔细阅读“注意”中的内容并单击“是”。

   当界面显示：启动成功！等待服务端命令时，表示Windows版的SMS-Agent启动成功，开始给主机迁移服务上传源端服务器信息。

安装SMS-Agent（Windows Server 2008/Windows 7）

1. 请判断待迁移的源端服务器是否是您当前登录管理控制台的主机。
   • 是，请执行2。
   • 否，请将“SMS-Agent-Py2.exe”文件上传至源端服务器，在源端服务器中执行2。

2. 使用Administrator用户登录源端服务器，双击获取到的“SMS-Agent-Py2.exe”文件。

   进入SMS-Agent安装界面。

3. 单击“安装”，等待安装完成。
4. 单击“完成”，进入SMS-Agent命令行界面。
5. 若使用HTTPS代理服务器，请执行6。

   若不使用HTTPS代理服务器，请执行7。

6. 配置HTTPS代理服务器（可选）。

   进入Agent安装目录，如C:\SMS-Agent-Py2\config目录下，修改auth.cfg文件。

   图2 安装Windows版的SMS-Agent
   
   

   • proxy_addr为代理服务器地址，允许源端服务器通过代理服务器访问主机迁移服务，非目的端地址。
   • 若迁移过程中不使用HTTPS代理，禁止修改auth.cfg文件。
   • 代理仅用于专线/VPN场景下源端到服务端的注册，不用于数据迁移过程。
   • 使用代理时，enable设置为true。
   • 代理有用户名的话，proxy_user就填写用户名，如root；没有则不填。
   • 代理有密码的话, use_password设置为true，否则false。
   • 以上示例仅为示例说明，具体代理服务器信息，请根据实际情况填写。

7. 根据命令提示，依次手动输入目的端服务器所在华为云账号的AK和SK。

   认证通过后，提示SMS-Agent启动，开始给主机迁移服务上传源端服务器信息，界面随即关闭。

问题处理

在迁移Agent中输入目的端服务器所在华为云账号的AK/SK以后，若出现“AK，SK鉴权失败”的提示，请您参见如何处理迁移Agent中AK/SK校验失败？。