migration-tools User Guide ​

Introduction ​

This document outlines the usage of server migration software (migration-tools) for seamless migration from CentOS 7 and CentOS 8 systems to UnionTech OS Server (UOS). The software features a web-based interface that simplifies the migration process through an intuitive graphical environment.

Deployment Method ​

Install the server component on an openEuler 23.09 server and deploy the agent component on CentOS 7/CentOS 8 servers targeted for migration.

Supported Systems for Migration ​

1. Migration from AMD64 and AArch64 CentOS systems to UOS is supported. You need to prepare a complete repository for the target system before migration.

2. openEuler migration: Only migration from CentOS 7.4 CUI to openEuler 20.03 LTS SP1 is supported.

3. Systems with i686 architecture RPM packages should not be migrated as this will lead to migration failure.

Usage Instructions ​

Installation and Configuration ​

Installing migration-tools-server ​

• Disable the firewall.

  shell

  systemctl stop firewalld

• Install migration-tools-server.

  shell

  yum install migration-tools-server -y

• Edit the configuration file.

  shell

  vim /etc/migration-tools/migration-tools.conf

  

• Restart the migration-tools-server service.

  shell

  systemctl restart migration-tools-server

• Distribute the agent package. Choose the appropriate agent package based on the migration system version.

  For CentOS 7 series:

  Replace xx.xx.xx.xx with the migration machine's IP address.

  shell

  scp -r /usr/lib/migration-tools-server/agent-rpm/el7 root@xx.xx.xx.xx:/root

  For CentOS 8 series:

  shell

  scp -r /usr/lib/migration-tools-server/agent-rpm/el8 root@xx.xx.xx.xx:/root

Migrating to openEuler ​

Note: openEuler migration currently supports only standalone script-based migration.

• Distribute the migration script from the server to the agent.

  shell

  cd /usr/lib/migration-tools-server/ut-Migration-tools-0.1/centos7/
  scp openeuler/centos72openeuler.py root@10.12.23.106:/root

• Install the required dependencies for migration.

  shell

  yum install python3 dnf rsync yum-utils -y

• Begin the migration process.

  shell

  python3 centos7/openeuler/centos72openeuler.py

• The system will automatically reboot after migration, and the process will be complete upon restart.

  

Migrating to UOS ​

Installing migration-tools-agent ​

On the CentOS machine to be migrated, follow these steps:

Note: Currently, migration-tools only supports migration from CentOS 7.4 CUI to openEuler 20.03 LTS SP1.

• Disable the firewall.

  shell

  systemctl stop firewalld

• Install epel-release (some dependencies are included in the epel repository).

  shell

  yum install epel-release -y

• Install the migration-tools-agent package (for CentOS 7 series, install the package corresponding to the architecture).

  For CentOS 7:

  shell

  cd /root/el7/x86_64
  yum install ./* -y

  For CentOS 8:

  shell

  cd /root/el8/
  yum install ./* -y

• Edit the configuration file.

  shell

  vim /etc/migration-tools/migration-tools.conf

  

• Restart the migration-tools-agent service.

  shell

  systemctl restart migration-tools-agent

UOS Migration Steps ​

• Access the web interface.

  Once both the server and agent services are running, open a browser (Chrome is recommended) and navigate to https://server_IP_address:9999.

  

• Click "I have read and agree to this agreement," then proceed by clicking "Next."

• Review the migration prompt page and click "Next."

• The environment check page will verify the system version and available disk space. Click "Next" once the check is complete.

Note: If the check stalls, ensure the agent firewall is disabled and both server and agent services are active. Refresh the browser to restart the check.

• The user check page will validate the username and password. Using the root user is recommended. Click "Next" to initiate the check, and the system will automatically proceed to the repository configuration page upon completion.

  

Repository Configuration Page:

• Enter the appropriate repository path based on the system to be migrated.

  CentOS 7: 1002a, CentOS 8: 1050a

• Ensure the repository is complete; otherwise, the migration will fail.

• Only one repository path needs to be entered in the input field.

• After entering the repository, click "Next." Once the repository connectivity check is complete, proceed to the kernel version selection page. Select the 4.19 kernel and click "Next."

  

• The migration environment check page compares software package differences before and after migration and generates a report. After the check, you can export the report.

  Note: The check typically takes about one hour. Please wait patiently.

  

• After the check, click "Next." A confirmation window for system migration will appear. Ensure the system is backed up, then click "Confirm" to start the migration.

  

• After clicking "Confirm," the system migration page will appear.

  

• Click "View Details" to monitor the migration progress.

  

• Once migration is complete, the page will redirect to the completion page. From here, you can export the migration analysis report and logs.

• The exported files can be found in the /var/tmp/uos-migration/ directory on the server. Unzip the files to view them.

  

• After migration, manually restart the agent machine and verify the migration status.

Verification Steps ​

Run the following command to verify if the OS has been successfully migrated to the target version.

uosinfo

If the output matches the expected information below, the migration is successful.

1002a:

#################################################
Release:  UnionTech OS Server release 20 (kongli)
Kernel :  4.19.0-91.77.97.uelc20.x86_64
Build  :  UnionTech OS Server 20 1002c 20211228 x86_64
#################################################

1050a:

#################################################
Release:  UnionTech OS Server release 20 (kongzi)
Kernel :  4.19.0-91.82.88.uelc20.x86_64
Build  :  UnionTech OS Server 20 1050a 20220214 x86_64
#################################################