getting started · 2020-03-18 · 1 preparations before migration this section describes how to...

Server Migration Service

Getting Started

Issue 07

Date 2020-02-20

HUAWEI TECHNOLOGIES CO., LTD.

Copyright © Huawei Technologies Co., Ltd. 2020. All rights reserved.

No part of this document may be reproduced or transmitted in any form or by any means without priorwritten consent of Huawei Technologies Co., Ltd. Trademarks and Permissions

and other Huawei trademarks are trademarks of Huawei Technologies Co., Ltd.All other trademarks and trade names mentioned in this document are the property of their respectiveholders. NoticeThe purchased products, services and features are stipulated by the contract made between Huawei andthe customer. All or part of the products, services and features described in this document may not bewithin the purchase scope or the usage scope. Unless otherwise specified in the contract, all statements,information, and recommendations in this document are provided "AS IS" without warranties, guaranteesor representations of any kind, either express or implied.

The information in this document is subject to change without notice. Every effort has been made in thepreparation of this document to ensure accuracy of the contents, but all statements, information, andrecommendations in this document do not constitute a warranty of any kind, express or implied.

Issue 07 (2020-02-20) Copyright © Huawei Technologies Co., Ltd. i

Contents

1 Preparations Before Migration............................................................................................. 1

2 Installing the Migration Agent on Source Servers.......................................................... 32.1 Installing the Windows Agent.............................................................................................................................................32.2 Installing the Linux Agent.................................................................................................................................................... 7

3 Viewing Check Results......................................................................................................... 11

4 Creating and Starting a Migration Task.......................................................................... 13

5 Change History...................................................................................................................... 18

Server Migration ServiceGetting Started Contents

Issue 07 (2020-02-20) Copyright © Huawei Technologies Co., Ltd. ii

1 Preparations Before Migration

This section describes how to prepare accounts, permissions, and source serverand target ECS environments.

PreparationsAccount and Permission Requirements

● You have registered an account with HUAWEI CLOUD.

To access CN South-Guangzhou, CN East-Shanghai2, and CN North-Beijing1, you needto complete the real-name authentication.

● If you log in as an IAM user, contact the administrator for authorization. Fordetails, see How Do I Obtain the AK and SK of an IAM User?

● You have obtained the AK and SK. For details, see How Do I Obtain the AKand SK of a Public Cloud Account? or How Do I Obtain the AK and SK ofan IAM User?

● To avoid migration failure, ensure that the account balance is greater than$20 USD.

The Server Migration Service is free of charge. However, the use of other serviceresources will generate a small amount of fees during the migration. For details aboutthe fees, see Pricing Details.

Target ECS Port Requirements

Enable TCP ports 8899 and 8900 for ECSs running Windows OSs, and port 22 forECSs running Linux OSs. Set the security group rules. For details, see How Can IConfigure the Security Group Rules for Target ECSs?

Source Server Remaining Space Requirements

● For Windows: Migrations will fail in both of the following two scenarios: Thepartition size is greater than 600 MB, but the available partition space is lessthan 320 MB. The partition size and the available partition space are less than600 MB and 40 MB, respectively.

● For Linux: Migrations will fail if the available root partition space is less than200 MB.

Server Migration ServiceGetting Started 1 Preparations Before Migration

Issue 07 (2020-02-20) Copyright © Huawei Technologies Co., Ltd. 1

https://support.huaweicloud.com/intl/en-us/sms_faq/sms_faq_0012.html#section1

https://support.huaweicloud.com/intl/en-us/sms_faq/sms_faq_0032.html




https://support.huaweicloud.com/intl/en-us/productdesc-sms/sms_01_0016.html



Source Server Environment Requirements

● The time of the source server is the same as the standard time, avoiding theAgent registration failure on the source server.

● If the source server runs Linux, run the rsync -v command to check whetherthe Rsync library is installed.If the Rsync library is not installed, run the following commands to install it:– CentOS: Run the yum –y install rsync command.– Ubuntu: Run the apt-get -y install rsync command.– Debian: Run the apt-get -y install rsync command.– SUSE: Run the zypper install rsync command.– Other systems: See the installation documents on their official websites.

Generally, the Rsync library was installed in mainstream server OSs by default.

● If the source server runs a Windows OS, install the following migration Agent:– Windows Server 2012 or Windows Server 2016: Windows Agent

(Python3)– Windows Server 2003 or Windows Server 2008: Windows Agent

(Python2)

