介绍
前言
概述
本文档介绍了获取 x2openEuler 工具安装包，以及对其进行安装、使用的方法，对 x2openEuler 工具的 web 界面的各项功能做了详细介绍，同时提供了常见的问题解答及故障处理方法，详细请参考对应手册。
读者对象
本文档主要适用于升级的操作人员。操作人员必须具备以下经验和技能：
- 熟悉待升级操作系统相关情况。
- 有服务器维护操作经验。
使用声明
本文档依据 CC BY 4.0 许可证进行授权，使用声明详细内容请访问 openEuler 许可协议 中 “CC-BY-SA-4.0” 页签。
符号约定
在本文中可能出现下列标志，它们所代表的的含义如下。
| 符号 | 说明 |
|---|---|
 | 表示如不避免则将会导致死亡或严重伤害的具有高等级风险的危害。 |
 | 表示如不避免则可能导致死亡或严重伤害的具有中等级风险的危害。 |
 | 表示如不避免则可能导致轻微或中度伤害的具有低等级风险的危害。 |
 | 用于传递设备或环境安全警示信息。如不避免则可能会导致设备损坏、数据丢失、设备性能降低或其他不可预知的结果。 “须知”不涉及人身伤害。 |
 | 对正文中重点信息的补充说明。 “说明”不是安全警示信息，不涉及人身、设备及环境伤害信息。 |
命令行格式约定
| 格式 | 意义 |
|---|---|
| 粗体 | 命令行关键字（命令中保持不变、必须照输的部分）采用加粗字体表示。 |
| 斜体 | 命令行参数（命令中必须由实际值进行替代的部分）采用斜体表示。 |
| [ ] | 表示用 “[ ]” 括起来的部分在命令配置时是可选的。 |
| { x | y | ... } | 表示从两个或多个选项中选取一个。 |
| [ x | y | ... ] | 表示从两个或多个选项中选取一个或者不选。 |
| { x | y | ... }* | 表示从两个或多个选项中选取多个，最少选取一个，最多选取所有选项。 |
| [ x | y | ... ]* | 表示从两个或多个选项中选取多个或者不选。 |
| &<1-n> | 表示符号 “&” 前面的参数可以重复 1～n 次。 |
| # | 表示由 “#” 开始的行为注释行。 |
修订记录
| 文档版本 | 发布日期 | 修改说明 |
|---|---|---|
| 07 | 2024-11-30 | 第七次正式发布 |
| 06 | 2023-06-30 | 第六次正式发布新增软件包评估 |
| 05 | 2023-03-30 | 第五次正式发布 |
| 04 | 2022-12-30 | 第四次正式发布 |
| 03 | 2022-10-30 | 第三次正式发布 |
| 02 | 2022-09-30 | 第二次正式发布 |
| 01 | 2022-08-20 | 第一次正式发布 |
介绍
免责声明
- 建议您在非生产环境使用本工具，避免影响生产业务运行。
- 使用过程中涉及的非工具本身验证功能所用的用户名和密码，不作他用，且不会被保存在系统环境中。
- 在您进行分析或操作前应当确认您为应用程序的所有者或已获得所有者的充足授权同意。
- 分析结果中可能包含您所分析应用的内部信息和相关数据，请妥善管理。
- 除非法律法规或双方合同另有规定，华为公司对分析结果不做任何明示或暗示的声明和保证,不对分析结果的适销性、满意度、非侵权性或特定用途适用性等作出任何保证或者承诺。
- 您根据分析记录所采取的任何行为均应符合法律法规的要求，并由您自行承担风险。
- 未经所有者授权，任何个人或组织均不得使用应用程序及相关分析记录从事任何活动。华为公司不对由此造成的一切后果负责，亦不承担任何法律责任。必要时，将追究其法律责任。
x2openEuler 原地升级工具简介
x2openEuler 工具是一款将源操作系统升级为目标操作系统的搬迁工具套件，工具支持原地升级功能。
当客户运行环境的操作系统生命周期即将 EOS，但依托于业务运行的相关应用软件和产品还未到结束生命周期时，为了保障业务的持续性和安全性，可使用 x2openEuler 工具将源操作系统升级到新的目标操作系统。
x2openEuler 工具提供 web 界面方式进行操作，以供使用者能够在图形化界面便捷的进行升级操作。
同时，为了面向全面的数字化改造，配合产品信息化改造，使用 x2openEuler 工具升级的目标操作系统采用欧拉技术线，对于已有的业务系统完成数字化改造后可实现无缝迁移，保证业务的稳定性和高可用性。
应用场景
升级任务：当用户运行环境操作系统生命周期即将 EOS 时，可使用该工具将本地操作系统升级到新的目标操作系统。
系统信息收集评估任务：系统信息收集评估任务收集待升级节点信息，针对待升级节点进行软件、硬件兼容性评估及软件冲突检查，产生相应评估报告，确认待升级节点是否符合升级要求。
配置迁移任务：帮助用户迁移本地环境上运行的业务相关配置到升级后的目标操作系统，以保证业务正常运行。
软件包评估：对源操作系统升级到目标操作系统的软件包进行评估，确保升级后业务正常运行。
Windows 迁移：帮助用户将 Windows 环境部署的应用迁移至 openEuler 系操作系统，支持应用兼容性扫描、自动化部署等功能。具体操作指南见 Windows 迁移操作指南。
部署方式
单机部署，即将 x2openEuler 工具部署在用户的服务器上，操作系统支持 CentOS 7.6 / openEuler 20.03-LTS-SPx / openEuler 22.03-LTS-SPx / openEuler 24.03-LTS-SPx。
访问和使用
x2openEuler 工具提供命令行或者 web 使用方式，用户在安装完成后选择使用方式。工具的使用方法请参考章节 特性指南。
界面说明
界面分区
x2openEuler 工具首页界面主要由如 图 1 所示的区域组成，各个区域的作用如 图 1 所示。
| 区域 | 名称 | 说明 |
|---|---|---|
| 1 | 任务管理区 | 工具任务管理入口，用户可进行创建、启动、删除任务等操作。 |
| 2 | 当前用户 | 展示当前登录用户，并提供修改密码和用户登出的操作入口。 |
| 3 | 配置 | 提供用户管理，弱口令字典，系统配置，日志，web 服务端证书和回退一致性检查过滤等功能入口。 |
| 4 | 更多 | 提供深色/浅色模式切换，联机帮助、免责声明和 x2openEuler 工具发布信息入口。 |
| 5 | 升级节点状态分布区 | 显示迁移每个阶段和节点总数。 |
| 6 | 案例链接区 | 提供典型案例链接，并为每个功能提供示例代码。 |
图标及按钮说明
x2openEuler 工具中出现的图标/按钮及其说明如 表 2 所示。
表 2 图标/按钮说明
| 类型 | 图标/按钮 | 说明 |
|---|---|---|
| 信息图标 |  | 配置 |
 | 更多 | |
