Updated on 2024-03-29 GMT+08:00

Installing the Agent on Windows

Scenarios

You need to install the Agent on the source server to be migrated. During the installation, you need to enter the AK/SK pair of the Huawei Cloud account you are migrating to. After the Agent is started, it automatically reports source server information to SMS. The information is used for migration only. For details, see What Information Does SMS Collect About Source Servers?

There are two options for Windows:

  • GUI-based Windows Agent (Python 3): Windows Server 2019/2016/2012 and Windows 10/8.1
  • CLI-based Windows Agent (Python 2): Windows Server 2008 and Windows 7

    You must log in to the source server as user Administrator.

Prerequisites

Downloading the Agent Installation File

  1. Log in to the SMS console.
  2. In the navigation pane on the left, choose Agents.
  3. In the Windows area, click Agent to download the Agent you need. Please carefully read and agree to the service statement. Then click OK.

    • Windows Agent (Python 3)

      This is a GUI-based version designed for Windows Server 2019/2016/2012 and Windows 10/8.1.

    • Windows Agent (Python 2)

      This is a CLI-based version designed for Windows Server 2008 and Windows 7.

  4. In the pane of the Agent you have downloaded, click SHA256 File to save the file that contains the hash value to a local directory. Verify the integrity of the Agent installation package. For details, see How Do I Verify the Integrity of the Agent Installation File?

Installing the Windows Agent (Python 3)

  1. Transmit the SMS-Agent-Py3.exe file to the source server.
  2. Log in to the source server as user Administrator and double-click the SMS-Agent-Py3.exe file.
  3. Click Install and wait for the installation to complete.
  4. Click Finish. The SMS-Agent GUI is displayed.
  5. Enter the AK/SK pair of the account and the SMS domain name in the region you are migrating to. You can obtain the SMS domain name on the Agents page of the SMS console, as shown in Figure 2.

    • If you do not need to use an HTTPS proxy, select Direct Connection.
    • If you need to use an HTTPS proxy, select Use Proxy and enter the IP address, port number, username, and password of the proxy server.
      • Proxy Server IP: Follow the format https://your-proxy-addr.com. Use the protocol configured for your proxy server. HTTPS is recommended. Replace your-proxy-addr with the IP address of your proxy server, not that of the target server.
      • Port: Enter the port used by the proxy server. The default port is 3128.
      • Proxy user name: Enter the username required for using the proxy software. If none is required, leave this parameter blank.
      • Password: Enter the password corresponding to the proxy username. If none is required, leave this parameter blank.
    Figure 1 Starting the Agent
    Figure 2 Obtaining the SMS domain name

  6. You must enable the EPS service for the Huawei Cloud account you migrate to. When you start the Agent installed on a source server, the Agent lists all enterprise projects the account is allowed to access. You can select the enterprise you desire. Then the server will be migrated to the enterprise project. This enables you to isolate permissions, resources, and finance during the migration. For details, see Migrating Servers into an Enterprise Project.
  7. Click Start.
  8. Carefully review the Privacy Statement and click Yes if you want to continue.

    When the message "Upload success. Waiting for the SMS instruction" is displayed, the Agent has been started. You need to log in to the SMS console and perform subsequent operations.

Installing the Windows Agent (Python 2)

  1. Transmit the SMS-Agent-Py2.exe file to the source server.
  2. Log in to the source server as user Administrator and double-click the SMS-Agent-Py2.exe file.
  3. Click Install and wait for the installation to complete.
  4. Click Finish. The SMS-Agent CLI is displayed.

    To manually start the Agent when needed, double-click agent-start.exe in the directory C:\SMS-Agent-Py2 where the Agent was installed.

  5. If you need to use an HTTPS proxy, go to 6.

    If you do not need to use an HTTPS proxy, go to 7.

    • If your source server cannot access Huawei Cloud over the Internet, a proxy server can help you. You need to configure a proxy server by yourself.
    • The proxy is used for registering the source server with SMS when a Direct Connect or VPN connection is used. It is not used for data migration.

  6. Configure an HTTPS proxy server.

    Go to the directory where the Agent was installed (typically C:\SMS-Agent-Py2\config) and edit the auth.cfg file. Do not edit the auth.cfg file unless you need to use an HTTPS proxy server.

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

    • enable: To use a proxy server, set this parameter to true.
    • proxy_addr: Replace your-proxy-addr with the IP address of the proxy server, not that of the target server. Use the protocol configured for your proxy server. HTTPS is recommended.
    • proxy_user: Enter the username for logging in to the proxy server. If no username is required, leave it blank.
    • use_password: If a password is required for logging in to the proxy server, set it to true. If none is required, set it to false.

  7. When prompted, enter the AK/SK pair of the Huawei Cloud account and the SMS domain name in the region you are migrating to. You can obtain the SMS domain name on the Agents page of the SMS console, as shown in Figure 3.

    You must enable the EPS service for the Huawei Cloud account you migrate to. When you start the Agent installed on a source server, the Agent lists all enterprise projects the account is allowed to access. You can select the enterprise you desire. Then the server will be migrated to the enterprise project. This enables you to isolate permissions, resources, and finance during the migration. For details, see Migrating Servers into an Enterprise Project.
    Figure 3 Obtaining the SMS domain name

    After the authentication succeeds, the Agent starts to report source server information to SMS, and the window is closed. You can go to the Servers page on the SMS console to view the record of the source server.