Migration Process1. Installing the Windows Agent or Installing the Linux Agent2. Viewing Check Results3. Creating and Starting a Migration Task

Server Migration ServiceGetting Started 1 Preparations Before Migration


2 Installing the Migration Agent onSource Servers

2.1 Installing the Windows Agent

ScenariosYou need to install the migration Agent on the source server and enter the AK andSK of your HUAWEI CLOUD account to which the target ECS belongs forauthentication. After the migration Agent is started successfully, it automaticallycollects source server information and sends collected information to SMS.

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

Prerequisites● You have obtained the AK/SK of the HUAWEI CLOUD account to which the

target ECS belongs.– If you use an IAM user for migration, see How Can I Obtain the AK and

SK for an IAM User?– If you use an account for migration, see How Can I Obtain the AK and

SK of My Public Cloud Account?● You have obtained the administrator permission of the source server.● You have ensured OSs running on source servers are included in Supported

Source Server OSs.● Ensure that no antivirus software is installed on the source server. Antivirus

software may cause Agent startup failure.If message "Failed to start I/O monitoring" is displayed when you start theAgent, rectify the fault by following operations provided in What Do I Do IfI/O Monitoring Fails to Be Started During Agent Startup?

Server Migration ServiceGetting Started 2 Installing the Migration Agent on Source Servers










Obtaining the Migration Agent Installation File

Step 1 Log in to the management console.

Step 2 Click Service List. Under Migration, click Server Migration Service.

The Server Migration Service console is displayed.

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

The Migration Agent page is displayed.

Step 4 Click Download in the Down Windows Agent panes to download the agent youneed.

● Using GUI for servers running Windows 2012 and 2016: Select the Python 3Agent and save the SMS-Agent-Py3.exe file to a local directory.

● Using CLI for servers running Windows 2003 and 2008: Select the Python 2Agent and save the SMS-Agent-Py2.exe file to a local directory.

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

----End

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

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

● If yes, go to Step 2.

● If no, upload the SMS-Agent-Py3.exe file to the target source server andperform Step 2 on the source server.

Step 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.

Step 3 Click Install and wait till the installation is complete.

Step 4 Click Finish.

The SMS-Agent window is displayed.

Step 5 Enter the AK and SK of the HUAWEI CLOUD account to which the target ECSbelongs, 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, portnumber, username, and password of the proxy server.




● A proxy server is a special network service that allows the source server to access SMSthrough a proxy server. The IP address of the proxy server is not the destination IPaddress.

● Information in Figure 2-1 is only for reference. Enter the actual HTTPS proxy serverinformation.

● The proxy is used only for registering the source server with SMS when Direct Connector a VPN is used, and is not used for data migration.

Figure 2-1 Starting the Agent

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

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

----End

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

Step 1 Check whether the source server to be migrated is the one that you are using tolog in to the management console.● If yes, go to Step 2.● If no, upload the SMS-Agent-Py2.exe file to the target source server and

perform Step 2 on the source server.



Step 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.

Step 3 Click Install and wait till the installation is complete.

Step 4 Click Finish.

The SMS-Agent CLI is displayed.

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

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

Step 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 = trueproxy_addr = 192.168.1.10proxy_port = 3128proxy_user = rootuse_password = true

● proxy_addr indicates the IP address of the proxy server, which allows the source serverto access SMS through the proxy server. The IP address of the proxy server is not thedestination IP address.

● If the HTTPS proxy is not used during the migration, you are not allowed to modify theauth.cfg file.

● The proxy is used only for registering the source server with SMS when Direct Connector 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, setuse_password to false.

● The preceding information is only for reference. Enter the actual Proxy serverinformation.

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

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

----End

Troubleshooting

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





2.2 Installing the Linux Agent

ScenariosYou need to install the migration Agent on the source server and enter the AK andSK of your HUAWEI CLOUD account to which the target ECS belongs forauthentication. After the migration Agent is started successfully, it automaticallycollects source server information and sends collected information to SMS.

You can download the migration Agent in either of the following ways:

● Method 1: Run commands on the source server to download the migrationAgent. You are advised to use method 1 to install the migration Agent forLinux OSs.

● Method 2: Download the migration Agent from SMS and use a remotetransmission tool, such as WinSCP, to upload the migration Agent to thesource server to be migrated.

Prerequisites● You have obtained the AK/SK of the HUAWEI CLOUD account to which the

