# migration-tools

**Repository Path**: openeuler/migration-tools

## Basic Information

- **Project Name**: migration-tools
- **Description**: tools for migrating systems
- **Primary Language**: Unknown
- **License**: MulanPubL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 7
- **Forks**: 19
- **Created**: 2023-04-13
- **Last Updated**: 2025-01-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: sig-Migration

## README

# migration-tools

## 介绍

本文主要介绍服务器迁移软件(以下简称“migration-tools”）的使用方法，帮助用户顺利从原系统(centos7、centos8)迁移到OpenEuler操作系统和统信服务器操作系统。
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
```

- 在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
```

- 在agent端新增repo文件

``` shell
vi /etc/yum.repos.d/migration-tools.repo
[migration]
name=migration
baseurl=http://10.12.23.109/requires/$basearch
enabled=1
gpgcheck=0
```

![迁移repo](./figures/euler-repo.png)

- 安装agent软件包

``` shell
yum install migration-tools-agent -y
```

- server端分发migration-tools配置文件

``` shell
scp /etc/migration-tools/migration-tools.conf root@xx.xx.xx.xx:/etc/migration-tools/
```

- 关闭防火墙

``` shell
systemctl stop firewalld
```

启动agent端服务

``` shell
systemctl restart migration-tools-agent
```

#### 迁移openeuler系统

**注意:** openeuler系统仅支持centos7系列 cui迁移

- 登录web端
在server端和agent端服务均启动后，打开浏览器（建议使用：Chrome），在浏览器导航栏中输入`https://SERVER_IP:9999`即可。
![首页](./figures/首页.png)

- 点击“我已阅读并同意此协议”，然后点击下一步
![许可协议](./figures/许可协议.png)

- 迁移提示页面内容如下，点击下一步
![提示](./figures/提示.png)

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

>**注意:** 如果出现检测长时间无反应，请检查agent防火墙是否关闭，server与agent服务是否开启。
> 如需重新检测，在浏览器中刷新即可。
![环境检测](./figures/环境检测.png)

- 在目标系统中选择euler系统，点击下一步开始迁移
![用户检测](./figures/用户检测和目标系统.png)

- euler系统迁移中
![openeuler迁移中](./figures/euler-migration.png)

- 迁移完成后系统会自动重启，重启完成后即迁移完成
![openeuler迁移完成](./figures/openeuler-migration-complete.png)

- 迁移完成后页面会跳转至迁移完成页面(openeuler系统暂时不支持迁移后的日志和报告导出功能)
![迁移完成](./figures/迁移完成.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用户，默认为迁移uos，如想迁移euler，目标系统选择euler即可，点击下一步开始检测，检测完成后自动进入repo源配置页面，如果目标系统选择euler，点击下一步直接进入迁移环节。
![用户检测](./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机器，并验证是否迁移完成

###### 验证步骤

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

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