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

Windows

Scenarios

You need to install the Agent on each Windows source server that you want to migrate. During the Agent installation, you need to enter the AK/SK pair of your target account. After the Agent is started successfully, it automatically reports source server information to SMS. All collected data is used for migration only. For more information, 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 Windows source server as user Administrator.

Prerequisites

Downloading the Agent Installation File

  1. Log in to the management console.
  2. Click Service List. Under Migration, click Server Migration Service.
  3. In the navigation pane on the left, choose Agents.
  4. In the Windows area, click Agent to download the Agent you need. Please carefully read the precautions.

    • Windows Agent (Python 3)

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

    • Windows Agent (Python 2)

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

  5. Click SHA256 File in the pane of the Agent you have downloaded. Use the hash value contained in the downloaded file to verify the integrity of the Agent installation file. For details, see How Do I Verify the Integrity of the Agent Installation File?

Installing 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.
  6. Click Start.
  7. Carefully review the Privacy Statement and click Yes if you want to continue.

    When message Upload success. Waiting for the SMS instruction is displayed, the Agent has started up and started reporting source server information to SMS.

Installing Windows Agent (Python 2)

  1. Upload 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 installation directory C:\SMS-Agent-Py2.

  5. When prompted, enter the AK/SK pair of the 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.

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