target ECS belongs.– If you use an IAM user for migration, see How Can I Obtain the AK and

SK for an IAM User?– If you use an account for migration, see How Can I Obtain the AK and

SK of My Public Cloud Account?● You have ensured OSs running on source servers are included in Supported

Source Server OSs.

Installing the Linux Agent (Method 1)

Step 1 Use PuTTY or an SSH client to log in to the source server to be migrated as userroot:

Step 2 Run the following commands to download the migration Agent:

wget -t 3 -T 15 https://sms-agent-inter-bucket.obs.ap-southeast-1.myhuaweicloud.com/SMS-Agent.tar.gz

curl -O https://sms-agent-inter-bucket.obs.ap-southeast-1.myhuaweicloud.com/SMS-Agent.tar.gz


Step 4 Run the following command to decompress the software package:

tar -zxvf SMS-Agent.tar.gz

Step 5 Run the following command to switch to the SMS-Agent directory on the sourceserver:

cd SMS-Agent













1. Run the following command to go to the config directory:cd SMS-Agent/config

2. Run the following command to open and edit the auth.cfg file:vi auth.cfg[auth-info]mainRegion = cn-north-1

[proxy-config]enable = trueproxy_addr = 192.168.1.10proxy_port = 3128proxy_user = rootuse_password = true

3. Run the following command to save the auth.cfg file and exit::wq

– proxy_addr indicates the IP address of the proxy server, which allows the sourceserver to access SMS through the proxy server. The IP address of the proxy server isnot the destination IP address.

– If the HTTPS proxy is not used during the migration, you are not allowed to modifythe auth.cfg file.

– The proxy is used only for registering the source server with SMS when DirectConnect 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, setuse_password to false.

– The preceding information is only for reference. Set Proxy server information basedon the actual environment.

Step 8 Run the following command to start the migration Agent:

./startup.sh

Step 9 Read the displayed information carefully, enter y, and press Enter.

Figure 2-2 Entering y


When the following information is displayed, the Linux Agent starts successfully.The Agent starts sending source server information to SMS.



Figure 2-3 Entering the AK and SK

----End

Installing the Linux Agent (Method 2)



The Server Migration Service console is displayed.

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

The Migration Agent page is displayed.

Step 4 Click Download in the Download Linux Agent pane.

The SMS-Agent.exe file starts to be downloaded.


Step 6 Use a remote transmission tool such as WinSCP to upload the migration Agent tothe source server.

Step 7 Use PuTTY or an SSH client to log in to the source server to be migrated as userroot:

Step 8 Run the following command to decompress the software package:

tar -zxvf SMS-Agent.tar.gz

Step 9 Run the following command to switch to the SMS-Agent directory on the sourceserver:

cd SMS-Agent




1. Run the following command to go to the config directory:cd SMS-Agent/config

2. Run the following command to open and edit the auth.cfg file:vi auth.cfg[auth-info]mainRegion = cn-north-1

[proxy-config]enable = trueproxy_addr = 192.168.1.10proxy_port = 3128




proxy_user = rootuse_password = true

3. Run the following command to save the auth.cfg file and exit::wq

– proxy_addr indicates the IP address of the proxy server, which allows the sourceserver to access SMS through the proxy server. The IP address of the proxy server isnot the destination IP address.

– If the HTTPS proxy is not used during the migration, you are not allowed to modifythe auth.cfg file.

– The proxy is used only for registering the source server with SMS when DirectConnect 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, setuse_password to false.

– The preceding information is only for reference. Set Proxy server information basedon the actual environment.

Step 12 Run the following command to start the migration Agent:

./startup.sh

Step 13 Read the displayed information carefully, enter y, and press Enter.


When the following information is displayed, the Linux Agent starts successfully.The Agent starts sending source server information to SMS.

Figure 2-4 Entering the AK and SK

----End

Troubleshooting● If the migration Agent fails to start, error message "No such file or directory:

'rsync': 'rsync'" is displayed. For details, see What Can I Do If the Linux SMS-Agent Cannot Start After the Installation?

● If the migration Agent fails to start, the message "Failed to start agent!" isdisplayed. If "Please check access key and secret key or check if local timematches standard Time!" is displayed, see What Can I Do If the MigrationAgent AK/SK Authentication Fails?







3 Viewing Check Results

ScenariosAfter the migration Agent is started successfully, it automatically collectsinformation about the source server and sends collected information to SMS. SMSautomatically checks whether the source server information is valid and whetherthe source server can be migrated. After the migration Agent uploads sourceserver information to SMS, you can log in to the management console at any timeto view information about the source server.

