文档首页/ 主机迁移服务 SMS/ 快速入门/ 在源端安装迁移Agent/ 安装Windows版的SMS-Agent
更新时间：2024-10-26 GMT+08:00
查看PDF
分享

安装Windows版的SMS-Agent

操作场景

您需要在源端服务器上安装迁移Agent并且输入目的端服务器所在华为云账号的AK/SK，迁移Agent启动成功后会收集源端服务器信息并自动发送给主机迁移服务。收集的所有信息仅用于数据迁移，不会用作其他用途。具体收集源端哪些信息可查看主机迁移服务会收集源端的哪些信息？。

Windows版的SMS-Agent安装有两种方式：

  • 基于图形界面 Windows Agent(Python3)：Windows Server 2019/Windows Server 2016/Windows Server 2012/Windows 10/Windows 8.1
  • 基于命令行界面 Windows Agent(Python2)：Windows Server 2008/Windows 7

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

前提条件

下载SMS-Agent安装文件

  1. 登录主机迁移服务管理控制台。
  2. 在左侧导航树中，单击“迁移Agent”，进入“迁移Agent”页面。
  3. 选择Windows操作系统，根据实际的系统版本，单击对应Windows Agent下载窗格中“链接”后的图标。

    • 图形界面（Windows Server 2019/Windows Server 2016/Windows Server 2012/Windows 10/Windows 8.1）：请选择“Windows Agent(Python3)”。
    • 命令行界面（Windows Server 2008/Windows 7）：请选择“Windows Agent(Python2)”。

  4. 仔细阅读并同意服务声明后，单击“是”，下载Agent安装程序。
  5. 单击“SHA256链接”后的图标，将包含Hash值的文件保存到本地。对迁移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，以及SMS域名。SMS域名可在SMS控制台的“迁移Agent”页面获取，如图2所示。

    • 若不使用HTTP/HTTPS代理，请选择：直连。
    • 若使用HTTP/HTTPS代理，请选择：使用代理，并输入代理服务器IP、端口、代理用户名、密码。
      • 代理服务器IP：填写代理服务器IP地址，非目的端服务器地址。填写格式为：https://your-proxy-addr.com，其中your-proxy-addr.com需要更换为您代理服务器的地址，协议需要根据代理服务器的实际情况配置，建议您将代理服务器协议配置为https。
      • 端口：填写代理服务器开放的代理端口。
      • 代理用户名：填写代理软件用户名，没有则不填。
      • 密码：填写代理用户名对应的密码，没有则不填。
    图1 启动Agent
    图2 获取SMS域名

  6. 如果您的账号已经开通企业项目，输入AK/SK后，Agent会查询有主机迁移权限的企业项目并罗列，供您选择。选择具体的企业项目后，主机迁移服务会将主机迁移到您指定的企业项目中。实现迁移时权限、资源和财务的隔离。更多详细介绍和操作步骤请参见将主机迁移至企业项目最佳实践。
  7. 单击“启动”，弹出“注意”窗口。
  8. 请您仔细阅读“注意”窗口中的内容，单击“是”。

    当界面显示“启动成功！等待服务端命令...”时，表示Windows版的SMS-Agent启动成功，请访问华为云控制台主机迁移服务界面进行后续操作。

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

  1. 请将“SMS-Agent-Py2.exe”文件上传至源端服务器。
  2. 使用Administrator用户登录源端服务器，双击“SMS-Agent-Py2.exe”文件，进入SMS-Agent安装界面。
  3. 单击“安装”，等待安装完成。
  4. 单击“完成”，进入SMS-Agent命令行界面。

    若为二次启动，在安装目录下（C:\SMS-Agent-Py2）双击agent-start.exe。

  5. 若使用HTTP/HTTPS代理服务器，请执行步骤6。

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

    • 代理服务器为一种特殊网络服务，当您的源端无法通过公网访问华为云时，可以通过代理服务器访问华为云，代理服务器需用户自行配置。
    • 代理仅用于专线/VPN场景下源端到服务端的注册，不用于数据迁移过程。

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

    进入Agent安装目录，如C:\SMS-Agent-Py2\config目录下，修改auth.cfg文件。若迁移过程中不使用HTTP/HTTPS代理，禁止修改auth.cfg文件。

    [proxy-config]
enable = true
proxy_addr = https://your-proxy-addr.com
proxy_port = proxyport
proxy_user =
use_password = false

    • 使用代理时，enable设置为true。
    • proxy_addr为代理服务器地址，允许源端服务器通过代理服务器访问主机迁移服务，非目的端地址。your-proxy-addr.com需要更换为您代理服务器的地址，协议需要根据代理服务器的实际情况配置，建议您将代理服务器协议配置为https。
    • 代理有用户名的话，proxy_user就填写用户名，如root，没有则不填。
    • 代理有密码的话, use_password设置为true，否则false。

  7. 根据命令提示，依次手动输入目的端服务器所在华为云账号的AK、SK，以及SMS域名。SMS域名可在SMS控制台的“迁移Agent”页面获取，如图3所示。

    如果您的账号已经开通企业项目，输入AK/SK后，Agent会查询有主机迁移权限的企业项目并罗列，供您选择。选择具体的企业项目后，主机迁移服务会将主机迁移到您指定的企业项目中。实现迁移时权限、资源和财务的隔离。更多详细介绍和操作步骤请参见将主机迁移至企业项目最佳实践。
    图3 获取SMS域名

    认证通过后，提示SMS-Agent启动，开始给主机迁移服务上传源端服务器信息，界面随即关闭。您可以前往SMS控制台的迁移服务器列表页面查看上报的源端服务器。

问题处理