diff --git a/README.md b/README.md index b9a21e2d3a89f5926df9a8d56d7a5ca1a0d804de..269849c31994f950ae36ad35f58710151a5a85b0 100644 --- a/README.md +++ b/README.md @@ -7,17 +7,17 @@ migration-tools工具提供网页界面方式进行操作，以供使用者在 ### 部署方式 -在安装openeuler 23.09服务器上部署服务端(server)，在需要迁移的 centos7 / centos8服务器上部署客户端(agent) +在安装openEuler-25.03服务器上部署服务端(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版本。 +2.openeuler迁移：目前仅支持centos 7.4 cui系统迁移至openeuler 20.03-LTS-SP1，openEuler-22.03-LTS-SP4，openEuler-24.03-LTS,openEuler-25.03版本。 3.不建议对安装了i686架构的rpm包的原系统进行迁移，如果对这种原系统进行迁移会出现迁移失败的结果。 | 原系统 | 目标系统 | 使用的软件源 | | ------------------------------------------------------------ | --------- | ------------------- | -| centos 7.4 cuiopeneuler 20.03-LTS-SP1，openEuler-22.03-LTS-SP4，openEuler-24.03-LTS版本。 | | 使用openeuler外网源 | +| centos 7.4 | cuiopeneuler 20.03-LTS-SP1，openEuler-22.03-LTS-SP4，openEuler-24.03-LTS-SP2,openEuler-25.03。 | 使用openeuler外网源 | | centos 7.0~7.7 | UOS 1002a | UOS 1002a（全量源） | | centos 8.0~8.2 | UOS 1050a | UOS 1050a（全量源） | @@ -39,14 +39,12 @@ systemctl stop firewalld yum install migration-tools-server -y ``` -- 修改配置文件 +- 修改配置文件，修改IP ``` shell vim /etc/migration-tools/migration-tools.conf ``` -![配置文件](/home/xzx/nfs/xzx/gitee/src_commit/migration-tools-src/README.assets/migration-tools-conf.png) - - 重启migration-tools-server服务 ``` shell @@ -55,6 +53,22 @@ systemctl restart migration-tools-server - 分发agent软件包 +- 在server端安装httpd服务 + +``` shell +yum install httpd +systemctl restart httpd +systemctl enabled httpd +``` + +- 在server端将agent包及其依赖解压至/var/www/html目录 + +``` shell +cd /usr/lib/migration-tools-server/agent-requires/ +tar -zxvf requires.tar.gz -C /var/www/html +systemctl restart httpd +``` + #### 迁移UOS/openEuler系统 ##### 安装migration-tools-agent端 @@ -66,19 +80,28 @@ systemctl restart migration-tools-server - 配置运行系统的软件源并安装migration-tools-agent软件包。 +- 在agent端新增repo文件并安装 + +``` shell +vi /etc/yum.repos.d/migration-tools.repo +[migration] +name=migration +baseurl=http://SERVER_IP/requires/$basearch +enabled=1 +gpgcheck=0 +``` + ``` shell yum install migration-tools-agent ``` -- 修改配置文件 +- 修改配置文件，修改Sevrer和AgentIP，保持Server和Agent一致。 ``` shell vim /etc/migration-tools/migration-tools.conf ``` -![配置文件](/home/xzx/nfs/xzx/gitee/src_commit/migration-tools-src/README.assets/migration-tools-conf.png) - -- 在Agent端，默认迁移到2003版本，如需迁移其他版本或修改本地源则修改软件源仓库（openEuler-22.03，openEuler-24.03-LTS版本） +- 在Agent端，默认迁移到openEuler-25.03版本，如需迁移其他版本或修改本地源则修改软件源仓库。 ``` shell vim /usr/lib/migration-tools-agent/ut-Migration-tools-0.1/centos7/openeuler/centos72openeuler.py +11 @@ -91,27 +114,26 @@ vim /usr/lib/migration-tools-agent/ut-Migration-tools-0.1/centos7/openeuler/cent systemctl restart migration-tools-agent ``` - -##### UOS系统迁移步骤 - - 登录web端 在server端和agent端服务均启动后，打开浏览器（建议使用：Chrome），在浏览器导航栏中输入`https://SERVER_IP:9999`即可。 - 点击“我已阅读并同意此协议”，然后点击下一步 - ![许可协议](/home/xzx/nfs/xzx/gitee/src_commit/migration-tools-src/README.assets/许可协议.png) + ![许可协议](./docs/zh/figures//许可协议.png) - 迁移提示页面内容如下，点击下一步 - ![提示](/home/xzx/nfs/xzx/gitee/src_commit/migration-tools-src/README.assets/提示.png) + ![提示](./docs/zh/figures//提示.png) - 环境检测页面会检查系统版本和系统剩余空间大小，在检测完成后点击下一步 >**注意:** 如果出现检测长时间无反应，请检查agent防火墙是否关闭，server与agent服务是否开启。 >如需重新检测，在浏览器中刷新即可。 -![环境检测](/home/xzx/nfs/xzx/gitee/src_commit/migration-tools-src/README.assets/环境检测.png) +![环境检测](./docs/zh/figures//环境检测.png) + +>**注意:** 用户检测页面会检查用户名以及密码，推荐使用root用户，迁移到UOS则点击下一步开始检测，检测完成后自动进入repo源配置页面。迁移openEuler系统可直接跳转迁移页面。 + -- 用户检测页面会检查用户名以及密码，推荐使用root用户，迁移到UOS则点击下一步开始检测，检测完成后自动进入repo源配置页面。迁移openEuler系统可直接跳转迁移页面。 - ![用户检测](/home/xzx/nfs/xzx/gitee/src_commit/migration-tools-src/README.assets/选择目标系统.png) +### UOS系统迁移步骤 repo源配置页面 @@ -121,29 +143,29 @@ repo源配置页面 - 确保使用的软件源为全量源，否则迁移会失败 - 输入栏中只需输入1个软件仓库路径即可 - ![repo](/home/xzx/nfs/xzx/gitee/src_commit/migration-tools-src/README.assets/repo.png) + ![repo](./docs/zh/figures//repo.png) - 输入完成后点击下一步，等待软件源连通性检测完毕后，进入kernel版本选择页面，选择4.19内核，点击下一步 - ![kernel](/home/xzx/nfs/xzx/gitee/src_commit/migration-tools-src/README.assets/kernel.png) + ![kernel](./docs/zh/figures//kernel.png) - 迁移环境检查界面可以对比迁移前后的软件包差异，并输出检测报告，检查完成后可以导出检测报告， > **注意：** 检测时间大约为1个小时，请耐心等待 -![迁移检查](/home/xzx/nfs/xzx/gitee/src_commit/migration-tools-src/README.assets/迁移检查.png) +![迁移检查](./docs/zh/figures//迁移检查.png) - 检测完成后，点击下一步会弹出系统迁移确认窗口，请确保系统已做好备份，准备完成后点击确认开始系统迁移 - ![迁移确认](/home/xzx/nfs/xzx/gitee/src_commit/migration-tools-src/README.assets/迁移确认.png) + ![迁移确认](./docs/zh/figures//迁移确认.png) - 点击确认后，进入系统迁移页面 - ![迁移开始](/home/xzx/nfs/xzx/gitee/src_commit/migration-tools-src/README.assets/迁移开始.png) + ![迁移开始](./docs/zh/figures//迁移开始.png) - 可以点击查看详情，来查看迁移情况 - ![迁移中](/home/xzx/nfs/xzx/gitee/src_commit/migration-tools-src/README.assets/迁移中.png) + ![迁移中](./docs/zh/figures//迁移中.png) - 迁移完成后，页面会跳转至迁移完成页面，可在该页面导出迁移后检测报告及迁移日志。 - 导出后，可在server端/var/tmp/migration-tools/目录下找到报告和日志的压缩包，解压后即可查看 - ![迁移完成](/home/xzx/nfs/xzx/gitee/src_commit/migration-tools-src/README.assets/迁移完成.png) + ![迁移完成](./docs/zh/figures//迁移完成.png) - 迁移完成后，需手动重启agent机器，并验证是否迁移完成。 @@ -177,6 +199,6 @@ Build : UnionTech OS Server 20 1050a 20220214 x86_64 ``` openEuler： -![openeuler迁移完成](/home/xzx/nfs/xzx/gitee/src_commit/migration-tools-src/README.assets/openeuler-migration-complete.png) +![openeuler迁移完成](./docs/zh/figures//openeuler-migration-complete.png) 迁移完成后需要手动重启系统，重启完成后即迁移完成。