Procedure



The Server Migration Service page is displayed.

Step 3 In the navigation pane on the left, choose Source Management.

The Source Management page is displayed.

Step 4 On the Source Management page, find the source server to be evaluated andcheck the status of the source server.

You can create a migration task only when Connection Status of the sourceserver is Connected and Source Server Check Result is Passed, as shown inFigure 3-1.

"Recommended specifications" means that if you want to migrate the source server, you areadvised to select the recommended EVS disk specifications of the target ECS. Otherwise, themigration may fail. If you have created the target ECS running a Windows OS, and the EVSdisk size of the target ECS is less than the recommended specifications, you can adjust therecommended specifications of the source server to be less than or equal to the EVS disksize of the target ECS. For details, see How Do I Compress the Disk Partitions of theSource Server Running a Windows OS?

Server Migration ServiceGetting Started 3 Viewing Check Results




Figure 3-1 Source server status

----End

TroubleshootingIf the migration Agent is installed and configured on the source server but thesource server is not displayed on the Source Management page, see WhatShould I Do If the Source Server Information Is Not Displayed on the SourceManagement Page?

Server Migration ServiceGetting Started 3 Viewing Check Results





4 Creating and Starting a Migration Task

ScenariosAfter the source server passes the migration feasibility evaluation, you can createand start a migration task on SMS. If new service data is written to the sourceserver after the migration task is completed, you can start a synchronization taskto synchronize incremental data.

Step 1: Select the Source1. 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 of the page, choose Task Management.

The Task Management page is displayed.4. On the Task Management page, click Create Task.

The Create Migration Task page is displayed.5. For step Select Source Server, set basic parameters for the migration task.6. Set Task Name.

– The default format of a task name is as follows: sms_task_xxx. xxxindicates the source server name. If you want to use the default taskname, do not set this parameter. The task name contains a maximum of20 characters. If the task name contains more than 20 characters, SMSselects the first 20 characters as the task name by default.

– If you want to customize a task name, enter the name of the migrationtask.

7. In the source server list, select the source servers to be migrated.

You can create a migration task only when Connection Status of the source server isConnected and Source Server Check Result is Passed.

Step 2: Set Advanced Settings

1. Click next to Advanced Settings and complete the configuration.

Server Migration ServiceGetting Started 4 Creating and Starting a Migration Task


2. Set Migration Rate. During the migration, a large amount of traffic andbandwidth are consumed. To reduce the impact of migration on services, usethe following methods to limit the migration speed:– For Windows OSs, restricting the migration speed of the source server

migration processes can reduce the impact on services on source servers.– For Linux OSs, restricting the speed of the Network Interface Cards (NICs)

on the target ECSs can reduce the impact on services on the sourceserver.

The value of Migration Rate is an integer ranging from 0 to 1000.– You can enter 0 or leave this field blank to remove migration speed

limits. In this case, the migration speed is the network speed between thesource servers and the target ECSs.

– If the entered value is integer V1 that ranges from 1 to 1000, and thenetwork speed between the source severs and the target ECSs is V2, theactual migration speed is V1 or V2, which is smaller.

3. Set Migration Process Priority. Set the process priority of the migrationAgent on the source server.– If this parameter is set to High, the source server preferentially allocates

resources (such as CPU time slice, memory, and disk I/O) to the migrationAgent process.

– If this parameter is set to Medium, the source server allocates resources(such as CPU time slice, memory, and disk I/O) to the migration Agentprocess based on the default settings.

– If this parameter is set to Low, the source server preferentially allocatesresources (such as CPU time slice, memory, and disk I/O) to processesthat are not a migration Agent process.

4. Set Target VM Status After Migration.– If you want to stop the target ECS after the migration, set this parameter

to Stop.– If you want to start the target ECS after the migration, set this parameter

to Start.

Step 3: Select the Target1. Click Next.

The Select Target ECSs page is displayed.2. Region: Select the region and project where the target ECS belongs.

Each region has a default project whose project name is the same as the region code.For example, the region code of region CN North-Beijing1 is cn-north-1, and thedefault project name is cn-north-1. However, the project name is not displayed on themanagement console.

● If you select only the region and do not select a project, the default project in theregion is selected by default.

● If you do not select a region, the region and project you selected last time through

are used for migration.



Figure 4-1 Regions and projects

