x2openEuler 辅助机完整部署教程

一、背景认知

1.1 什么是 x2openEuler 辅助机

x2openEuler 是 openEuler 社区官方推出的操作系统迁移工具 ，专门用于将 CentOS 7.x、BCLinux 7.x、RHEL 7.x 等系统原地升级到 openEuler LTS 版本。

辅助机 是独立于所有待迁移节点的控制服务器 / 虚拟机，它只负责：

安装并运行 x2openEuler 迁移套件（含 Web 管理界面）
批量扫描待迁移节点的软件、硬件、配置兼容性
生成个性化迁移方案
远程执行批量原地升级任务
统一监控迁移进度与日志

绝对禁止：将辅助机安装在任何需要被升级的目标机器上！否则会导致升级失败、系统崩溃。

1.2 为什么必须用辅助机

隔离风险：迁移过程中辅助机不会被修改，即使待迁移节点失败，控制端仍可正常工作
批量管理：一台辅助机可同时管理数百台待迁移节点
离线支持：可配置本地离线源，适配无互联网的企业内网环境
统一日志：所有迁移任务的日志集中存储在辅助机，便于排查问题

1.3 支持的迁移矩阵（最新 3.0.0 版本）

源操作系统	目标 openEuler 版本
CentOS 7.0-7.9	20.03 LTS SP10、22.03 LTS SP3、24.03 LTS SP3
BCLinux 7.6-7.9	同上
RHEL 7.0-7.9	同上
openEuler 20.03 LTS	22.03 LTS SP3、24.03 LTS SP3

二、核心配置要求

2.1 硬件配置

配置项	最小要求	推荐配置（管理≤50 台节点）	生产配置（管理≤200 台节点）
CPU	2 核	4 核	8 核
内存	1.6GB	4GB	8GB
磁盘	50GB（系统盘）	100GB（系统盘）+ 200GB（数据盘）	100GB（系统盘）+ 500GB（数据盘）
网卡	1 块千兆网卡	1 块千兆网卡	2 块千兆网卡（业务 + 管理分离）

2.2 操作系统要求

仅支持以下 64 位系统，必须是干净的最小化安装版本：

CentOS 7.6-7.9 x86_64/aarch64
BCLinux 7.6-7.9 x86_64/aarch64
openEuler 20.03 LTS SP10 x86_64/aarch64
openEuler 22.03 LTS SP3 x86_64/aarch64
openEuler 24.03 LTS SP3 x86_64/aarch64

强烈推荐：使用 openEuler 22.03 LTS SP3 作为辅助机系统，兼容性最好。

2.3 网络要求

辅助机与所有待迁移节点网络互通
辅助机需开放以下端口：
- TCP 80：HTTP 访问 Web 界面
- TCP 443：HTTPS 访问 Web 界面
- TCP 22：SSH 远程管理
待迁移节点需开放 TCP 22 端口，允许辅助机通过 SSH 访问
若需在线迁移，辅助机需能访问互联网（下载 openEuler 软件包）

2.4 安全要求

必须使用root 用户执行所有安装和操作命令
安装前临时关闭 SELinux 和防火墙（安装完成后可重新配置规则）
待迁移节点需配置 root 用户 SSH 登录权限

三、基础实操（完整步骤）

3.1 准备干净的操作系统

安装上述支持的操作系统，选择最小化安装模式
安装完成后，以 root 用户登录系统

3.2 系统初始化配置

步骤 1：关闭 SELinux

复制代码

# 临时关闭SELinux
setenforce 0

# 永久关闭SELinux
sed -i 's/^SELINUX=.*/SELINUX=disabled/' /etc/selinux/config

# 验证SELinux状态
getenforce
# 输出应为 Permissive 或 Disabled

步骤 2：关闭防火墙

复制代码

# 停止防火墙服务
systemctl stop firewalld

# 禁止防火墙开机自启
systemctl disable firewalld

# 验证防火墙状态
systemctl status firewalld
# 输出应为 inactive (dead)

步骤 3：配置主机名

复制代码

# 设置主机名（可自定义）
hostnamectl set-hostname x2openeuler-helper

# 配置hosts文件
echo "127.0.0.1   x2openeuler-helper" >> /etc/hosts

