diff --git a/docs/en/2509/_toc.yaml b/docs/en/2509/_toc.yaml new file mode 100644 index 0000000000000000000000000000000000000000..4d5cd9d79ad2390eb14ad81a03eeb83b9d5cb0bd --- /dev/null +++ b/docs/en/2509/_toc.yaml @@ -0,0 +1,6 @@ +label: migration-tools User Guide +isManual: true +description: Migration from other OSs (CentOS 7/8) to UnionTech OS Server +sections: + - label: migration-tools User Guide + href: ./migration_tools_user_guide.md diff --git a/docs/en/2509/figures/environment-check.png b/docs/en/2509/figures/environment-check.png new file mode 100644 index 0000000000000000000000000000000000000000..b03c4da5ba24e345a3614cd2c7d7e3b52983ad1a Binary files /dev/null and b/docs/en/2509/figures/environment-check.png differ diff --git a/docs/en/2509/figures/home-page.png b/docs/en/2509/figures/home-page.png new file mode 100644 index 0000000000000000000000000000000000000000..2fb66ae7dc8336d6e38437ba79175fe1c2207a5d Binary files /dev/null and b/docs/en/2509/figures/home-page.png differ diff --git a/docs/en/2509/figures/kernel.png b/docs/en/2509/figures/kernel.png new file mode 100644 index 0000000000000000000000000000000000000000..ecd5bbb3cf306e46da3448de46c4f9fc2e03eed2 Binary files /dev/null and b/docs/en/2509/figures/kernel.png differ diff --git a/docs/en/2509/figures/license.png b/docs/en/2509/figures/license.png new file mode 100644 index 0000000000000000000000000000000000000000..41eb3b6aa755619b94965f8060a27c1940e6936e Binary files /dev/null and b/docs/en/2509/figures/license.png differ diff --git a/docs/en/2509/figures/migration-check.png b/docs/en/2509/figures/migration-check.png new file mode 100644 index 0000000000000000000000000000000000000000..776e9cafdf7e569cd33e1abd47217aa47c86f134 Binary files /dev/null and b/docs/en/2509/figures/migration-check.png differ diff --git a/docs/en/2509/figures/migration-complete.png b/docs/en/2509/figures/migration-complete.png new file mode 100644 index 0000000000000000000000000000000000000000..c832bb723ea5400aa2fe1f932f1f5dcb5a3d5065 Binary files /dev/null and b/docs/en/2509/figures/migration-complete.png differ diff --git a/docs/en/2509/figures/migration-confirmation.png b/docs/en/2509/figures/migration-confirmation.png new file mode 100644 index 0000000000000000000000000000000000000000..69567eabd886befe43fb8a512e7b6cde87fd0937 Binary files /dev/null and b/docs/en/2509/figures/migration-confirmation.png differ diff --git a/docs/en/2509/figures/migration-in-progress.png b/docs/en/2509/figures/migration-in-progress.png new file mode 100644 index 0000000000000000000000000000000000000000..e5bae64aaa303a6e7950ec0fdeb46a66bfaa70a3 Binary files /dev/null and b/docs/en/2509/figures/migration-in-progress.png differ diff --git a/docs/en/2509/figures/migration-start.png b/docs/en/2509/figures/migration-start.png new file mode 100644 index 0000000000000000000000000000000000000000..d8a2b58cd5ce8e559bd82c14400e16b4635d0ec3 Binary files /dev/null and b/docs/en/2509/figures/migration-start.png differ diff --git a/docs/en/2509/figures/migration-tools-conf.png b/docs/en/2509/figures/migration-tools-conf.png new file mode 100644 index 0000000000000000000000000000000000000000..80520c44a86172c9f18e3d50930e0fcc25f411bb Binary files /dev/null and b/docs/en/2509/figures/migration-tools-conf.png differ diff --git a/docs/en/2509/figures/openeuler-migration-complete.png b/docs/en/2509/figures/openeuler-migration-complete.png new file mode 100644 index 0000000000000000000000000000000000000000..20c5a4afaf2b06fae865137b9d4efd53326a9611 Binary files /dev/null and b/docs/en/2509/figures/openeuler-migration-complete.png differ diff --git a/docs/en/2509/figures/prompt.png b/docs/en/2509/figures/prompt.png new file mode 100644 index 0000000000000000000000000000000000000000..224a79aece026a4fa2b003753f40fc0f1ebd4d0d Binary files /dev/null and b/docs/en/2509/figures/prompt.png differ diff --git a/docs/en/2509/figures/repo.png b/docs/en/2509/figures/repo.png new file mode 100644 index 0000000000000000000000000000000000000000..78437bbc839bff8906b535989bbac0c38a6263b7 Binary files /dev/null and b/docs/en/2509/figures/repo.png differ diff --git a/docs/en/2509/figures/user-check.png b/docs/en/2509/figures/user-check.png new file mode 100644 index 0000000000000000000000000000000000000000..8ec0b5518f37532eedb5897bc368d9b58a1ccafc Binary files /dev/null and b/docs/en/2509/figures/user-check.png differ diff --git a/docs/en/2509/migration_tools_user_guide.md b/docs/en/2509/migration_tools_user_guide.md new file mode 100644 index 0000000000000000000000000000000000000000..819845fe31eb071accbf7babc2c468de22f7644d --- /dev/null +++ b/docs/en/2509/migration_tools_user_guide.md @@ -0,0 +1,245 @@ +# 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. + +| Source System | Target System | Software Repository | +| ----------------- | ----------------------- | ------------------------------- | +| CentOS 7.4 CUI | openEuler 20.03 LTS SP1 | openEuler public repository | +| CentOS 7.0 to 7.7 | UOS 1002a | UOS 1002a (complete repository) | +| CentOS 8.0 to 8.2 | UOS 1050a | UOS 1050a (complete repository) | + +### 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 + ``` + + ![Configuration File](./figures/migration-tools-conf.png) + +- 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. + + ![openEuler Migration Complete](./figures/openeuler-migration-complete.png) + +#### 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 + ``` + + ![Configuration File](./figures/migration-tools-conf.png) + +- 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`. + + ![Home Page](./figures/home-page.png) + +- Click "I have read and agree to this agreement," then proceed by clicking "Next." + ![License Agreement](./figures/license.png) + +- Review the migration prompt page and click "Next." + ![Prompt](./figures/prompt.png) + +- 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. + +![Environment Check](./figures/environment-check.png) + +- 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. + + ![User Check](./figures/user-check.png) + +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. + +![Repo](./figures/repo.png) + +- 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." + + ![Kernel](./figures/kernel.png) + +- 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. + + ![Migration Check](./figures/migration-check.png) + +- 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. + + ![Migration Confirmation](./figures/migration-confirmation.png) + +- After clicking "Confirm," the system migration page will appear. + + ![Migration Start](./figures/migration-start.png) + +- Click "View Details" to monitor the migration progress. + + ![Migration in Progress](./figures/migration-in-progress.png) + +- 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. + + ![Migration Complete](./figures/migration-complete.png) + +- 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. + +``` shell +uosinfo +``` + +If the output matches the expected information below, the migration is successful. + +1002a: + +``` shell +################################################# +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: + +``` shell +################################################# +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 +################################################# +``` diff --git a/docs/zh/2509/_toc.yaml b/docs/zh/2509/_toc.yaml new file mode 100644 index 0000000000000000000000000000000000000000..b7fdcbd76a2e144c6330e8ecb787df0b62851ed6 --- /dev/null +++ b/docs/zh/2509/_toc.yaml @@ -0,0 +1,6 @@ +label: Migration-tools用户指南 +isManual: true +description: 从原系统（centos7、centos8）迁移到统信服务器操作系统 +sections: + - label: Migration-tools用户指南 + href: ./migration_tools_user_guide.md diff --git a/docs/zh/2509/figures/kernel.png b/docs/zh/2509/figures/kernel.png new file mode 100644 index 0000000000000000000000000000000000000000..ecd5bbb3cf306e46da3448de46c4f9fc2e03eed2 Binary files /dev/null and b/docs/zh/2509/figures/kernel.png differ diff --git a/docs/zh/2509/figures/migration-tools-conf.png b/docs/zh/2509/figures/migration-tools-conf.png new file mode 100644 index 0000000000000000000000000000000000000000..80520c44a86172c9f18e3d50930e0fcc25f411bb Binary files /dev/null and b/docs/zh/2509/figures/migration-tools-conf.png differ diff --git a/docs/zh/2509/figures/openeuler-migration-complete.png b/docs/zh/2509/figures/openeuler-migration-complete.png new file mode 100644 index 0000000000000000000000000000000000000000..20c5a4afaf2b06fae865137b9d4efd53326a9611 Binary files /dev/null and b/docs/zh/2509/figures/openeuler-migration-complete.png differ diff --git a/docs/zh/2509/figures/repo.png b/docs/zh/2509/figures/repo.png new file mode 100644 index 0000000000000000000000000000000000000000..78437bbc839bff8906b535989bbac0c38a6263b7 Binary files /dev/null and b/docs/zh/2509/figures/repo.png differ diff --git "a/docs/zh/2509/figures/\346\217\220\347\244\272.png" "b/docs/zh/2509/figures/\346\217\220\347\244\272.png" new file mode 100644 index 0000000000000000000000000000000000000000..224a79aece026a4fa2b003753f40fc0f1ebd4d0d Binary files /dev/null and "b/docs/zh/2509/figures/\346\217\220\347\244\272.png" differ diff --git "a/docs/zh/2509/figures/\347\216\257\345\242\203\346\243\200\346\265\213.png" "b/docs/zh/2509/figures/\347\216\257\345\242\203\346\243\200\346\265\213.png" new file mode 100644 index 0000000000000000000000000000000000000000..b03c4da5ba24e345a3614cd2c7d7e3b52983ad1a Binary files /dev/null and "b/docs/zh/2509/figures/\347\216\257\345\242\203\346\243\200\346\265\213.png" differ diff --git "a/docs/zh/2509/figures/\347\224\250\346\210\267\346\243\200\346\265\213.png" "b/docs/zh/2509/figures/\347\224\250\346\210\267\346\243\200\346\265\213.png" new file mode 100644 index 0000000000000000000000000000000000000000..8ec0b5518f37532eedb5897bc368d9b58a1ccafc Binary files /dev/null and "b/docs/zh/2509/figures/\347\224\250\346\210\267\346\243\200\346\265\213.png" differ diff --git "a/docs/zh/2509/figures/\350\256\270\345\217\257\345\215\217\350\256\256.png" "b/docs/zh/2509/figures/\350\256\270\345\217\257\345\215\217\350\256\256.png" new file mode 100644 index 0000000000000000000000000000000000000000..41eb3b6aa755619b94965f8060a27c1940e6936e Binary files /dev/null and "b/docs/zh/2509/figures/\350\256\270\345\217\257\345\215\217\350\256\256.png" differ diff --git "a/docs/zh/2509/figures/\350\277\201\347\247\273\344\270\255.png" "b/docs/zh/2509/figures/\350\277\201\347\247\273\344\270\255.png" new file mode 100644 index 0000000000000000000000000000000000000000..e5bae64aaa303a6e7950ec0fdeb46a66bfaa70a3 Binary files /dev/null and "b/docs/zh/2509/figures/\350\277\201\347\247\273\344\270\255.png" differ diff --git "a/docs/zh/2509/figures/\350\277\201\347\247\273\345\256\214\346\210\220.png" "b/docs/zh/2509/figures/\350\277\201\347\247\273\345\256\214\346\210\220.png" new file mode 100644 index 0000000000000000000000000000000000000000..c832bb723ea5400aa2fe1f932f1f5dcb5a3d5065 Binary files /dev/null and "b/docs/zh/2509/figures/\350\277\201\347\247\273\345\256\214\346\210\220.png" differ diff --git "a/docs/zh/2509/figures/\350\277\201\347\247\273\345\274\200\345\247\213.png" "b/docs/zh/2509/figures/\350\277\201\347\247\273\345\274\200\345\247\213.png" new file mode 100644 index 0000000000000000000000000000000000000000..d8a2b58cd5ce8e559bd82c14400e16b4635d0ec3 Binary files /dev/null and "b/docs/zh/2509/figures/\350\277\201\347\247\273\345\274\200\345\247\213.png" differ diff --git "a/docs/zh/2509/figures/\350\277\201\347\247\273\346\243\200\346\237\245.png" "b/docs/zh/2509/figures/\350\277\201\347\247\273\346\243\200\346\237\245.png" new file mode 100644 index 0000000000000000000000000000000000000000..776e9cafdf7e569cd33e1abd47217aa47c86f134 Binary files /dev/null and "b/docs/zh/2509/figures/\350\277\201\347\247\273\346\243\200\346\237\245.png" differ diff --git "a/docs/zh/2509/figures/\350\277\201\347\247\273\347\241\256\350\256\244.png" "b/docs/zh/2509/figures/\350\277\201\347\247\273\347\241\256\350\256\244.png" new file mode 100644 index 0000000000000000000000000000000000000000..69567eabd886befe43fb8a512e7b6cde87fd0937 Binary files /dev/null and "b/docs/zh/2509/figures/\350\277\201\347\247\273\347\241\256\350\256\244.png" differ diff --git "a/docs/zh/2509/figures/\351\205\215\347\275\256\346\226\207\344\273\266.png" "b/docs/zh/2509/figures/\351\205\215\347\275\256\346\226\207\344\273\266.png" new file mode 100644 index 0000000000000000000000000000000000000000..aed6ce1cf37b1aad8d7bb037a422c726bb024d86 Binary files /dev/null and "b/docs/zh/2509/figures/\351\205\215\347\275\256\346\226\207\344\273\266.png" differ diff --git "a/docs/zh/2509/figures/\351\246\226\351\241\265.png" "b/docs/zh/2509/figures/\351\246\226\351\241\265.png" new file mode 100644 index 0000000000000000000000000000000000000000..2fb66ae7dc8336d6e38437ba79175fe1c2207a5d Binary files /dev/null and "b/docs/zh/2509/figures/\351\246\226\351\241\265.png" differ diff --git a/docs/zh/2509/migration_tools_user_guide.md b/docs/zh/2509/migration_tools_user_guide.md new file mode 100644 index 0000000000000000000000000000000000000000..b4be55c8305368dd90ab6df7aaefd3605376bd7a --- /dev/null +++ b/docs/zh/2509/migration_tools_user_guide.md @@ -0,0 +1,250 @@ +# 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 包的原系统进行迁移，如果对这种原系统进行迁移会出现迁移失败的结果。 + +|原系统|目标系统|使用的软件源| +|---|---|---| +|centos 7.4 cui|openeuler 20.03-LTS-SP1|使用openeuler外网源| +|centos 7.0~7.7|UOS 1002a|UOS 1002a（全量源）| +|centos 8.0~8.2|UOS 1050a|UOS 1050a（全量源）| + +### 使用方法 + +#### 安装与配置 + +##### 安装 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 + ``` + + ![配置文件](./figures/migration-tools-conf.png) + +- 重启 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 + ``` + +- 迁移完成后系统会自动重启，重启完成后即迁移完成。 + + ![openeuler迁移完成](./figures/openeuler-migration-complete.png) + +#### 迁移 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 + ``` + + ![配置文件](./figures/migration-tools-conf.png) + +- 重启 migration-tools-agent 服务。 + + ``` shell + systemctl restart migration-tools-agent + ``` + +##### UOS系统迁移步骤 + +- 登录web端 + + 在 server 端和 agent 端服务均启动后，打开浏览器（建议使用：Chrome），在浏览器导航栏中输入`https://SERVER_IP:9999`即可。 + + ![首页](./figures/首页.png) + +- 点击“我已阅读并同意此协议”，然后点击“下一步”。 + + ![许可协议](./figures/许可协议.png) + +- 迁移提示页面内容如下，点击“下一步”。 + + ![提示](./figures/提示.png) + +- 环境检测页面会检查系统版本和系统剩余空间大小，在检测完成后点击“下一步”。 + +>**注意:** 如果出现检测长时间无反应，请检查 agent 防火墙是否关闭，server与agent 服务是否开启。 +> 如需重新检测，在浏览器中刷新即可。 + + ![环境检测](./figures/环境检测.png) + +- 用户检测页面会检查用户名以及密码，推荐使用 root 用户，点击“下一步”开始检测，检测完成后自动进入 repo 源配置页面。 + + ![用户检测](./figures/用户检测.png) + +repo 源配置页面： + +- 请根据要迁移的系统输入对应的repo源。 + + centos7:1002a，centos8:1050a + +- 确保使用的软件源为全量源，否则迁移会失败。 + +- 输入栏中只需输入1个软件仓库路径即可。 + +![repo](./figures/repo.png) + +- 输入完成后点击“下一步”，等待软件源连通性检测完毕后，进入 kernel 版本选择页面，选择 4.19 内核，点击“下一步”。 + + ![kernel](./figures/kernel.png) + +- 迁移环境检查界面可以对比迁移前后的软件包差异，并输出检测报告，检查完成后可以导出检测报告。 + + > **注意：** 检测时间大约为1个小时，请耐心等待。 + + ![迁移检查](./figures/迁移检查.png) + +- 检测完成后，点击“下一步”会弹出系统迁移“确认”窗口，请确保系统已做好备份，准备完成后点击确认开始系统迁移。 + + ![迁移确认](./figures/迁移确认.png) + +- 点击“确认”后，进入系统迁移页面。 + + ![迁移开始](./figures/迁移开始.png) + +- 可以点击“查看详情”，来查看迁移情况。 + + ![迁移中](./figures/迁移中.png) + +- 迁移完成后，页面会跳转至迁移完成页面，可在该页面导出迁移分析报告及迁移日志。 + +- 导出后，可在 server 端 /var/tmp/uos-migration/ 目录下找到报告和日志的压缩包，解压后即可查看。 + + ![迁移完成](./figures/迁移完成.png) + +- 迁移完成后，需手动重启 agent 机器，并验证是否迁移完成。 + +###### 验证步骤 + +执行以下命令，检查操作系统版本是否已迁移至目标操作系统。 + +``` shell +uosinfo +``` + +如显示以下信息表示迁移成功。 + +1002a: + +``` shell +################################################# +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: + +``` shell +################################################# +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 +################################################# +```