When technical support for an operating system is discontinued due to reasons such as end of lifecycle, end of third-party support, or evolution of open source projects, you can use the operating system migration feature to replace or upgrade the operating system. This lets you obtain stable system maintenance and technical support while retaining the data on the system disk of your Elastic Compute Service (ECS) instance.
Scenarios
When the operating system of your ECS instance enters the end of life (EOL) phase as described in Operating system lifecycle overview, you may face increased security and usage risks. In this case, we recommend that you replace the operating system that is in the EOL phase as soon as possible. The operating system migration feature lets you retain your existing application data after replacing the operating system, but provides only some operating system migration options.
If you do not need to retain the data on the system disk or require more operating system conversion options, you can change the operating system by replacing the system disk. You can also refer to Operating system maintenance cycle and EOL guidance to obtain the recommended migration solution and detailed handling methods for your current operating system.
Pre-migration assessment
Before performing the migration, we strongly recommend that you understand the migration limits of the corresponding operating system and perform comprehensive testing and validation of all your business applications in the target operating system environment in advance. This helps ensure compatibility and performance between the applications and the target operating system, effectively avoiding issues such as business operation problems or function failures that may occur after migration.
The operating system migration tool does not support hot migration. During migration, the system kernel and software packages of the source instance will be installed or updated, and the instance will automatically restart multiple times, causing business interruptions. Therefore, before migration, you need to create snapshots to back up data and isolate the operating system environment to be migrated to avoid affecting normal business operations.
Source operating system is Windows
Migration limits
Please make sure you understand the following notes before migrating the operating system.
Cross-language migration of Windows operating systems is not supported.
The ECS instance whose Windows operating system is to be migrated must have at least 2 vCPUs and 2 GiB of memory.
The migration tool consumes resources to download and install software packages during the migration process. Therefore, make sure that the available space of the C drive on the instance is at least 20 GiB, and the available space is larger than the size of the
C:\Windows
directory.Only the following regions support Windows operating system migration.
Asia Pacific - China
Asia Pacific - Others
Europe and Americas
Middle East
China (Hangzhou)
China (Shanghai)
China (Qingdao)
China (Beijing)
China (Zhangjiakou)
China (Hohhot)
China (Ulanqab)
China (Shenzhen)
China (Heyuan)
China (Guangzhou)
China (Chengdu)
China (Hong Kong)
China (Wuhan-Local Region)
Japan (Tokyo)
South Korea (Seoul)
Singapore
Malaysia (Kuala Lumpur)
Indonesia (Jakarta)
Philippines (Manila)
Thailand (Bangkok)
Germany (Frankfurt)
UK (London)
US (Silicon Valley)
US (Virginia)
SAU (Riyadh - Partner Region)
Supported operating systems for migration
The ECS operating system migration feature supports migration to the following operating systems.
Windows Server 2008 R2
Windows Server 2008 R2 has reached end of support. You can migrate it to Windows Server 2016/2019, which are in the mainstream support phase, to host your business.
Due to limitations of the Windows operating system migration feature, you cannot directly migrate from Windows Server 2008 R2 to Windows Server 2016/2019. You need to first migrate to the transitional version Windows Server 2012 R2.
Migrate Windows Server 2008 R2 to the transitional version Windows Server 2012 R2.
Operating system architecture
Source operating system
Destination operating system
x86
Windows Server 2008 R2 Standard Edition 64-bit Chinese/English
Windows Server 2012 R2 Datacenter Edition 64-bit Chinese/English
Windows Server 2008 R2 Enterprise Edition 64-bit Chinese/English
Migrate Windows Server 2012 R2 to Windows Server 2016/2019.
Operating system architecture
Source operating system
Destination operating system
x86
Windows Server 2012 R2 Datacenter Edition 64-bit Chinese/English
Windows Server 2016 Datacenter Edition 64-bit Chinese/English
Windows Server 2019 Datacenter Edition 64-bit Chinese/English
Windows Server 2012 R2
Windows Server 2012 R2 has reached end of support. You can migrate it to Windows Server 2016/2019, which are in the mainstream support phase, to host your business.
Operating system architecture | Source operating system | Destination operating system |
x86 | Windows Server 2012 R2 Standard Edition 64-bit Chinese/English |
|
Windows Server 2012 R2 Datacenter Edition 64-bit Chinese/English |
Windows Server 2016
Operating system architecture | Source operating system | Destination operating system |
x86 | Windows Server 2016 Standard Edition 64-bit Chinese/English |
|
Windows Server 2016 Datacenter Edition 64-bit Chinese/English |
Windows Server 2019
Operating system architecture | Source operating system | Destination operating system |
x86 | Windows Server 2019 Datacenter Edition 64-bit Chinese/English | Windows Server 2022 Datacenter Edition 64-bit Chinese/English |
Source operating system is Linux
Migration limits
Please make sure you understand the following notes before migrating the operating system.
Limit category | Description |
General limit |
|
The following table describes the limits on migrating features or software related to your operating system:
Feature or software | Supported | Migration affected | Description |
i386-based software package | Not supported | Yes | Alibaba Cloud Linux does not provide i386-based software packages. If your current system contains i386-based software packages, you cannot use the migration tool to migrate the operating system. You need to delete these packages before performing migration to prevent system exceptions during migration. |
epel-modular | Not supported | No | The platform on which the EPEL repository of CentOS 7/8 depends is different from that of Alibaba Cloud Linux 3. After migration, you cannot install software packages based on epel-modular. |
Compatibility with C/C++ programs | Not guaranteed | No | Alibaba Cloud Linux 3 is equipped with software packages that provide better compatibility with C/C++ programs. The GNU toolchain of Alibaba Cloud Linux 3 contains GCC 10.2, Binutils 2.35, and glibc 2.32. After you migrate an operating system, we recommend that you compile and verify your C/C++ programs using the new GNU toolchain to prevent incompatibility issues. |
MySQL database | Only migrations to the same or later MySQL versions are supported |
| Alibaba Cloud Linux 3 supports MySQL. However, MySQL version downgrades are not supported. If the MySQL version provided by Alibaba Cloud Linux 3 is earlier than the MySQL version provided by CentOS 7 or 8, you cannot use the migration tool to migrate operating systems. |
Supported operating systems for migration
The ECS operating system migration feature supports migration to the following operating systems.
Migrate CentOS 7 or CentOS 8
Operating system architecture | Source operating system | Destination operating system |
x86 | CentOS 7.x |
|
CentOS 7.9 | RHEL 7 Note This feature is supported only for specific users. If you want to use this feature, you can apply for a trial. | |
CentOS 8.x |
| |
CentOS 8.5 | RHEL 8 Note This feature is supported only for specific users. If you want to use this feature, you can apply for a trial. | |
ARM64 | CentOS 7.x |
|
CentOS 8.x |
|
Migrate RHEL 7 or RHEL 8
Operating system architecture | Source operating system | Destination operating system |
x86 | RHEL 7.9 |
|
RHEL 8.x |
|
Upgrade Alibaba Cloud Linux 2
Operating system architecture | Source operating system | Destination operating system |
x86 | Alibaba Cloud Linux 2 | Alibaba Cloud Linux 3 |
Migration preparation
Resource Access Management (RAM) is activated. Server Migration Center (SMC) is granted the permissions to access cloud resources.
To grant the access permissions to SMC, log on to the RAM console and click Authorize to complete the authorization.
NoteIf you use a RAM user, log on to the RAM console with the corresponding Alibaba Cloud account and grant the
AliyunSMCFullAccess
policy permissions to the RAM user.The ECS Snapshot service is activated. Snapshots are created for an ECS instance when the operating system of the instance is being migrated. For more information, see Activate ECS Snapshot.
The ECS instance whose operating system you want to migrate is in the Running state. Cloud Assistant Agent is installed and ran on the instance within the previous 24 hours. For information about how to install Cloud Assistant Agent, see Install Cloud Assistant Agent.
Migration procedure
During the migration, the system automatically creates snapshots for basic disks on the ECS instance, changes the operating system kernel version, re-installs or upgrades software packages, and stops and then restarts the instance. To prevent your business from being affected by these operations, we recommend that you back up important data in advance and select an appropriate time to perform the migration.
During the migration process, do not manually or through maintenance scripts perform operations such as stopping, restarting, or releasing the ECS instance, as this may cause the migration to fail.
If you perform a migration test or cancel a migration on an ECS instance, all disks on the instance may be automatically rolled back to snapshots created before the migration. In this case, the data generated during the migration is lost.
During Windows migration, the Windows installation media snapshot resource will be automatically shared with the Alibaba Cloud account being migrated, and a transit disk will be created from this snapshot and attached to the instance. Do not operate this disk during migration. The transit disk will be automatically detached and released after the migration is complete.
During migration, the system performs migration condition checks and pre-migration assessments on the source instance. If the source system does not meet the migration conditions or the pre-migration assessment fails, the migration will be interrupted with an error and cannot guarantee successful migration. We recommend that you familiarize yourself with the migration conditions and error troubleshooting documentation in advance and perform tests.
Open the Replace Operating System dialog box.
Go to ECS console - Instance.
In the top navigation bar, select the region of the ECS instance.
Click the ID of the target instance to go to the instance details page, click All Actions to expand all operation panels, then search for and click
.
Select Migrate Operating System. Wait for the system to automatically perform a pre-migration check, which takes about 10 seconds. When the pre-check status changes from
to
, it indicates that the pre-check has passed.
Read the operating system migration notes carefully, select I Acknowledge And Accept These Risks And Authorize Alibaba Cloud To Create Snapshots For All Disks On The ECS Instance. Then click Next.
NoteTo migrate the operating systems of multiple ECS instances at a time, select the ECS instances whose operating systems you want to migrate.
In the Replace Operating System dialog box, select a destination operating system based on your requirements.
Select The Same Destination Operating System: If you migrate the operating systems of multiple ECS instances at a time, you can select this option and specify a destination operating system for all the selected instances.
Select Destination Operating System By Instance: If you migrate the operating systems of multiple ECS instances at a time, you can select this option and specify a destination operating system for each selected instance.
Click Check For Migratability to view the migration check results. The check takes about 30 seconds, please be patient. When the status shows
, click Migrate.
Migration validation
In the Replace Operating System dialog box, click the instance ID. On the Instance Details tab, check whether the operating system of the ECS instance is migrated based on the value of the Instance Status parameter.
NoteApproximately 15 to 30 minutes are required to migrate the operating system. This excludes the time that is required to create snapshots. During the migration, you can move the pointer over Replacing Operating System to view the progress of the migration task.
If the operating system is migrated, the value of the Instance Status parameter changes from Running (Replacing Operating System) to Running.
ImportantIf the instance status shows Running (Operating System Replacement Failed), it indicates that the operating system migration has failed. You can move the pointer over Operating System Replacement Failed to view the cause of the failure, click Identify Issue & Contact Us to resolve the issue. After the issue is resolved, click Retry Replacement to migrate the operating system of the ECS instance again.
After the migration is complete, the instance automatically restarts. The instance ID, image ID, VPC, public and private IP addresses, and hostname remain unchanged. The operating system is changed to the destination operating system. The data on the original system disk is retained. However, your applications may not function as expected due to changes in the environment or dependencies, which can affect your services. Therefore, you must perform tests to verify the outcome of the migration. To roll back the data on the source system disk, you can use the snapshot that was automatically created for backup to roll back a disk.
What to do next
When you migrate the operating system of an ECS instance, snapshots are automatically created for the instance. After you migrate the operating system of the instance, if you confirm that you no longer need these snapshots, we recommend that you delete the snapshots at the earliest opportunity to prevent additional costs. To keep the snapshots, you can check Snapshots to understand the specific billing rules.
You can view and manage the history records of operating system migration tasks in the SMC console, or visit Server Migration Center (SMC) to explore more SMC features.
For migration issues, you can refer to Operating system migration issues (Windows), Operating system migration issues (Linux), and Red Hat migration troubleshooting official documentation.