# 验证主机名
hostname
# 输出应为 x2openeuler-helper

步骤 4：配置 DNS

复制代码

# 编辑DNS配置文件
vi /etc/resolv.conf

# 添加以下内容（可替换为企业内部DNS）
nameserver 8.8.8.8
nameserver 114.114.114.114

# 保存退出（按Esc，输入:wq，回车）

步骤 5：更新系统

复制代码

# 更新所有软件包
yum update -y

# 安装必要的依赖包
yum install -y wget tar unzip vim net-tools

3.3 下载并安装 x2openEuler

步骤 1：下载最新安装包

截至 2026 年 4 月，最新稳定版为3.0.0-20240930

复制代码

# 创建安装目录
mkdir -p /opt/x2openeuler
cd /opt/x2openeuler

# 下载x86_64版本安装包
wget https://repo.openeuler.org/x2openEuler/3.0.0-20240930/x86_64/x2openEuler-3.0.0-20240930-x86_64.tar.gz

# 若为aarch64架构，下载此包
# wget https://repo.openeuler.org/x2openEuler/3.0.0-20240930/aarch64/x2openEuler-3.0.0-20240930-aarch64.tar.gz

步骤 2：解压安装包

复制代码

tar -zxvf x2openEuler-3.0.0-20240930-x86_64.tar.gz

步骤 3：执行安装脚本

复制代码

cd x2openEuler-3.0.0-20240930-x86_64

# 执行安装脚本
./install.sh

步骤 4：等待安装完成

安装过程会自动下载并安装所有依赖包，大约需要 5-10 分钟（取决于网络速度）。

安装成功后，会显示以下信息：

复制代码

x2openEuler installed successfully!
Web UI: http://<辅助机IP>
Default username: admin
Default password: Admin@123

3.4 验证安装并登录 Web 界面

步骤 1：检查服务状态

复制代码

# 检查所有x2openEuler服务状态
systemctl status x2openeuler-*

# 所有服务应显示为 active (running)

步骤 2：访问 Web 界面

打开浏览器，输入辅助机的 IP 地址：http://<辅助机IP>
输入默认用户名：admin，默认密码：Admin@123
首次登录会强制要求修改密码，按照要求设置新密码（至少 8 位，包含大小写字母、数字和特殊字符）

3.5 添加第一个待迁移节点

步骤 1：配置待迁移节点 SSH 免密登录

复制代码

# 在辅助机上生成SSH密钥对
ssh-keygen -t rsa -b 4096
# 连续按3次回车，使用默认配置

# 将公钥复制到待迁移节点
ssh-copy-id root@<待迁移节点IP>
# 输入待迁移节点的root密码

步骤 2：在 Web 界面添加节点

登录 x2openEuler Web 界面
点击左侧菜单栏「节点管理」→「添加节点」
选择「单个添加」
填写节点信息：
- 节点 IP：<待迁移节点 IP>
- SSH 端口：22
- 认证方式：密钥认证
- 用户名：root
点击「测试连接」，显示「连接成功」后，点击「添加」

步骤 3：执行兼容性检查

在节点列表中，勾选刚添加的节点
点击「兼容性检查」
选择检查类型：「全面检查」
点击「开始检查」
等待检查完成，查看检查报告，解决所有高风险问题后再进行迁移

四、高阶用法

4.1 批量添加待迁移节点

准备节点信息 CSV 文件，格式如下：

IP地址,SSH端口,用户名,密码
192.168.1.101,22,root,Password123!
192.168.1.102,22,root,Password123!
192.168.1.103,22,root,Password123!
登录 Web 界面，点击「节点管理」→「添加节点」→「批量添加」
上传 CSV 文件，点击「导入」
系统会自动测试所有节点的连接，导入成功后即可批量管理

4.2 配置离线迁移源

适用于无互联网的企业内网环境：

在有互联网的机器上下载离线迁移源

下载openEuler 24.03 LTS SP3 x86_64离线源

wget https://repo.openeuler.org/x2openEuler/3.0.0-20240930/repo/openEuler-24.03-LTS-SP3-x86_64-repo.tar.gz
将离线源文件上传到辅助机的/opt/x2openeuler/repo目录
解压离线源

