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, Windows Server 2016, Windows Server 2012, Windows 10, and Windows 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

• You have obtained an AK/SK pair for your Huawei Cloud account.
  • If you use an IAM user for migration, obtain an AK/SK pair by referring to How Do I Create an AK/SK Pair for an IAM User?
  • If you use an account for migration, obtain an AK/SK pair by referring to How Do I Create an AK/SK Pair for an Account?
• You have obtained the administrator permissions for the source server.
• You have confirmed that the source server OS is supported by SMS. Learn more about supported Windows OSs.
• There is no antivirus software on the source server. Antivirus software may prevent the Agent from starting up.

  If you encounter Agent startup failures due to antivirus software, refer to the instructions in How Do I Fix Error "Failed to start the I/O monitoring module" When I Start the Agent?

Downloading the Agent Installation File

1. Sign in to the SMS console.
2. In the navigation pane on the left, choose Agents.
3. Select the Windows card, locate the Agent that matches the source server OS, and click the icon next to Agent.
   • GUI-based Windows Agent (Python 3): Windows Server 2019, Windows Server 2016, Windows Server 2012, Windows 10, and Windows 8.1
   • CLI-based Windows Agent (Python 2): Windows Server 2008 and Windows 7

   

4. Read and agree to the service disclaimer, and click Yes to download the Agent installation file.
5. Click the icon next to SHA256 File to download the file that contains a hash value to a local directory. Verify the integrity of the Agent installation file. 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 for the Huawei Cloud account and the SMS domain name for 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 HTTP/HTTPS proxy, select Direct Connection.
   • If you need to use an HTTP/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.
     • Proxy user name: Enter the username required for using the proxy software. If no username is required, leave this parameter blank.
     • Password: Enter the password corresponding to the proxy username. If no password is required, leave this parameter blank.
   Figure 1 Starting the Agent
   
   Figure 2 Obtaining the SMS domain name
   

6. If the EPS service has been enabled for the Huawei Cloud account, after you entered the AK/SK pair, the Agent will list all enterprise projects the account is allowed to access. You can select the enterprise you would like to migrate the source server to. 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 sign 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.
   

   If you need to rerun the Agent, double-click agent-start.exe in the C:\SMS-Agent-Py2 directory where the Agent was installed.

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

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

   

   • If your source server cannot access Huawei Cloud over the Internet, you can use a proxy server. You will need to configure the proxy server yourself.
   • In a migration over a private line or VPN, a proxy server is used for registering the source server with SMS. It is not used for data migration.

6. (Optional) Configure the HTTP/HTTPS proxy for the Agent.

   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 HTTP/HTTPS proxy.

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

   

   • enable: To use a proxy, 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 the proxy. HTTPS is recommended.
   • proxy_user: Enter the username required for the proxy. If no username is required, leave it blank.
   • use_password: If a password is required for the proxy, set it to true. If no password is required, set it to false.

7. When prompted, enter the AK/SK pair for the Huawei Cloud account and the SMS domain name for 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.
   If the EPS service has been enabled for the Huawei Cloud account, after you entered the AK/SK pair, the Agent will list all enterprise projects the account is allowed to access. You can select the enterprise you would like to migrate the source server to. 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.

Troubleshooting

• SMS.0202 AK/SK Authentication Failed
• Why Wasn't My Source Server Added to the SMS Console After I Configured the Agent?