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。

3. 不建议对安装了 i686 架构的 rpm 包的原系统进行迁移，如果对这种原系统进行迁移会出现迁移失败的结果。

使用方法 ​

安装与配置 ​

安装 migration-tools-server 端 ​

• 关闭防火墙。

  shell

  systemctl stop firewalld

• 安装 migration-tools-server。

  shell

  yum install migration-tools-server -y

• 修改配置文件。

  shell

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

  

• 重启 migration-tools-server 服务。

  shell

  systemctl restart migration-tools-server

• 分发 agent 软件包。

• 根据迁移系统的版本选择分发的软件包。

  centos7系列：

  xx.xx.xx.xx表示迁移机器IP

  shell

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

  centos8系列：

  shell

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

迁移 openeuler 系统 ​

注意: openeuler 系统目前仅支持单独使用脚本迁移。

• 从 server 端分发迁移脚本至 agent 端。

  shell

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

• 安装迁移所需依赖。

  shell

  yum install python3 dnf rsync yum-utils -y

• 开始迁移。

  shell

  python3 centos7/openeuler/centos72openeuler.py

• 迁移完成后系统会自动重启，重启完成后即迁移完成。

  

迁移 UOS 系统 ​

安装 migration-tools-agent 端 ​

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

注意: 目前 migration-tools 仅支持 centos7.4 cui 迁移至 openeuler 20.03-LTS-SP1。

• 关闭防火墙。

  shell

  systemctl stop firewalld

• 安装 epel-release（部分依赖包含在 epel 源中）。

  shell

  yum install epel-release -y

• 安装 migration-tools-agent 软件包（centos7 系列需安装对应架构的软件包）。

  centos7:

  shell

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

  centos8

  shell

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

• 修改配置文件。

  shell

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

  

• 重启 migration-tools-agent 服务。

  shell

  systemctl restart migration-tools-agent

UOS系统迁移步骤 ​

• 登录web端

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

  

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

  

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

  

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

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

• 用户检测页面会检查用户名以及密码，推荐使用 root 用户，点击“下一步”开始检测，检测完成后自动进入 repo 源配置页面。

  

repo 源配置页面：

• 请根据要迁移的系统输入对应的repo源。

  centos7:1002a，centos8:1050a

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

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

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

  

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

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

  

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

  

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

  

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

  

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

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

  

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

验证步骤 ​

执行以下命令，检查操作系统版本是否已迁移至目标操作系统。

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
#################################################