Scale down Cloud Disks by using Server Migration Center (SMC) to migrate an ECS instance to a custom image or a destination instance with smaller disks.
Migration limits
You cannot migrate ECS instances created from Alibaba Cloud Marketplace images. To use this feature, contact us to have your account added to the whitelist.
Migration impact
Before you start the migration, review the following potential impacts.
|
Affected item |
Description |
|
Migrated data directories |
During the migration, you can adjust the partition structure of the destination disk, including partition size, order, transfer method, and Logical Volume Management (LVM) configurations. By default, all of the server's disks are migrated:
|
|
Intermediate instance |
Do not interfere with the intermediate instance. To prevent migration failure, do not stop, start, restart, or release the intermediate instance, or change its billing method during the migration. SMC automatically releases the intermediate instance after the migration is complete. Note
For more information, see How it works. |
|
IP address |
Migrating a server changes its IP address, which can interrupt services. We recommend performing the migration during off-peak hours. If your services involve IP address configurations, you must update the domain name resolution and ICP filing after the migration.
|
|
Underlying hardware |
The migration changes the underlying hardware, which can invalidate application licenses bound to it. Check these licenses before you start. |
|
Performance impact |
The migration process consumes server resources, including CPU, memory, disk I/O, and network bandwidth. |
|
Data consistency |
For information about issues caused by data or system configuration changes during the migration, see Data consistency issues after migration. |
Prerequisites
-
You have completed the pre-migration preparations.
-
You have read the migration guide to learn about the SMC client, how migration works, billing, the migration process, and feedback channels.
-
To prevent data loss, back up important data to an image, a snapshot, or an external storage device before the migration.
-
If you migrate a server across international regions, the migration may be slow due to unstable public network connections. Evaluate the migration duration and test the transfer speed. Use VPN Gateway, Express Connect, a physical leased line, or Smart Access Gateway to connect the source server to an Alibaba Cloud Virtual Private Cloud (VPC) and perform the migration over a private network.
-
If you can directly access a Virtual Private Cloud (VPC) in a specific Alibaba Cloud region from your on-premises data center, virtual machine environment, or cloud server, use the private network migration solution. Private network migration is faster and more stable than migrating over the public network.
-
To migrate a source server to an existing ECS instance:
-
The operating system of the destination instance must match that of the source server (both must be Linux or both must be Windows).
-
The destination instance must have at least as many data disks as the source server. If the destination instance has an insufficient number of data disks, you must attach a data disk.
-
The capacity of the system disk and each data disk on the destination instance must be greater than or equal to the used space on the corresponding disk of the source server. If the destination instance has insufficient cloud disk capacity, you must resize a disk.
-
Migration procedure
To migrate a Windows instance, you must compress the disk space before you import the migration source. Otherwise, you cannot reduce the disk capacity.
Step 1: Import a migration source
Console import
-
The source ECS instance must have public network access.
-
The source server must be in the Running state, and the Cloud Assistant agent must be running correctly. For more information, see View the status of the Cloud Assistant agent and handle exceptions.
-
If you use a RAM user to import a migration source, you must manage RAM user permissions:
-
The AliyunECSReadOnlyAccess permission for read-only access to ECS.
-
The AliyunECSAssistantFullAccess permission for full management access to Cloud Assistant.
-
-
Go to the SMC console - Scale-in Migration page.
-
On the Shrunk Migration page, click Import Migration Source.
-
Configure the parameters for the migration source, and then click Import.
The import process takes 3 to 10 minutes.
Parameter
Description
Migration Source Type
ECS Instance.
Import Method
Select Import through Console.
Authorize Server Migration Center (SMC) to remotely connect to the source server from the console and automatically import the migration source. The Cloud Assistant feature is automatically used during the import process. Do not interrupt or exit the process.
Region
Select the region where the source server is located.
Instance
Search for and select the ECS instances to migrate by instance ID, name, or IP address. You can import multiple instances at once.
Tag (Optional)
Add tags to the migration task to facilitate search and management. For more information, see Use tags to manage migration sources and migration tasks and Use tags for fine-grained permission management.
You can add a maximum of 20 tags to a migration task.
Resource Group (Optional)
Assign the task to a resource group to manage resources by project, business unit, or other dimensions.
-
On the Shrunk Migration page of the SMC console, view the status of the migration source in the Real-time Migration Status column.
-
A status of Migration SourceOnline indicates a successful import.
-
Any other status indicates that the import failed. Troubleshoot the issue and then re-import the migration source.
-
Troubleshoot the issue using the console's error message or the SMC client log files. The default installation directories are:
-
Windows servers: C:\smc.
-
Linux servers: /smc.
-
-
For information about common issues and solutions, see SMC FAQ and Troubleshoot errors.
-
-
Command-line import
If you cannot use the console import method, import the migration source from the command line instead.
-
The source server must have public network access. If a firewall is configured for the source server, see SMC service domain names to obtain the required SMC domain names and ports and add them to the firewall's allowlist.
-
If your source server cannot access the public network or you want to use a private network to improve migration efficiency, see Private network-based migration.
-
Go to the SMC console - Scale-in Migration page.
-
On the Shrunk Migration page, click Import Migration Source.
-
Follow the on-screen instructions to configure the parameters and copy the activation command.
Parameter
Description
Migration Source Type
ECS Instance
Import Method
Select Use CLI to Import Server.
Generate an activation script and run it on the source server to import the migration source.
Migration Source Quota
The number of migration sources that can be activated by using the activation code. Valid values: 1 to 1,000. Default value: 200.
Validity Period
The validity period of the activation code in days. Valid values: 1 to 90. Default value: 90.
Activation Code
To generate an activation code, perform the following steps:
-
Click Generate.
-
Based on the operating system of the source server, click the Linux Shell or Windows PowerShell tab.
-
Click Copy to copy the activation command.
-
-
Log on to the source server. Then, with administrator privileges, paste and run the copied command to import the migration source.
Linux source server
-
Log on to the Linux server.
-
Paste and run the copied command with administrator privileges to import the migration source.