cd /opt/x2openeuler/repo
tar -zxvf openEuler-24.03-LTS-SP3-x86_64-repo.tar.gz
登录 Web 界面，点击「系统管理」→「迁移源管理」→「添加迁移源」
选择「本地源」，填写源名称和路径，点击「添加」

4.3 备份与恢复辅助机数据

备份数据

复制代码

# 停止所有x2openEuler服务
systemctl stop x2openeuler-*

# 备份数据目录
tar -zcvf /opt/x2openeuler-backup-$(date +%Y%m%d).tar.gz /opt/x2openeuler

# 启动所有服务
systemctl start x2openeuler-*

恢复数据

复制代码

# 停止所有x2openEuler服务
systemctl stop x2openeuler-*

# 恢复数据
rm -rf /opt/x2openeuler
tar -zxvf /opt/x2openeuler-backup-xxxxxx.tar.gz -C /

# 启动所有服务
systemctl start x2openeuler-*

4.4 升级 x2openEuler 工具

下载最新版本的安装包
执行升级脚本

./upgrade.sh
升级完成后，重启所有服务

systemctl restart x2openeuler-*

4.5 多用户管理

登录 Web 界面，点击「系统管理」→「用户管理」→「添加用户」
填写用户信息，分配角色（管理员 / 操作员 / 查看者）
点击「添加」，新用户即可使用自己的账号登录

五、拓展建议

5.1 最佳实践

资源规划：每管理 50 台节点，增加 2 核 CPU 和 4GB 内存
网络隔离：将辅助机和待迁移节点放在同一个 VLAN，避免网络延迟影响迁移
数据备份：迁移前必须备份待迁移节点的所有重要数据
测试迁移：先在测试环境进行完整的迁移测试，验证所有业务正常后再迁移生产环境
分批迁移：生产环境建议分批迁移，每次迁移不超过 10 台节点

5.2 常见问题排查

无法访问 Web 界面：检查防火墙是否关闭、x2openEuler 服务是否正常运行
无法添加节点：检查待迁移节点的 22 端口是否开放、SSH 免密登录是否配置正确
兼容性检查失败：根据检查报告解决高风险问题，如卸载不兼容的软件、修改配置文件
迁移失败 ：查看辅助机上的迁移日志（路径：/opt/x2openeuler/logs），根据日志信息排查问题

5.3 官方支持渠道

官方文档：https://docs.openeuler.org/zh/docs/24.03_LTS_SP3/docs/migration/migration.html
社区论坛：https://forum.openeuler.org/c/x2openeuler/
代码仓库：https://gitee.com/openeuler/x2openEuler

x2openEuler 辅助机完整部署教程

一、背景认知

1.1 什么是 x2openEuler 辅助机

1.2 为什么必须用辅助机

1.3 支持的迁移矩阵（最新 3.0.0 版本）

二、核心配置要求

2.1 硬件配置

2.2 操作系统要求

2.3 网络要求

2.4 安全要求

三、基础实操（完整步骤）

3.1 准备干净的操作系统

3.2 系统初始化配置

步骤 1：关闭 SELinux

步骤 2：关闭防火墙

步骤 3：配置主机名

步骤 4：配置 DNS

步骤 5：更新系统

3.3 下载并安装 x2openEuler

步骤 1：下载最新安装包

步骤 2：解压安装包

步骤 3：执行安装脚本

步骤 4：等待安装完成

3.4 验证安装并登录 Web 界面

步骤 1：检查服务状态

步骤 2：访问 Web 界面

3.5 添加第一个待迁移节点

步骤 1：配置待迁移节点 SSH 免密登录

步骤 2：在 Web 界面添加节点

步骤 3：执行兼容性检查

四、高阶用法

4.1 批量添加待迁移节点

4.2 配置离线迁移源

下载openEuler 24.03 LTS SP3 x86_64离线源

4.3 备份与恢复辅助机数据

备份数据

恢复数据

4.4 升级 x2openEuler 工具

4.5 多用户管理

五、拓展建议

5.1 最佳实践

5.2 常见问题排查

5.3 官方支持渠道