| 标志符号 |  | 用于提示操作警示信息 |
 | 用于提示操作提醒信息 | |
 | 用于提示操作异常信息 | |
| 用户控件图标 |  | 下载：将操作对象保存在本地 |
 | 删除所选条目 | |
 | 展开：展开已折叠的列表项 | |
 | 折叠：折叠已展开的列表项 | |
 | 保存：保存修改 | |
 | 回退：回退到前一步 | |
 | 取消：取消修改 | |
 | 上一个：移动到上一个建议修改处 | |
 | 下一个：移动到下一个建议修改处 | |
 | 排序 | |
 | 建议反馈 | |
 | 条件选择筛选 |
登录 x2openEuler 工具 web 界面
本章节以 Windows 10 操作系统安装的 Chrome 105.0 浏览器为例介绍登录 x2openEuler 工具 web 界面的操作步骤。
浏览器要求
浏览器要求如 表 3 所示。
表 3 浏览器要求
须知：
| 浏览器类型 | 说明 | ||||||
|---|---|---|---|---|---|---|---|
| Google Chrome | Google Chrome 72.0 及以上版本 | ||||||
| Mozilla Firefox | Firefox Browser 89 及以上版本 | ||||||
| Microsoft Edge | Microsoft Edge 79.0 及以上版本 |
操作步骤
- 默认连续 5 次登录失败，系统将对此用户进行锁定，锁定 3 分钟后可以重新登录。
- 默认情况下，系统超时时间为 30 分钟，即在 30 分钟内，如果您未在 webUI 界面执行任何操作，系统将自动登出，此时需输入用户名和密码重新登录 webUI 界面。管理员可在 x2openEuler 工具首页中的
- 为保证系统的安全性，初次登录时，请及时修改初始密码，并定期更新。
- 默认允许 10 个普通用户同时登录使用，管理员用户不受此限制。管理员用户可在x2openEuler工具首页中的
- 单个用户只允许 1 个活跃会话，如果当前用户已经在登录使用，重复登录会挤掉前面的登录。
- 用户首次登录时会弹出免责声明弹窗，用户仔细阅读后，勾选“我已阅读以上内容“，点击“确认“后才能使用本工具，如点击“取消“将会退出工具。
打开本地 PC 机的浏览器，在地址栏输入 https://部署服务器的ip:端口号（例如：https://10.254.206.190:18082），按 “Enter”。
说明：
HTTPS 默认端口为 18082，请确认使用该工具之前 OS 防火墙已开通 18082 端口。在如 图 2 所示的安全告警窗口中选择“继续浏览此网站”。
说明：
登录时可能会弹出“安全告警”界面，您可以选择忽略此告警信息或者下载华为根证书屏蔽该界面，详细步骤请参见 为 x2openEuler Upgrade 工具导入根证书。打开首次登录界面，如 图 3 所示，参数说明如 表 4 所示。
参数 说明 用户名 登录 x2openEuler 工具的用户说明：系统的默认管理员为 x2openEulerAdmin，工具安装完成后首次登录需要设置管理员密码 密码 登录用户的密码。密码需要满足如下复杂度要求： - 密码长度为 8~32 个字符
- 必须包含大写字母、小写字母、数字、特殊字符（`~!@#$%^&*()-_=+\|[{}];:'",<.>/?）中的两种及以上类型的组合
- 密码不能包含空格
- 密码不能是用户名
- 密码不能在 弱口令字典 中
确认密码 再次输入设置的密码 设置管理员密码，单击“确认”。
参数 说明 用户名 登录 x2openEuler 工具的用户说明：系统的默认管理员为 x2openEulerAdmin 密码 登录用户的密码。为了保证安全，用户应定期修改自己的登录密码。 已同意免责声明 工具免责声明。用户需阅读并同意后才能登录工具。 输入用户名和密码，单击“登录“。
首次登录 web 的普通用户，系统会提示修改初始密码。必须修改初始密码，否则无法登录。请按提示修改密码，密码需要满足如下复杂度要求：
密码长度为 8~32 个字符
密码至少包含以下字符中的两种：
- 大写字母：A~Z
- 小写字母：a~z
- 数字：0~9
- 特殊字符：`~!@#$%^&*()-_=+\|[{}];:'",<.>/?
密码不能是用户名。
新密码与旧密码必须不同。
新密码不能是旧密码的逆序。
新密码不能在 弱口令字典 中。
说明：
x2openEuler 工具用户的密码默认有效期为 90 天，建议在密码有效期到达之前设置新密码。若密码已过期，则需要在登录后先进行密码修改操作。成功登录后，显示首页界面，界面右上角将显示登录的用户名。
使用前配置
创建用户
前提条件
已成功登录 x2openEuler 工具。
操作步骤
单击页面右上角
，在下拉菜单中选择“用户管理“，打开用户管理界面。单击“创建“，打开“创建”界面，如 图 5 所示，需配置的参数如 表 6 所示。
参数 说明 用户名 输入新建用户的名称。用户名需要满足如下要求： - 用户名必须以英文字母开头
- 默认长度范围为：6~32
- 可以包含字母、数字、“-” 和 “_”
管理员密码 再次输入设置的密码 新密码 登录用户的密码。密码需要满足如下复杂度要求： - 密码长度为 8~32 个字符
- 必须包含大写字母、小写字母、数字、特殊字符（`~!@#$%^&*()-_=+\|[{}];:'",<.>/?）中的两种及以上类型的组合
- 密码不能包含空格
- 密码不能是用户名
- 密码不能在 弱口令字典 中
确认密码 再次输入设置的密码 参考 表 6 配置新用户后，单击“确认”。
说明：- 创建的普通用户数量没有限制。
- 普通用户支持创建系统升级、系统信息收集评估、系统配置迁移和软件包评估任务；支持查看和下载操作日志；支持查看 web 服务端证书信息；支持查看和搜索弱口令；所有用户都只能查看、下载自己的升级任务相关报告。
系统配置
前提条件
已成功登录 x2openEuler 工具。
操作步骤
单击页面右上角
，在下拉菜单中选择“系统配置“，打开系统配置界面。系统配置界面如 图 6 所示，单击“修改”，对配置项进行修改，需配置的参数如 表 7 所示。
配置项 说明 最大在线普通用户数 表示工具最多同时允许普通用户在线数量，默认为 10，可配置范围 1~20，最大支持同时在线用户数 20。 会话超时时间（min） 表示工具会话超时时间，默认值 30 分钟，可配置范围 1~240 分钟。 Web 服务端证书过期警告阈值（天） 表示服务端证书告警阈值，默认值 90 天，可配置范围 7~180 天。 运行日志级别 日志级别用来表示日志信息的重要程度，默认为 INFO。工具运行日志级别分 DEBUG、INFO、WARNING、ERROR 四级。 - DEBUG：调试级别，记录调试信息，便于开发人员或维护人员定位问题。
- INFO：信息级别，记录服务正常运行的关键信息。
- WARNING：警告级别，记录系统和预期的状态不一致的事件，但这些事件不影响整个系统的运行。
- ERROR：一般错误级别，记录错误事件，但应用可能还能继续运行。
密码有效期（天） 表示用户密码有效期限，默认值 90 天，可配置范围 7~90 天。 选择对应配置项完成修改后，单击“确定”保存修改内容，单击“取消”放弃修改内容。
（可选）配置代理
前提条件
- x2openEuler 工具已部署。
- x2openEuler 工具部署环境需要配置代理。
操作步骤
如果 x2openEuler 工具部署环境需要配置代理，则可参考如下操作步骤进行代理配置。如果无需配置代理，则可跳过该章节。
使用 SSH 工具远程登录 x2openEuler 部署环境，进入 Linux 操作系统命令行界面。
执行以下命令配置 /etc/systemd/system/gunicorn_x2openEuler.service 文件。
vi /etc/systemd/system/gunicorn_x2openEuler.service在 gunicorn_x2openEuler.service 文件中的 [Service] 字段后面增加如下两个环境变量。
Environment="http_proxy=ip:port" Environment="https_proxy=ip:port" 说明：
ip:port 是代理服务器的地址和端口号。按 “ESC”，输入 “:wq”，按 “Enter” 保存并退出。
执行以下命令重启 gunicorn_x2openEuler 服务使配置文件生效。
systemctl restart gunicorn_x2openEuler