A success message similar to
Import Source Server [s-bp18x8751kgz2oyh****] Successfully!indicates that the migration source was imported.
Windows source server
-
Log on to the Windows server.
-
Open Windows PowerShell with administrator privileges.
-
Paste and run the copied command to import the migration source.

A success message similar to
Import Source Server [s-bp19rlidl3mwuptc****] Successfully!indicates that the migration source was imported.If the command fails to run, see What do I do if I fail to import a Windows migration source by using a command?
-
-
On the Shrunk Migration page of the SMC console, view the status of the migration source in the Real-time Migration Status column.
-
A status of Migration SourceOnline indicates a successful import.
-
Any other status indicates that the import failed. Troubleshoot the issue and then re-import the migration source.
-
Troubleshoot the issue using the console's error message or the SMC client log files. The default installation directories are:
-
Windows source servers: C:\smc.
-
Linux source servers: /smc.
-
-
For information about common issues and solutions, see SMC FAQ and Troubleshoot errors.
-
-
SMC client import
-
You must run the client on the source server. By default, public network access is enabled. If a firewall is configured for the source server, see SMC service domain names to obtain the required SMC domain names and ports and add them to the firewall's allowlist.
-
If your source server cannot access the public network or you want to use a private network to improve migration efficiency, see Private network-based migration.
-
Go to the SMC console - Scale-in Migration page.
-
On the Shrunk Migration page, click Import Migration Source.
-
On the Import Migration Source page, configure the following parameters.
Parameter
Description
Migration Source Type
ECS Instance
Import Method
Select Use Client to Import Server.
You must manually download and install the SMC client on the source server.
Description
-
In the Description section, follow the prompts to download, install, and activate the appropriate SMC client based on the operating system (Linux or Windows) and architecture (32-bit or 64-bit) of the source server.
-
Click Generate and copy the activation code.
You need to enter the activation code when you install the client.
-
-
Import the migration source.
ImportantDo not close the SMC client during the migration. Closing it will disconnect the source server from the SMC console and cause the migration to fail.
Windows source server
-
Use a remote connection tool that supports file transfer (such as WinSCP) to upload the downloaded SMC client to the Windows source server.
-
On the Windows source server, use the built-in decompression tool or a third-party tool to decompress the SMC client package.
-
In the SMC client folder that matches your source server's system version, double-click the go2aliyun_client.exe application to run it.
A prompt appears, requesting administrator privileges. Click OK.
-
Obtain an activation code or an AccessKey pair.
-
(Recommended) Get an activation code: In the Description section of the SMC console, click Generate and copy the code.
-
Obtain an AccessKey pair: The AccessKey pair of an Alibaba Cloud account consists of an AccessKey ID and an AccessKey secret. If you have not created an AccessKey pair, create one first.
-
-
As prompted, enter the values for
access_access_token_idandaccess_token_code, and then pressEnter.If a message similar to
Import Source Server [s-bp18x8751kgz2oyh****] Successfully!is returned, the migration source is successfully imported.
Linux source server
-
Use a remote connection tool that supports file transfer (such as WinSCP) to upload the downloaded SMC client to the Linux source server.
-
Remotely connect to the Linux source server and decompress the SMC client package.
This example uses the
Linux 64-bit General-purpose Edition. If you use a different version of the SMC client, replace the package name in the command with the name of the file that you downloaded.tar -zxvf go2aliyun_client.tar.gzNoteThe Linux 64-bit ARM Edition supports the g6r general-purpose and c6r compute-optimized instance families. For more information about instance families, see Enterprise-level Arm-based compute instance families.
-
(Optional) Exclude files or directories that you do not want to migrate.
-
Obtain an activation code or an AccessKey pair.
-
(Recommended) Get an activation code: In the Description section of the SMC console, click Generate and copy the code.
-
Obtain an AccessKey pair: The AccessKey pair of an Alibaba Cloud account consists of an AccessKey ID and an AccessKey secret. If you have not created an AccessKey pair, create one first.
-
-
In the SMC client folder, run the following commands to start the SMC client.
cd go2aliyun_client_linux_x86_64 sudo chmod +x go2aliyun_client sudo ./go2aliyun_client -
Enter the activation code or AccessKey pair as prompted. The following figure shows an example of entering an activation code:

After you enter the activation code or AccessKey pair, the following prompts may appear:
-
If a snapshot driver is not installed on the source system, the SMC client displays the following prompt.
Because block replication must be disabled for a scale-in migration of a Linux server, enter
no.ImportantIf the snapshot driver installation fails, do not enable block replication when creating the migration task, or the migration will fail.

-
Most mainstream source systems have rsync installed by default. If rsync is not installed, the SMC client prompts you to install it. Enter
yesto automatically install rsync.
-
If SELinux is enabled on the source system, the SMC client prompts you to disable it. Enter
yesto automatically disable SELinux.
If a message similar to
Import Source Server [s-bp11npxndknsycqj****] Successfully!is returned, the migration source is successfully imported.NoteIf the import fails, troubleshoot the issue based on the error message. Then, run the following commands to exit the background process and re-import the migration source. For more information about common issues and solutions, see SMC FAQ and Troubleshoot errors.
sudo ./go2aliyun_client --abort sudo ./go2aliyun_client -
-
-
On the Shrunk Migration page of the SMC console, view the status of the migration source in the Real-time Migration Status column.
-
A status of Migration SourceOnline indicates a successful import.
-
Any other status indicates that the import failed. Troubleshoot the issue and then re-import the migration source.
-
Troubleshoot the issue using the console's error message or the SMC client log files. The default installation directories are:
-
Windows source servers: C:\smc.
-
Linux source servers: /smc.
-
-
For information about common issues and solutions, see SMC FAQ and Troubleshoot errors.
-
-
Step 2: Configure migration task
-
In the Actions column of the target migration source, click Start Migration.
-
Configure the parameters as instructed on the screen, and click Start Migration. In the confirmation dialog box, read the notes, select Got It, and then create the task.
-
Configure basic parameters.
Parameter
Description
Destination Type (Required)
Select a destination type based on your migration scenario:
ECS Image
Converts the source server into a custom image that you can use to create a new ECS instance.
The following parameters are available:
-
Destination Region: The Alibaba Cloud region to which you want to migrate the source server. This parameter is required. For more information about regions, see Regions and zones.
-
Image name prefix: The prefix of the custom image name after migration.
ECS Instance
Migrates the source server to an existing ECS instance. The source server and destination instance must have compatible storage and operating system configurations.
ImportantMigrating to a destination instance replaces its operating system. The automatic snapshots of the system disk are deleted and cannot be restored. To keep automatic snapshots for data security or future use, you can prevent automatic snapshots from being released with their disks before the migration.
The following parameters are available:
-
Destination Region: The Alibaba Cloud region to which you want to migrate your source server. This parameter is required. For more information about regions, see Regions and zones.
-
Destination Instance: Select an ECS instance as the destination instance.
Automatic Incremental Synchronization
Automatically synchronizes incremental data from the source server to Alibaba Cloud when enabled. Disabled by default.
-
If you enable this feature, you must configure the following parameters:
-
Synchronization Interval: The interval at which the incremental migration task is automatically run.
-
Maximum Reserved Images: The maximum number of images that are retained by default for the incremental migration task.
The migration task is automatically run on a schedule to synchronize incremental data to Alibaba Cloud. For information about best practices for incremental migration, see Incremental server migration.
-
-
If you disable this feature, the migration task runs only once.
Enable a migration template
This parameter is available only when Destination Type is set to ECS Image.
A migration template is used to pre-configure the parameters of a migration task. When you start the migration, the template parameters are automatically populated. For more information about how to configure a migration template, see Configure a migration template.
Network Type
Select the network for transferring data to the intermediate instance. By default, data is transferred over the public network, and the intermediate instance is created in the selected VPC and vSwitch with an automatically assigned public IP address.
Public Network
Data is transferred to the intermediate instance over the public network. To use this mode, the source server must have public network access. You can specify a VPC and a vSwitch based on your business requirements.
-
Specify VPC and vSwitch: The migration task creates an intermediate instance in the VPC and vSwitch that you specify.
-
Do not specify VPC and vSwitch: The migration task creates an intermediate instance in a new VPC and vSwitch that are automatically created by the system.
VPC
Data is transferred to the intermediate instance over a VPC. To use this mode, you must connect the source server to an Alibaba Cloud VPC and specify a VPC and a vSwitch.
NoteIf you can directly access an Alibaba Cloud VPC in a specific region from an on-premises data center (IDC), a virtual machine environment, or another cloud host, we recommend that you use this migration method. Transferring data over a private network is faster and more stable than over the public network. You can use VPN Gateway, Express Connect, or Smart Access Gateway to connect the source server to the VPC. For more information, see Connect a VPC to a local data center or another cloud.
The private IPv4 address of the destination instance
This parameter is available only when Destination Type is set to ECS Instance.
-
Remain unchanged.: By default, the IP address of the Destination Instance is retained.
-
Manual: Allows you to enter an IP address from the available IP address range of the vSwitch to which the Destination Instance belongs. If the IP address of the migration source is within the CIDR block of the vSwitch, you can change the IP address of the destination instance to that of the migration source.
-
If the CIDR block of the destination instance is the same as that of the migration source: Enter the private IP address of the migration source.
-
If the CIDR block of the destination instance is different from that of the migration source: You must first change the VPC of the destination instance to make the CIDR blocks the same. Then, enter the private IP address of the migration source.
-
-
-
Adjust the disk partition structure as required.
Parameter
Description
Modify Disk Partition
This feature is enabled by default and requires SMC client V2.8.0 or later. For more information about the SMC client, see SMC client usage guide.
Linux systems
Block replication is disabled by default. You can modify the disk size and partition sizes to configure a scale-in migration.
-
The destination disk size must be larger than the used capacity of the source disk.
For example, if the source disk size is 60 GiB and the used capacity is 30 GiB, the destination disk size must be larger than 30 GiB.
-
The destination disk size must be larger than the sum of all partition sizes.
For example, if the destination disk size is 40 GiB, the sum of all partition sizes must be less than 40 GiB.
For information about other parameters, see Disk partition structure parameters.
Windows systems
Block replication is enabled by default and cannot be modified. The custom disk size must be larger than the sum of all partition sizes.
ImportantMake sure that you have compressed the disk space for the migration source before you import it. Otherwise, you cannot reduce the disk capacity.
For information about other parameters, see Disk partition structure parameters.
-
-
-
-
On the Server Migration page, view the real-time migration status.
If you enabled migration drills, SMC performs a drill first. The data transfer duration depends on factors such as data volume and network bandwidth.
Note-
Speed: The amount of data transferred per second before compression. If you set the Compression Ratio to a value greater than 0 when you create the migration task, the displayed speed is higher than the actual transfer speed of the compressed data.
-
Time Remaining for Synchronization: The estimated time until the synchronization is complete, calculated by using the following formula: (Total data volume - Transferred data volume) / Speed.
-
If the transfer speed is too low for your plan, consider temporarily increasing the fixed bandwidth of the source and destination servers. For more information, see Evaluate migration time and test transfer speed.
-
-
(Optional) View migration details.
In the Migration Source ID/Name column, click the ID of a migration source to view its details.
Verify the migration result
-
A Real-time Migration Status of Completed indicates that the migration was successful.
-
If the Destination Type is ECS Image:
After a successful migration, a custom image is created in your Alibaba Cloud account. Scroll to the right and, in the Migration Deliverables column, click View Report to view the image detection results.
Manual verification (Recommended)
In the Actions column, click Create Instance. You will be redirected to the ECS instance creation page in the console, with the newly created custom image selected by default. For more information about how to create an ECS instance, see Create an instance from a custom image or a shared image. The default system disk type and capacity may not match the type and size of the scaled-down cloud disk. Adjust the settings as needed.

