migration-tools

介绍

本文主要介绍服务器迁移软件(以下简称“migration-tools”）的使用方法，帮助用户顺利从原系统(centos7、centos8)迁移到统信服务器操作系统。 migration-tools工具提供网页界面方式进行操作，以供使用者在图形化界面便捷的进行迁移操作。

部署方式

在安装openeuler 23.09服务器上部署服务端(server)，在需要迁移的 centos7 / centos8服务器上部署客户端(agent)

支持迁移的系统

1.支持将AMD64和ARM64架构的CentOS系列系统迁移到UOS系统，迁移前需自行准备目标系统的全量源。 2.openeuler迁移：目前仅支持centos 7.4 cui系统迁移至openeuler 20.03-LTS-SP1，openEuler-22.03-LTS-SP4，openEuler-24.03-LTS版本。 3.不建议对安装了i686架构的rpm包的原系统进行迁移，如果对这种原系统进行迁移会出现迁移失败的结果。

原系统	目标系统	使用的软件源
centos 7.4 cuiopeneuler 20.03-LTS-SP1，openEuler-22.03-LTS-SP4，openEuler-24.03-LTS版本。		使用openeuler外网源
centos 7.0~7.7	UOS 1002a	UOS 1002a（全量源）
centos 8.0~8.2	UOS 1050a	UOS 1050a（全量源）

使用方法

安装与配置

安装migration-tools-server端

• 关闭防火墙

systemctl stop firewalld

• 安装migration-tools-server

yum install migration-tools-server -y

• 修改配置文件

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

• 重启migration-tools-server服务

systemctl restart migration-tools-server

• 分发agent软件包

迁移UOS/openEuler系统

安装migration-tools-agent端

在准备迁移的centos机器上执行以下步骤

注意: 目前migration-tools仅支持centos7.4 cui迁移至openeuler，目前仅支持迁移，无日志和迁移报告。

• 配置运行系统的软件源并安装migration-tools-agent软件包。

yum install migration-tools-agent

• 修改配置文件

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

• 在Agent端，默认迁移到2003版本，如需迁移其他版本或修改本地源则修改软件源仓库（openEuler-22.03，openEuler-24.03-LTS版本）

vim /usr/lib/migration-tools-agent/ut-Migration-tools-0.1/centos7/openeuler/centos72openeuler.py +11
修改：openeuler_repo软件源

• 重启migration-tools-agent服务

systemctl restart migration-tools-agent

UOS系统迁移步骤

• 登录web端 在server端和agent端服务均启动后，打开浏览器（建议使用：Chrome），在浏览器导航栏中输入https://SERVER_IP:9999即可。

• 点击“我已阅读并同意此协议”，然后点击下一步

• 迁移提示页面内容如下，点击下一步

• 环境检测页面会检查系统版本和系统剩余空间大小，在检测完成后点击下一步

注意: 如果出现检测长时间无反应，请检查agent防火墙是否关闭，server与agent服务是否开启。 如需重新检测，在浏览器中刷新即可。

• 用户检测页面会检查用户名以及密码，推荐使用root用户，迁移到UOS则点击下一步开始检测，检测完成后自动进入repo源配置页面。迁移openEuler系统可直接跳转迁移页面。

repo源配置页面

• 请根据要迁移的系统输入对应的repo源 centos7:1002a，centos8:1050a

• 确保使用的软件源为全量源，否则迁移会失败

• 输入栏中只需输入1个软件仓库路径即可

• 输入完成后点击下一步，等待软件源连通性检测完毕后，进入kernel版本选择页面，选择4.19内核，点击下一步

• 迁移环境检查界面可以对比迁移前后的软件包差异，并输出检测报告，检查完成后可以导出检测报告，

注意： 检测时间大约为1个小时，请耐心等待

• 检测完成后，点击下一步会弹出系统迁移确认窗口，请确保系统已做好备份，准备完成后点击确认开始系统迁移

• 点击确认后，进入系统迁移页面

• 可以点击查看详情，来查看迁移情况

• 迁移完成后，页面会跳转至迁移完成页面，可在该页面导出迁移后检测报告及迁移日志。

• 导出后，可在server端/var/tmp/migration-tools/目录下找到报告和日志的压缩包，解压后即可查看

• 迁移完成后，需手动重启agent机器，并验证是否迁移完成。

验证步骤

1. 执行以下命令，检查操作系统版本是否已升级至目标操作系统。

uosinfo

如显示以下信息表示升级成功 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
#################################################

openEuler：

迁移完成后需要手动重启系统，重启完成后即迁移完成。