Help Center > > Getting Started> Installing the Migration Agent on Source Servers> Installing the Windows Agent

Installing the Windows Agent

Updated at: Apr 14, 2020 GMT+08:00

Scenarios

You need to install the migration Agent on the source server and enter the AK and SK of your HUAWEI CLOUD account to which the target ECS belongs for authentication. After the migration Agent is started successfully, it automatically collects source server information and sends collected information to SMS.

You can install the migration Agent on a Windows server in either of the following ways: using GUI for servers running Windows 2012 and 2016, or using CLI for servers running Windows 2003 and 2008.

Prerequisites

Obtaining the Migration Agent Installation File

  1. Log in to the management console.
  2. Click Service List. Under Migration, click Server Migration Service.

    The Server Migration Service console is displayed.

  3. In the navigation pane on the left, choose Migration Agent.

    The Migration Agent page is displayed.

  4. Click Download in the Down Windows Agent panes to download the agent you need.

    • Using GUI for servers running Windows 2012 and 2016: Select the Python 3 Agent and save the SMS-Agent-Py3.exe file to a local directory.
    • Using CLI for servers running Windows 2003 and 2008: Select the Python 2 Agent and save the SMS-Agent-Py2.exe file to a local directory.

  5. (Optional) Verify the software integrity of the migration Agent. For details, see How Do I Verify the Software Integrity of the Migration Agent?

Installing the Migration Agent on a Server Running Windows 2012 or 2016

  1. Check whether the source server to be migrated is the one that you are using to log in to the management console.

    • If yes, go to 2.
    • If no, upload the SMS-Agent-Py3.exe file to the target source server and perform 2 on the source server.

  2. Log in to the source server as user Administrator and double-click the SMS-Agent-Py3.exe file.

    The Agent installation wizard is displayed.

  3. Click Install and wait till the installation is complete.
  4. Click Finish.

    The SMS-Agent window is displayed.

  5. Enter the AK and SK of the HUAWEI CLOUD account to which the target ECS belongs, and click Start.

    The Privacy Statement page is displayed.

    If you do not need the HTTPS proxy, select Directly connection.

    If you need the HTTPS proxy, select Use proxy and enter the IP address, port number, username, and password of the proxy server.

    • A proxy server is a special network service that allows the source server to access SMS through a proxy server. The IP address of the proxy server is not the destination IP address.
    • Information in Figure 1 is only for reference. Enter the actual HTTPS proxy server information.
    • The proxy is used only for registering the source server with SMS when Direct Connect or a VPN is used, and is not used for data migration.
    Figure 1 Starting the Agent

  6. Read the content in the Privacy Statement dialog box carefully and click Yes if you want to continue.

    When Upload success and Waiting for the SMS instruction are displayed, the Windows Agent is started and the source server information is uploaded to SMS.

Installing the Migration Agent on a Server Running Windows 2003 or 2008

  1. Check whether the source server to be migrated is the one that you are using to log in to the management console.

    • If yes, go to 2.
    • If no, upload the SMS-Agent-Py2.exe file to the target source server and perform 2 on the source server.

  2. Log in to the source server as user Administrator and double-click the SMS-Agent-Py2.exe file.

    The Agent installation wizard is displayed.

  3. Click Install and wait till the installation is complete.
  4. Click Finish.

    The SMS-Agent CLI is displayed.

  5. If you need the HTTPS proxy server, go to 6.

    If you do not need the HTTPS proxy server, go to 7.

  6. (Optional) Configure an HTTPS proxy server.

    Go to the Agent installation directory, for example, C:\SMS-Agent-Py2\config, and modify the auth.cfg file.

    [auth-info]
    mainRegion = cn-north-1
    
    
    [proxy-config]
    enable = true
    proxy_addr = 192.168.1.10
    proxy_port = 3128
    proxy_user = root
    use_password = true
    • proxy_addr indicates the IP address of the proxy server, which allows the source server to access SMS through the proxy server. The IP address of the proxy server is not the destination IP address.
    • If the HTTPS proxy is not used during the migration, you are not allowed to modify the auth.cfg file.
    • The proxy is used only for registering the source server with SMS when Direct Connect or a VPN is used, and is not used for data migration.
    • If you use the Proxy, set enable to true.
    • If the Proxy server has a username, set proxy_user to the username, for example, root. If no, leave this parameter blank.
    • If the Proxy server has a password, set use_password to true. Otherwise, set use_password to false.
    • The preceding information is only for reference. Enter the actual Proxy server information.

  7. Enter the AK and SK of the HUAWEI CLOUD account to which the target ECS belongs as prompted.

    After the authentication succeeds, the Agent starts to upload source server information to SMS, and the window is closed.

Troubleshooting

If AK and SK authentication fails, see What Can I Do If the Migration Agent AK/SK Authentication Fails?

Did you find this page helpful?

Submit successfully!

Thank you for your feedback. Your feedback helps make our documentation better.

Failed to submit the feedback. Please try again later.

Which of the following issues have you encountered?







Please complete at least one feedback item.

Content most length 200 character

Content is empty.

OK Cancel