Automatic verification
NoteTo use this feature, you must meet the following conditions:
-
During verification, a temporary pay-as-you-go instance is created from the custom image. Make sure that your Alibaba Cloud account has a balance of at least CNY 100.
-
You must install the Cloud Assistant agent on the instance. The instance must run a supported operating system version. For more information, see Install the Cloud Assistant agent.
This feature uses the Alibaba Cloud OOS template
ACS-SMC-CreateAndVerifyInstanceto automatically create an ECS instance from the image and verify that it starts correctly.-
In the Actions column, click Verify Migration Result.

-
In the dialog box that appears, review the verification process and click Verify Now.
You can also click Customize Verification Parameters to manually configure verification parameters.
-
In the Verify Migration Result column, check the result.
-
Verified: The verification was successful. Click View Report to view more information.
-
Not Verified: The verification failed. Click View Cause to identify and troubleshoot the cause of the failure.
You can also click the
icon in the Actions column and select View Verification Records in OOS Console to view the OOS template's execution history. -
-
-
If the Destination Type is ECS Instance, you can click View Destination Instance in the Actions column to open the destination ECS instance page.
-
-
If the migration drill status is
, the migration drill failed.Review the drill report, resolve all Critical drill items, and then retry the migration drill. For more information, see Configure a migration drill.
-
If the Real-time Migration Status is InError, the migration task has failed.
In this case, troubleshoot the issue and retry the migration:
-
In the Actions column, click Troubleshoot Errors. Use the provided error code and message to resolve the issue. For more information, see SMC FAQ and Troubleshoot errors.
-
After fixing the issue, in the Actions column, click Retry Migration Job. The migration resumes from the point of failure.
ImportantIf you release the intermediate instance, you must restart the migration. For more information, see What do I do if I accidentally release an intermediate instance?.
-
Next steps
After a successful migration, follow these steps to ensure your business operates as expected:
-
Verify and validate your data to ensure its integrity and correctness. For more information, see How do I check the system after migrating a Linux server? or How do I check the system after migrating a Windows server?.
-
Manually start any applications and services that are not configured to start automatically.
-
Because the server's IP address changes after migration, you must update any dependent configurations, such as domain name resolution and ICP filings.
-
If a domain name is bound to the source server, update its DNS record to point to the server's new public IP address. For more information, see Add a website for DNS resolution.
-
If you need to keep the original private IP address, you can assign it to the new instance.
-
Migrate to an ECS Image: Specify the primary private IPv4 address for the primary network interface when you create an ECS instance.
-
Migrate to a Destination Instance: If you did not modify the private IPv4 address in the advanced configurations of the migration settings step, you can still modify the primary private IPv4 address of the primary network interface for an existing instance.
-
-
You may need to modify your ICP filing information. For more information, see Modify an ICP filing and ICP filing process.
-
Clean up resources
Migrate to an image
During the migration, SMC creates a temporary pay-as-you-go intermediate instance named No_Delete_SMC_Transition_Instance in your destination Alibaba Cloud account to assist with the migration. The outcome of the migration determines whether you need to manually release the instance:
-
Successful migration: SMC automatically releases the intermediate instance. No manual cleanup is required.
-
Migration error: SMC does not release the intermediate instance, which continues to incur charges. To avoid unnecessary charges, you can release the instance in one of the following ways:
-
If you no longer need the migration task, click the migration source ID. In the Actions column for the migration task, click Cancel Migration Job to delete the migration task and automatically release the intermediate instance.
-
Manually release the intermediate instance.
-
Migrate to an instance
During the migration, SMC creates a temporary pay-as-you-go intermediate disk named SMC_Temp_Disk and attaches it to the destination instance to assist with the migration. The outcome of the migration determines whether you need to manually release the intermediate disk:
-
Successful migration: SMC automatically releases the intermediate disk. No manual cleanup is required.
-
Migration error: SMC does not release the intermediate disk, which continues to incur charges. To avoid unnecessary charges, you can release the disk in one of the following ways:
-
If you no longer need the migration task, click the migration source ID. In the Actions column for the migration task, click Cancel Migration Job to delete the migration task and automatically release the intermediate disk.
-
Manually release the intermediate disk.
-
References
-
After the initial full migration, you can run incremental migrations at custom intervals to synchronize data from the source server and reduce downtime during the final cutover. For more information, see Incremental server migration.
-
To transfer an ECS instance to another Alibaba Cloud account and retain its public IP address, see Transfer an ECS server.
-
For solutions to common issues, see FAQ and Troubleshooting.

icon next to the mount point.


icon, and then click Disk Management.