3. Select the Network Type.– Internet: If you select this option, an elastic IP address must be assigned

on the target ECS. Network Type is set to Internet by default.– Private line or VPN: You need to create a private line or VPN connection

between the source server and the VPC subnet where the target ECS islocated.

If the source and destination ECSs are in the same VPC, set Network Type toPrivate line or VPN.

4. Select a target ECS.– Use existing

A target ECS must meet requirements listed below. Otherwise, createtarget ECSs that meet requirements based on the recommendedparameters. For details, see Purchasing an ECS.

Currently, the source servers can be migrated to pay-per-use or yearly/monthlyECSs. You can select ECSs of a specific billing mode as required.

▪ The memory size of the target ECS running a Windows OS cannot beless than 2 GB.

▪ Ensure that the number of disks on the target ECS cannot be lessthan the number of disks on the source server. The size of each diskon the target ECS cannot be less than that on the source server.

▪ Ensure that the image class of the target ECS must be the same asthat of the source server OS. Otherwise, the server name conflictoccurs.

▪ Ensure that source servers can access the target ECSs. Elastic IPaddresses, VPNs, or private lines must be available for the targetECSs.

▪ Ensure that the security group of the VPC to which your target ECSsbelong is correctly configured. The security group rules for the VPC towhich target ECSs belong must be configured to enable TCP ports8899 and 8900 for Windows OSs and enable port 22 for Linux OSs.Set the security group rules. For details, see How Can I Configurethe Security Group Rules for Target ECSs?

– Create during migration



https://support.huaweicloud.com/intl/en-us/qs-ecs/ecs_02_0009.html



▪ If no ECS creating template is selected, the VPC, NIC, and securitygroup will be automatically created. You can change thespecifications as required. The AZ, ECS specifications, disk size, andEIP are automatically configured. You can modify the configurationas required in advanced settings.

▪ If you select an existing template to create the target ECS, theregion, VPC, NIC, security group, AZ, and disks are configured by thetemplate.

● SMS creates a VPC and a subnet. They both belong to network segment192.168.0.0/16.

● SMS automatically creates a security group and enables ports based onthe service requirements. Ports 3389, 8899, and 8900 are enabled forWindows servers, and port 22 is enabled for Linux servers.

● Creating ECS during the migration requires a password, which is in the 1+ first eight characters of the destination SK + ! format. For example, ifthe first eight characters of the SK are RgybsdPP, the password is1RgybsdPP!.

5. After setting the parameters, read and select "I have read and agree to theMigration Conditions."

Click Migration Conditions to open and read the content carefully.

Step 4: Confirm Task Information1. Click Next.

The Confirm Information dialog box is displayed.

2. After confirming that the configured information is correct, read and select Ihave read and agree to the System Migration Disclaimer if you want tocontinue the migration.

Click System Migration Disclaimer to open and read the content carefully.

3. Click Create.

If the created migration task is displayed on the Task Management page andthe task status is Ready , the migration task is successfully created.

Step 5: Start a Migration Task1. On the Task Management page, locate the row that contains the task to be

started and click Start in the Operation column.

The Start dialog box is displayed.

2. In the Start dialog box, confirm information about the task to be started andclick OK.



● During migration, if Internet is selected for Network Type, do not change theelastic IP address of the target ECS.

● During migration, if Private line or VPN is selected for Network Type, do notchange the private IP address of the target ECS.

If the task status reads Migration succeeded, the source server is successfullymigrated to the target ECS.You are advised to configure and optimize your target ECSs running aWindows OS to obtain a better performance. For details, see How Can IConfigure and Optimize My Target ECSs Running a Windows OS After theMigration?






5 Change History

Released On Description

2020-02-20 This issue is the seventh official release, whichincorporates the following change:Added the description of the migration network type inCreating and Starting a Migration Task.

2020-02-11 This issue is the sixth official release, whichincorporates the following changes:● Added the description of using a proxy server to

Installing the Windows Agent.● Added the description of using a proxy server to

Installing the Linux Agent.

2019-08-30 This issue is the third official release, whichincorporates the following change:Added the description about creating an ECS during themigration to Creating and Starting a Migration Task.

2019-07-31 This issue is the second official release, whichincorporates the following change:Added Preparations Before Migration.

2019-03-30 The issue is the first official release.

Server Migration ServiceGetting Started 5 Change History


getting started · 2020-03-18 · 1 preparations before migration this section describes how to...

Documents