How Do I Download and Install the Agent on Source Servers?
Windows
- Log in to the SMS console. In the navigation pane on the left, choose Agents.
- In the Windows area, click Agent to download the Agent you need. Please carefully read and agree to the service statement. Then click OK.
You can also use the following links to download the desired Agent:
When you download the Agent from the preceding links, you need to go to the SMS console to read and agree to the Service Statement.
- Access the SHA256 link below to download the SHA256 verification code of the Agent installation package you downloaded. Verify the integrity of the Agent installation package by referring to How Do I Verify the Integrity of the Agent Installation File?
You can also run the following command to download SHA256 verification code:
- Install the software by referring to Windows.
Linux
- Log in to the SMS console. In the navigation pane on the left, choose Agents.
- In the Linux area, click Agent. Read carefully and agree to the service statement and click OK. Copy the command for downloading Agent installation file and run the command on the source server.
You can also use either of the following commands to download the Agent:
wget -t 3 -T 15 https://sms-agent-2-0.obs.ap-southeast-1.myhuaweicloud.com/SMS-Agent.tar.gz
curl -O https://sms-agent-2-0.obs.ap-southeast-1.myhuaweicloud.com/SMS-Agent.tar.gz
When you download the Agent using the preceding commands, you need to go to the SMS console to read and agree to the Service Statement.
- Copy the command for downloading the SHA256 verification code and run the command on the source server. Verify the integrity of the Agent installation package by referring to How Do I Verify the Integrity of the Agent Installation File?
You can also run either of the following commands to download the SHA256 verification code:
wget -t 3 -T 15 https://sms-agent-2-0.obs.ap-southeast-1.myhuaweicloud.com/SMS-Agent.tar.gz.sha256
- Decompress the Agent software package.
tar -zxvf SMS-Agent.tar.gz
- Switch to the SMS-Agent directory on the source server.
cd SMS-Agent
- If you do not need to use an HTTPS proxy, go to 7.
If you do not need to use an HTTPS proxy, go to 8.
- 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.
- Configure an HTTP/HTTPS proxy.
- Go to the config directory.
cd SMS-Agent/agent/config
- Open and edit the auth.cfg file. Do not edit the auth.cfg file unless you need to use an HTTP/HTTPS proxy.
vi auth.cfg
The values shown here are for reference only.
[proxy-config] enable = true proxy_addr = https://your-proxy-addr.com proxy_port = 3128 proxy_user = root use_password = true
- enable: To use the proxy, set it to true.
- proxy_addr: Enter the IP address of the proxy server. The proxy is used by the source server to access SMS. This IP address is different from the IP address 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.
- Save the auth.cfg file and exit.
:wq
- Go to the config directory.
- Start the Agent.
./startup.sh
- Carefully review what information will be collected by the Agent, enter y, and press Enter.
Figure 1 Entering y
- 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.
Figure 2 Entering the AK/SK pair
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.
When the following information is displayed, the Agent has been started up and will start reporting source server information to SMS. You can go to the Servers page on the SMS console to view the record of the source server.Figure 4 Agent running
Agent Installation and Startup FAQs
- How Do I Download and Install the Agent on Source Servers?
- What Can I Do If I Fail to Download the Agent Installation File?
- How Do I Verify the Integrity of the Agent Installation File?
- Why Wasn't My Source Server Added to the SMS Console After I Configured the Agent?
- How Do I Configure Certificate Verification in the SMS-Agent Configuration File?
- Where Can I Find the Agent Run Logs?
- Why Is My Target Server Locked During the Migration?
- How Do I Unlock a Target Server Manually?
- How Do I Resolve Error "The application cannot be started due to incorrect parallel configuration" When I Start the Agent?
- Why Does the Agent Not Start the First Time I Launch It?
- Why Does the Windows Agent Executable Not Run When I Double-Click It?
- How Do I Fix Error "INTERNAL ERROR: cannot create temporary directory!" When I Start the Agent?
- How Do I Troubleshoot Failures of Pasting the AK/SK Pair When I Start the Agent (Python 2)?
- How Do I Resolve Error "utf-8 codec can't decode byte 0xce in position0: invalid continuation byte" When I Start the Agent?
- How Do I Restart the Agent?
- How Do I Fix Agent Startup Failures Due to Insufficient Space in /tmp on a Linux Source Server?
- How Do I Fix Error "Failed to start sms agent! 'disks'" When I Start the Agent on a Linux Source Server?
- How Do I Fix Error "Failed to obtain information about disk X" When I Start the Agent on a Linux Source Server?
- How Do I Choose When the System Asks Whether to Disable the Google Services Detected on My Source Server on the Google Cloud?
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbotmore