长期支持版本

    社区创新版本

      x2openEuler 特性指南

      通过web界面使用x2openEuler工具

      系统升级

      系统升级特性帮助用户将待升级节点的操作系统升级为目标操作系统,以保障业务的连续性和安全性。

      创建升级任务

      前提条件

      系统升级特性帮助用户将待升级节点的操作系统升级为目标操作系统,以保障业务的连续性和安全性。

      操作步骤

      须知 须知: x2openEuler工具单个升级任务最多支持1000个节点。

      1. 在页面左侧,单击“新建任务”,选择“升级任务”进入“新建升级任务”界面,工具默认会自动生成任务名称,可修改该名称。

      2. 在“新建升级任务”确认“任务名称”后,选择“批量导入”或“添加节点”,并对以下参数进行配置。

        • 批量导入:通过模板表格导入多个节点的节点信息。

          说明 说明: 批量导入节点过程中,工具会对导入的节点信息进行校验,若校验不通过则需按照提示修改导入信息,并重新进行批量导入操作。

          1. 在批量导入界面中,单击“模板表格”获取模板后参考表1填写节点信息。

            图 1 批量导入
            批量导入

          2. 完成节点信息的填写后单击“上传文件”阅读“SSH传输须知”,选择已填写节点信息的批量导入文件进行上传。

            图 2 SSH传输须知
            SSH传输须知

        • 添加节点:添加单个节点的节点节点信息。

          在“添加节点”页面,参考表1输入相应信息后,单击“确定”进行节点添加。

          表 1 节点信息参数说明

          参数说明
          SSH传输须知节点管理使用服务器默认的SSH传输通道,为了保护数据的安全完整,建议使用安全的ssh服务,如使用安全的ssh版本,配置使用安全的加密算法等。
          待升级节点IP待升级节点IP地址。
          说明:
          待升级节点与部署openEuler web工具的环境需要保持可联通状态。
          节点别名待升级节点别名,该别名用于标记该节点用途。
          端口登录待升级节点的SSH协议端口。
          用户名登录待升级节点的用户名。
          认证方式密钥认证:通过私钥文件和私钥文件的密码短语进行认证。
          • 私钥文件:登录待升级节点私钥文件的绝对路径。
          • 密码短语:登录待升级节点私钥文件的密码短语。配置秘钥认证方式请参考配置生成秘钥
          口令认证:通过口令进行认证。
          口令:登录待升级节点的密码口令。
          说明:
          • 若登录用户为普通用户,需要输入root用户口令切换到root用户进行具体操作,由于root用户拥有最高权限,直接使用root用户登录服务器可能会存在安全风险。您可以通过配置禁止root用户SSH登录的选项,来提升系统安全性。具体配置如下:先以普通用户登录服务器,切换至root登录后检查/etc/ssh/sshd_config配置项PermitRootlogin,如果显示no,说明禁止了root用户登录;如果显示yes,则需要将配置项PermitRootlogin设置为no。配置完成后需要重启sshd服务确保配置生效。
          • 配置的节点信息中涉及用户密码输入,请注意定期维护帐户信息,确保环境安全。
          源操作系统版本待升级节点的操作系统,默认为CentOS 7.6,可通过上传操作系统数据库支持包支持更多操作系统。
          目标操作系统版本待升级节点的操作系统,默认为openEuler 20.03-LTS-SP1,可通过上传操作系统数据库支持包支持更多操作系统。
          repo源配置输入已配置的repo源名称或单击右侧“选择”进行选择已配置的待升级节点在升级过程中需要的repo源,可参考配置repo源进行配置。
          业务软件须知:
          • 未填写业务软件则不会生成软件评估报告。不需升级的业务软件(rpm包)优先级高于业务软件(rpm包)。
          • 输入多个软件目录或rpm包名称时,请用英文逗号分隔。
          • 业务软件(rpm包):使用rpm包安装的业务软件,只需填写主软件名称即可,例如安装了docker只需填写docker既可。工具将检查该软件是否存在对应的openEuler版本,存在则自动升级软件。 若不存在,将进行软件兼容性检查,如果该软件兼容openEuler,则保留该业务软件,检查不通过则无法升级节点。
          • 业务软件(目录):使用解压包,源码编译安装的软件,需填写业务软件实际的路径,该路径只能包含业务软件,不能包含其他与业务软件不相关的文件。 工具将检查该软件在openEuler操作系统上的兼容性, 检查通过后即可升级节点并保留原始业务软件,检查不通过则无法升级节点。
          • 不需升级的业务软件(rpm包):使用rpm包安装的业务软件,只需填写主软件名称即可,例如安装了docker只需填写docker即可。 工具将检查该软件在openEuler操作系统上的兼容性,检查通过后即可升级节点并保留原始版本包。 检查不通过则无法升级节点。
          • 升级后新安装软件:使用rpm包安装的业务软件,只需填写主软件名称即可。例如操作系统升级后安装了docker只需填写docker即可。工具将检查该软件在openEuler操作系统上的兼容性,检查通过后即可在升级后安装该软件。检查不通过则无法安装该软件。
          高级配置
          升级方案升级方案名称
          备份目录

          待升级操作系统需要进行备份的目录。

          默认备份目录:/etc,/usr,/boot,/var,/run,/opt/sut/check_result,以及所有rpm包文件,多个备份目录间需要用逗号隔开。

          说明:
          • 升级过程中会自动备份数据。默认备份/usr/run/boot/var/etc目录当中的文件,备份文件将被储存在/.osbak目录下。
          • 只需备份系统运行需要的文件目录,无需备份业务数据,如果业务数据直接存放在默认备份系统目录下, 或者通过挂载方式挂载在默认备份系统目录下,则需要将业务数据目录填写在排除目录一栏。备份目录一般情况无需额外填写。
          备份文件存放位置用于指定节点升级时,备份文件存放的目录,不填写则默认存放在/.osbak。
          排除目录待升级操作系统中不需要备份的目录,多个备份目录间需要用用逗号隔开。
          冲突软件配置升级前检查检测得到的冲突包一起被删除(注意:有些系统依赖的重要软件包不能被删除), 若不填写,则默认使用升级前检查得到的冲突包。
          cmdline配置升级后目标操作系统内核启动项,不填写则和升级前保持一致。
          swap软件包配置部分软件包无法被升级,需要手动替换,如想将A包在升级后替换成B包,则需填写A->B。
          须知:
          1. 前后置脚本上传格式为固定xxx.tar.gz包,xxx是压缩目录名称且解压目录一级必须有“run.sh”文件做为脚本执行入口,工具会根据“run.sh”的返回值来判断脚本是否执行成功。 脚本将在待升级节点上运行,请确保上传脚本无安全风险。
          2. 脚本上传路径默认为“/opt/x2openEuler/scripts-execute/upload/”。
          3. 使用chown -R x2openEuler:x2openEuler xxx.tar.gz修改文件拥有者和群组。
          前置脚本启用该项后,需填写前置脚本路径,前置脚本运行在环境检查后。
          后置脚本(重启前)启用该项后,需填写后置脚本(重启前)路径,该脚本运行在升级完成重启前。
          后置脚本(重启后)启用该项后,需填写后置脚本(重启后)路径,该脚本运行在升级完成重启后。
      3. 此处以添加单个节点进行指纹验证为例,工具对导入的节点信息校验完成后,进入节点指纹验证页面,确认节点指纹无误后,单击“确定”。

        图 3 指纹验证
        指纹验证

      4. 节点添加完成,确认添加节点信息无误后,单击任务名称右侧“确定”,完成升级任务创建。若需要修改或删除相应节点,单击右侧“操作”项下的“修改”或“删除”对节点进行操作。单击右下角“确认”启动升级任务,单击右下角“取消”,取消升级任务。

        说明 说明: 升级任务创建完成后,工具会自动对升级任务中配置的待升级节点进行环境检查,环境检查通过后才能进行后续升级操作。若环境检查失败,请检查并修改节点配置信息。

        图 4 升级任务信息确认
        升级信息确认

      进行节点升级

      前提条件
      • 已登录x2openEuler工具。
      • 已创建升级任务。
      操作步骤
      1. 在登录页面选择需要进行升级的任务,单击右侧“进入任务”,进入任务详情页面。

      2. 单击节点信息右侧的“开始检查”,可对单个节点进行节点信息检查。同时勾选多个节点,单击左上角“批量操作→开始检查”,可对多个节点进行信息检查。

        节点升级过程分为多个阶段,其中任意阶段失败都可能会导致后续升级过程终止。

        说明 说明:

        • 升级过程中在不同的升级阶段结束后可单击右下角“初始化”,使待升级节点回归待测试状态。
        • 导入前后置脚本后,升级任务中会增加“前置脚本执行”和“后置脚本执行”阶段。
        • 若升级过程中需要进行回退,可进行回退一致性配置, 配置内容将不会进行一致性检查。配置之后仅在下一次回退才会生效。

        图 5 初始化节点
        初始化节点

        1. 环境检查

          环境检查用于分析x2openEuler工具与待升级节点的环境连通性,验证repo源是否处于可用状态,若环境检查无法通过,则需参考对应检查项操作建议修改节点配置信息。如需进行自定义环境检查请参考自定义环境检查

          图 6 环境检查页面 环境检查页面

        2. 升级前检查 针对待升级节点进行配置文件升级策略、软件、硬件兼容性评估及软件和服务冲突检查,产生相应评估报告,确认待升级节点是否符合升级要求。若出现兼容性不通过的情况,则需参考评估报告进行软件适配。评估报告参数详细说明请参考表2表3表4表5表6

          图 7 升级前检查 升级前检查

          表 2 升级前检查报告参数说明

          参数说明
          检查项检查项为从源操作系统升级到目标操作系统的服务、相关策略和配置。
          检查结果

          显示检查项是否通过升级前检查。

          • 通过
          • 不通过
          优先级

          显示检查项对升级的影响:

          • 高:可能会导致升级出现中止异常。
          • 中:可能会导致升级过程中出现异常,但不一定会中止升级进程。
          • 低:可能导致升级过程中出现异常,但不会影响升级进程。
          操作针对不通过检查项提供不通过原因和解决方案。

          表 3 配置文件升级策略

          参数说明
          源操作系统软件包及配置显示源操作系统升级过程中涉及的软件包及其相关信息。
          升级策略

          针对源操作系统中升级涉及的软件包的相应策略:

          • 覆盖:升级完成后将覆盖安装该软件包。
          • 保留:升级完成后将继续保留该软件包。
          • 删除:升级完成后移除该软件。

          表 4 业务软件评估报告结果参数说明

          参数说明
          评估结果显示评估软件名称、源操作系统、目标操作系统、系统架构以及评估结果等评估任务信息。
          操作建议依据评估报告中的兼容性结果,提供对应解决方案建议。
          依赖包兼容性

          显示软件安装所需要的直接依赖以及依赖文件在各个系统上对应的rpm包。

          • 若查询到的直接依赖的rpm的名字和版本都一样,会显示 版本未变更
          • 若查询到的直接依赖的rpm的版本不一样,但接口无差异,会显示 版本有变更
          • 若查询到的直接依赖的rpm的包名发生变化,但接口无差异,会显示 包名有变更
          • 若源操作系统查到rpm,目标操作系统没有查到,会显示 缺失
          • 若源操作系统没有查到rpm,目标操作系统有查到,或者所在包有接口变化则会显示, 需要检查
          • 若源操作系统和目标操作系统都没有查到rpm,则会放到 other 里边,并显示 需要检查
          接口兼容性(C/C++)
          • 调用函数名称:表示被评估软件中调用的函数名称。
          • 调用的接口程序:表示被评估软件中被存在差异的外部接口调用的程序。
          • 结果:
            • 已移除:表示缺失的接口。
            • 已变更:表示函数入参,返回值,或者实现有变化
          • 展开的详细信息中:
            • 操作系统:表示迁移评估的系统名称。
            • 函数名:接口表示。
            • 文件名:表示外部接口所在的文件名。
            • 依赖包:表示接口所在的外部so库。
            • 接口差异项:表示外部接口的变化差异,如果是已移除接口,则此项为空。
          接口兼容性(JDK)

          表示扫描Jar包中调用的jdk接口在待迁移的系统上对应满足运行条件的最小jdk上发生的变更。

          • openEuler jdk:openEuler上满足Jar包运行环境的最小jdk版本。
          • 对象构建jdk:扫描jar包对应构建的jdk版本。
          • jar包名:扫描的jar包名称。
          • 方法名:存在接口差异的方法名。
          • 函数调用签名:存在接口差异的方法函数签名。
          • 包名:存在接口差异的方法所在的包(packageName+className)。
          • 差异项:接口差异选项。
          接口兼容性(Java)

          Jar接口差异主要描述了当前jar包接口在待迁移的系统上发生的变更。

          • 调用的jar包:表示当前被调用的jar包名称。
          • 所属的rpm包:表示当前的jar包所属的rpm包。
          • 展开的详细信息中:
            • centos7.6 Methods:表示CentOS 7.6上不兼容的接口名称。
            • package:表示不兼容的接口所属的jar包。
            • class:表示不兼容的接口所属的类。
            • openEuler20.03-LTS-SP1 Change:表示不兼容的接口在openEuler20.03-LTS-SP1上发生的变更,这部分变更描述包含了方法的移除,方法返回参数、方法签名、方法修饰、异常等变更。

          表 5 硬件兼容性评估报告结果参数说明

          参数说明
          评估结果显示评估环境中的系统、基本系统、CPU以及整机兼容性信息。
          板卡在openEuler 20.03 LTS SP1 兼容性清单

          板卡兼容必须满足兼容性清单中参数与已有板卡清单列表中的信息都保持一致才算兼容。若对比字段信息不完全一致,则属于待确认板卡。

          • 芯片厂商ID
          • 设备ID
          • 二级厂商制造ID
          • 二级设备ID
          • 芯片型号
          • 是否在兼容性清单:确认该硬件是否兼容目标操作系统
          • 风险级别:对硬件兼容性影响升级的风险进行等级评估

          表 6 软件冲突检查报告结果参数说明

          参数说明
          软件冲突检查统计显示评估环境升级中存在的冲突信息、源操作系统保留包、升级到目标系统包、升级到openEuler拓展仓库包、源操作系统删除的软件包和目标操作系统额外安装包等相关信息。
          冲突信息描述了源操作系统与升级目标操作系统中存在的软件包冲突信息。
          源操作系统保留包升级至目标操作系统后保留的源操作系统软件包。
          升级到目标系统包升级至目标操作系统后同时升级的软件包信息。
          升级到openEuler拓展仓库包升级至openEuler操作系统后拓展的软件包信息。
          源操作系统删除的软件包升级至目标操作系统后移除的源操作系统软件包。
          目标操作系统额外安装包升级至目标操作系统后额外安装的软件包。
          升级前检查完成后,单击右下角“导出HTML报告”即可导出检查报告。单击“下载环境信息和日志”获取检查过程中收集的环境信息和任务执行日志。若升级前检查未通过,可单击右下角“重试”重新尝试升级检查或单击“剔除节点”清除该节点当前状态,剔除后单击“恢复”可恢复至剔除前状态。
        3. 升级和数据备份

          说明 说明: 升级过程中会自动备份数据。默认备份/usr 、/run、/boot、/var和/etc目录当中的文件,备份文件将被储存在/.osbak目录下。

          环境检查和升级前检查通过后,进入节点升级阶段。升级完成后,单击“重启节点”或手动重启升级节点,确保升级完成。单击“下载环境信息和日志”获取升级过程中收集的环境信息和运行日志。

          图 8 节点升级
          节点升级

          节点重启成功后,单击“开始检查”进入“升级后环境检查”阶段。

        4. 升级后环境检查

          升级后环境检查会对升级后操作系统命令、软件包及服务等进行检查并生成巡检报告,如需自定义巡检项则可参考自定义健康巡检。升级完成后建议清理备份数据,以节约节点空间。如需进行回退操作,则可以选择保留备份数据。

          说明 说明: 升级完成后,需进行业务运行验证,若业务运行正常,即可进行备份数据清理,以释放占用空间。

      3. 升级完成后,参考升级后验证进行升级后环境验证。

        说明 说明: 系统重启之后,SELinux会进行relabel动作,物理机可能耗时较长。relabel动作触发完成后,系统会自动进行重启,此时才真正升级至目标操作系统。

      升级后验证

      前提条件

      升级完成后,需进行以下操作对升级后环境进行验证,确保升级完成。

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

        cat /etc/os-release
        

        如显示以下信息则表示已升级至目标操作系统。

        NAME="openEuler"
        VERSION="20.03 (LTS-SP1)"
        ID="openEuler"
        VERSION_ID="20.03"
        PRETTY_NAME="openEuler 20.03 (LTS-SP1)"
        ANSI_COLOR="0;31"
        
      2. 进行openEuler系统命令验证,能够正常运行即表示已升级至目标操作系统。

      3. (可选)升级完成后,可根据业务需求,执行业务恢复或适配脚本。

      4. 检查业务状态是否运行正常。

      系统信息收集评估

      系统信息收集评估任务收集待升级节点信息,针对待升级节点进行软件、硬件兼容性评估及软件冲突检查,产生相应评估报告,确认待升级节点是否符合升级要求。

      创建系统信息收集评估

      前提条件

      已登录x2openEuler工具。

      操作步骤
      1. 在页面左侧,单击“新建任务”,选择“系统信息收集评估”进入“新建升级任务”界面,工具默认会自动生成任务名称,可修改该名称。

      2. 在“新建系统信息收集评估任务”确认“任务名称”后,选择“批量导入”或“添加节点”,并对以下参数进行配置。

        • 批量导入:通过模板表格导入多个节点的节点信息。

          说明 说明: 批量导入节点过程中,工具会对导入的节点信息进行校验,若校验不通过则需按照提示修改导入信息,并重新进行批量导入操作。

          1. 在批量导入界面中,单击“模板表格”获取模板后参考表7填写节点信息。

            图 9 批量导入
            批量导入

          2. 完成节点信息的填写后单击“上传文件”阅读“SSH传输须知”,选择已填写节点信息的批量导入文件进行上传。

            图 10 SSH传输须知
            SSH传输须知

        • 添加节点:添加单个节点的节点节点信息。 在“添加节点”页面,参考表7输入相应信息后,单击“确定”进行节点添加。 表 7 节点信息参数说明

          参数说明
          SSH传输须知节点管理使用服务器默认的SSH传输通道,为了保护数据的安全完整,建议使用安全的ssh服务,如使用安全的ssh版本,配置使用安全的加密算法等。
          待升级节点IP待升级节点IP地址。
          说明:
          待升级节点与部署openEuler web工具的环境需要保持可联通状态。
          节点别名待升级节点别名,该别名用于标记该节点用途。
          端口登录待升级节点的SSH协议端口。
          用户名登录待升级节点的用户名。
          认证方式密钥认证:通过私钥文件和私钥文件的密码短语进行认证。
          • 私钥文件:登录待升级节点私钥文件的绝对路径。
          • 密码短语:登录待升级节点私钥文件的密码短语。配置秘钥认证方式请参考配置生成秘钥
          口令认证:通过口令进行认证。
          口令:登录待升级节点的密码口令。
          说明:
          • 若登录用户为普通用户,需要输入root用户口令切换到root用户进行具体操作,由于root用户拥有最高权限,直接使用root用户登录服务器可能会存在安全风险。您可以通过配置禁止root用户SSH登录的选项,来提升系统安全性。具体配置如下:先以普通用户登录服务器,切换至root登录后检查/etc/ssh/sshd_config配置项PermitRootlogin,如果显示no,说明禁止了root用户登录;如果显示yes,则需要将配置项PermitRootlogin设置为no。配置完成后需要重启sshd服务确保配置生效。
          • 配置的节点信息中涉及用户密码输入,请注意定期维护帐户信息,确保环境安全。
          源操作系统版本待升级节点的操作系统,默认为CentOS 7.6,可通过上传操作系统数据库支持包支持更多操作系统。
          目标操作系统版本待升级节点的操作系统,默认为openEuler 20.03-LTS-SP1,可通过上传操作系统数据库支持包支持更多操作系统。
          repo源配置输入已配置的repo源名称或单击右侧“选择”进行选择已配置的待升级节点在升级过程中需要的repo源,可参考配置repo源进行配置。
          业务软件须知:
          • 未填写业务软件则不会生成软件评估报告。不需升级的业务软件(rpm包)优先级高于业务软件(rpm包)。
          • 输入多个软件目录或rpm包名称时,请用英文逗号分隔。
          • 业务软件(rpm包):使用rpm包安装的业务软件,只需填写主软件名称即可,例如安装了docker只需填写docker既可。 工具将检查该软件是否存在对应的openEuler版本,存在则自动升级软件。 若不存在,将进行软件兼容性检查,如果该软件兼容openEuler,则保留该业务软件,检查不通过则无法升级节点。
          • 业务软件(目录):使用解压包,源码编译安装的软件,需填写业务软件实际的路径, 该路径只能包含业务软件,不能包含其他与业务软件不相关的文件。 工具将检查该软件在openEuler操作系统上的兼容性, 检查通过后即可升级节点并保留原始业务软件,检查不通过则无法升级节点。
          • 不需升级的业务软件(rpm包):使用rpm包安装的业务软件,只需填写主软件名称即可,例如安装了docker只需填写docker即可。 工具将检查该软件在openEuler操作系统上的兼容性,检查通过后即可升级节点并保留原始版本包。 检查不通过则无法升级节点。
          • 升级后新安装软件:使用rpm包安装的业务软件,只需填写主软件名称即可。例如操作系统升级后安装了docker只需填写docker即可。工具将检查该软件在openEuler操作系统上的兼容性,检查通过后即可在升级后安装该软件。检查不通过则无法安装该软件。
      3. 此处以添加单个节点进行指纹验证为例,工具对导入的节点信息校验完成后,进入 节点指纹验证页面,确认节点指纹无误后,单击“确定”。

        图 11 指纹验证
        指纹验证

      4. 节点添加完成,确认添加节点信息无误后,单击任务名称右侧“确定”,完成系统信息收集评估任务创建。若需要修改或删除相应节点,单击右侧“操作”项下的“修改”或“删除”对节点进行操作。单击右下角“确认”启动升级任务,单击右下角“取消”,取消任务。

        说明 说明: 任务创建完成后,工具会自动对系统信息收集评估任务中配置的待升级节点进行环境检查,环境检查通过后才能进行后续收集分析任务。若环境检查失败,请检查并修改节点配置信息。

        图 12 系统信息收集评估任务创建信息确认
        系统信息手机评估任务创建信息确认

      进行系统信息收集评估

      前提条件

      已创建系统信息收集评估任务。

      操作步骤
      1. 在登录页面选择系统信息收集评估任务,单击右侧“进入任务”,进入任务详情页。

      2. 单击节点信息右侧的“开始检查”,可对单个节点进行环境检查。同时勾选多个节点,单击左上角“批量操作➡开始检查”,可对多个节点进行环境检查。

        节点信息收集评估任务分为2个阶段,其中任意阶段失败都会导致任务终止。

        说明 说明:

        • 升级过程中在不同的升级阶段结束后可单击右下角“初始化”,使待升级节点回归待测试状态。
        • 导入前后置脚本后,升级任务中会增加“前置脚本执行”和“后置脚本执行”阶段。
        • 若升级过程中需要进行回退,可进行回退一致性配置, 配置内容将不会进行一致性检查。配置之后仅在下一次回退才会生效。

        图 13 初始化节点 初始化节点

        1. 环境检查

          环境检查用于分析x2openEuler工具与待升级节点的连通性,验证环境信息是否正常,若环境检查无法通过,则需修改节点配置信息。

          图 11 环境检查页面
          环境检查页面

        2. 收集与评估

          针对待升级节点进行软件、硬件兼容性评估及软件冲突检查,产生相应评估报告,确认待升级节点是否符合升级要求。若出现兼容性不通过的情况,则需参考评估报告进行软件适配。评估报告参数详细说明请参考表8表9表10

          图 12 收集与评估
          收集与评估

          表 8 业务软件评估报告结果参数说明

          参数说明
          评估结果显示评估软件名称、源操作系统、目标操作系统、系统架构以及评估结果等评估任务信息。
          操作建议依据评估报告中的兼容性结果,提供对应解决方案建议。
          依赖包兼容性

          显示软件安装所需要的直接依赖以及依赖文件在各个系统上对应的rpm包。

          • 若查询到的直接依赖的rpm的名字和版本都一样,会显示 版本未变更
          • 若查询到的直接依赖的rpm的版本不一样,但接口无差异,会显示 版本有变更
          • 若查询到的直接依赖的rpm的包名发生变化,但接口无差异,会显示 包名有变更
          • 若源操作系统查到rpm,目标操作系统没有查到,会显示 缺失
          • 若源操作系统没有查到rpm,目标操作系统有查到,或者所在包有接口变化则会显示, 需要检查
          • 若源操作系统和目标操作系统都没有查到rpm,则会放到 other 里边,并显示 需要检查
          接口兼容性(C/C++)
          • 调用函数名称:表示被评估软件中调用的函数名称。
          • 调用的接口程序:表示被评估软件中被存在差异的外部接口调用的程序。
          • 结果:
            • 已移除:表示缺失的接口。
            • 已变更:表示函数入参,返回值,或者实现有变化
          • 展开的详细信息中:
            • 操作系统:表示迁移评估的系统名称。
            • 函数名:接口表示。
            • 文件名:表示外部接口所在的文件名。
            • 依赖包:表示接口所在的外部so库。
            • 接口差异项:表示外部接口的变化差异,如果是已移除接口,则此项为空。
          接口兼容性(JDK)

          表示扫描Jar包中调用的jdk接口在待迁移的系统上对应满足运行条件的最小jdk上发生的变更。

          • openEuler jdk:openEuler上满足Jar包运行环境的最小jdk版本。
          • 对象构建jdk:扫描jar包对应构建的jdk版本。
          • jar包名:扫描的jar包名称。
          • 方法名:存在接口差异的方法名。
          • 函数调用签名:存在接口差异的方法函数签名。
          • 包名:存在接口差异的方法所在的包(packageName+className)。
          • 差异项:接口差异选项。
          接口兼容性(Java)

          Jar接口差异主要描述了当前jar包接口在待迁移的系统上发生的变更。

          • 调用的jar包:表示当前被调用的jar包名称。
          • 所属的rpm包:表示当前的jar包所属的rpm包。
          • 展开的详细信息中:
            • centos7.6 Methods:表示CentOS 7.6上不兼容的接口名称。
            • package:表示不兼容的接口所属的jar包。
            • class:表示不兼容的接口所属的类。
            • openEuler20.03-LTS-SP1 Change:表示不兼容的接口在openEuler20.03-LTS-SP1上发生的变更,这部分变更描述包含了方法的移除,方法返回参数、方法签名、方法修饰、异常等变更。

          表 9 硬件兼容性评估报告结果参数说明

          参数说明
          评估结果显示评估环境中的系统、基本系统、CPU以及整机兼容性信息。
          板卡在openEuler 20.03 LTS SP1 兼容性清单

          板卡兼容必须满足兼容性清单中参数与已有板卡清单列表中的信息都保持一致才算兼容。若对比字段信息不完全一致,则属于待确认板卡。

          • 芯片厂商ID
          • 设备ID
          • 二级厂商制造ID
          • 二级设备ID
          • 芯片型号
          • 是否在兼容性清单:确认该硬件是否兼容目标操作系统
          • 风险级别:对硬件兼容性影响升级的风险进行等级评估

          表 10 软件冲突检查报告结果参数说明

          参数说明
          软件冲突检查统计显示评估环境升级中存在的冲突信息、源操作系统保留包、升级到目标系统包、升级到openEuler拓展仓库包、源操作系统删除的软件包和目标操作系统额外安装包等相关信息。
          冲突信息描述了源操作系统与升级目标操作系统中存在的软件包冲突信息。
          源操作系统保留包升级至目标操作系统后保留的源操作系统软件包。
          升级到目标系统包升级至目标操作系统后的同时升级的软件包信息。
          升级到openEuler拓展仓库包升级至openEuler操作系统后拓展的软件包信息。
          源操作系统删除的软件包升级至目标操作系统后移除的源操作系统软件包。
          目标操作系统额外安装包升级至目标操作系统后额外安装的软件包。
      3. (可选)单击右下角“初始化”回归待测试阶段,单击“下载环境信息和日志”获取环境信息和工具运行日志结果。

      系统配置迁移

      配置迁移任务分析节点环境中的相关配置信息并迁移至目标环境中,实现业务连续运行。

      创建系统配置迁移任务

      前提条件

      已成功登录x2openEuler工具。

      操作步骤
      1. 在页面左侧,单击“新建任务”,选择“配置迁移任务”进入“新建配置迁移任务”界面。

      2. 在“新建升级任务”输入“任务名称”后,选择“迁移类型”,此处以“分析并迁移为例”,并对以下参数进行配置。

        须知 须知: 迁移类型分为以下三类,针对不同情况进行选择即可。

        • 仅分析配置:仅对源节点配置信息进行分析,支持分析后导出。
        • 仅迁移配置:仅支持将配置信息迁移至目标节点。
        • 分析配置并迁移:对源节点配置信息进行分析并迁移至目标节点。
        • 批量导入:通过模板表格导入多个节点的节点信息。

          说明 说明: 批量导入节点过程中,工具会对导入的节点信息进行校验,若校验不通过则需按照提示修改导入信息,并重新进行批量导入操作。

          1. 在批量导入界面中,单击“模板表格”获取模板后参考表11填写节点信息。

            图 13 批量导入
            批量导入

          2. 完成节点信息的填写后单击“上传文件”阅读“SSH传输须知”,选择已填写节点信息的批量导入文件进行上传。

            图 14 SSH传输须知
            SSH传输须知

        • 添加节点:添加单个节点的节点信息。

          1. 在“添加节点”页面,参考表11输入相应信息后,单击“确定”进行节点添加。

            图 15 添加节点
            添加节点

        表 11 节点信息参数说明

        参数说明
        SSH传输须知节点管理使用服务器默认的SSH传输通道,为了保护数据的安全完整,建议使用安全的ssh服务,如使用安全的ssh版本,配置使用安全的加密算法等。
        源节点IP地址源节点IP地址。
        说明:
        源节点与部署openEuler web工具的环境需要保持可联通状态。
        源节点别名源节点别名,该别名用于标记该节点用途。
        源端口登录源节点的SSH协议端口。
        源用户名登录源节点的用户名。
        源端口登录源节点的SSH协议端口。
        认证方式

        密钥认证:通过私钥文件和私钥文件的密码短语进行认证。

        • 私钥文件:登录源节点私钥文件的绝对路径。
        • 密码短语:登录源节点私钥文件的密码短语。 配置秘钥认证方式请参考配置生成秘钥
          说明:
          • 若登录用户为普通用户,需要输入root用户口令切换到root用户进行具体操作。
          • 由于root用户拥有最高权限,直接使用root用户登录服务器可能会存在安全风险。您可以通过配置禁止root用户SSH登录的选项,来提升系统安全性。具体配置如下:先以普通用户登录服务器,切换至root登录后检查/etc/ssh/sshd_config配置项PermitRootlogin,如果显示no,说明禁止了root用户登录;如果显示yes,则需要将配置项PermitRootlogin设置为no。配置完成后需要重启sshd服务确保配置生效。
          • 配置的节点信息中涉及用户密码输入,请注意定期维护帐户信息,确保环境安全。

        口令认证:通过口令进行认证。

        口令:登录源节点的密码口令。

        说明:
        • 若登录用户为普通用户,需要输入root用户口令切换到root用户进行具体操作。
        • 由于root用户拥有最高权限,直接使用root用户登录服务器可能会存在安全风险。您可以通过配置禁止root用户SSH登录的选项,来提升系统安全性。具体配置如下:先以普通用户登录服务器,切换至root登录后检查/etc/ssh/sshd_config配置项PermitRootlogin,如果显示no,说明禁止了root用户登录;如果显示yes,则需要将配置项PermitRootlogin设置为no。配置完成后需要重启sshd服务确保配置生效。
        源操作系统版本待迁移节点的操作系统,默认为CentOS 7.6,可通过上传操作系统数据库支持包支持更多操作系统。
        目标节点IP

        目标节点IP地址。

        说明:
        目标节点与部署openEuler web工具的环境需要保持可联通状态
        目标端口登录至目标节点的SSH协议端口。
        目标用户名登录至目标节点的用户名。
        认证方式密钥认证:通过私钥文件和私钥文件的密码短语进行认证。
        • 私钥文件:登录待升级节点私钥文件的绝对路径。
        • 密码短语:登录待升级节点私钥文件的密码短语。配置秘钥认证方式请参考配置生成秘钥
        口令认证:通过口令进行认证。
        口令:登录待升级节点的密码口令。
        说明:
        • 若登录用户为普通用户,需要输入root用户口令切换到root用户进行具体操作,由于root用户拥有最高权限,直接使用root用户登录服务器可能会存在安全风险。您可以通过配置禁止root用户SSH登录的选项,来提升系统安全性。具体配置如下:先以普通用户登录服务器,切换至root登录后检查/etc/ssh/sshd_config配置项PermitRootlogin,如果显示no,说明禁止了root用户登录;如果显示yes,则需要将配置项PermitRootlogin设置为no。配置完成后需要重启sshd服务确保配置生效。
        • 配置的节点信息中涉及用户密码输入,请注意定期维护帐户信息,确保环境安全。
        目标操作系统版本待迁移节点进行升级的目标操作系统,默认为openEuler 20.03-LTS-SP1,可通过上传操作系统支持包支持更多操作系统。
      3. 此处以添加单个节点进行指纹验证为例,工具对导入的节点信息校验完成后,进入节点指纹验证页面,确认节点指纹无误后,单击“确定”。

        图 16 指纹验证
        指纹验证

      4. 节点添加完成,确认添加节点信息无误后,单击任务名称右侧“确定”,完成配置迁移任务创建。若需要修改或删除相应节点,单击右侧“操作”项下的“修改”或“删除”对节点进行操作。单击右下角“确认”启动配置迁移任务,单击右下角“取消”,取消配置迁移任务。

        图 17 配置迁移任务信息确认
        配置迁移任务信息确认

      进行系统配置迁移

      前提条件
      • 已登录x2openEuler工具。
      • 已创建配置迁移任务。
      操作步骤
      1. 在页面“全部任务”下选择已创建的配置迁移任务,单击右侧“进入任务”,进入任务详情页面。

      2. 单击节点信息右侧的“开始分析”,可对单个节点进行分析配置迁移。同时勾选多个节点,单击左上角“批量操作”,可对多个节点启动分析配置迁移。

        配置分析迁移过程分为4个阶段,其中任意阶段失败都会导致后续任务执行过程终止。

        1. 环境检查

          环境检查用于分析x2openEuler工具与源目节点的连通性,验证环境信息是否正常,若环境检查无法通过,则需修改节点配置信息。

          图 18 环境检查页面
          环境检查页面

        2. 配置分析

          针对源节点进行配置分析,产生配置分析报告,确认源节点可以进行迁移配置信息。配置分析报告参数详细说明请参考表12

          图 19 配置分析
          配置分析 表 12 配置分析报表参数说明

          参数说明
          变化数统计显示源节点配置项变化数、服务配置变化数、内核参数变化数、网络参数变化数、挂载参数变化数。
          服务配置变化对比源目节点服务配置变化。
          内核参数变化对比源目节点内核参数变化。
          网络参数变化对比源目节点网络参数变化。
          挂载参数变化对比源目节点挂载参数变化。
        3. 配置迁移 勾选需要迁移的配置信息,单击右下角“开始迁移”进行配置迁移。

          图 20 配置迁移
          配置迁移

          说明 说明: 配置迁移过程中,部分源操作系统服务或应用配置可能因其本身无法迁移而导致迁移失败,对于该部分配置内容可单击“忽略失败项”进行处理。后续可在目标操作系统上重新部署。

        4. 环境清理

          配置迁移完成后建议进行业务测试,测试稳定后再执行环境清理操作,以节约环境空间。如需进行回退操作,则可以选择保留。

          说明 说明:

          升级完成后,需进行业务运行验证,若业务运行正常,即可进行环境清理,以释放占用空间。 环境清理将清理备份文件并卸载x2openEuler-client软件。

      3. 配置迁移完成后,请在目标节点上进行业务测试,以确认业务运行正常,如需进行回退操作,可进入节点详情页面,单击右下角“回退”。

      软件包评估

      对源操作系统升级到目标操作系统的软件包进行评估,确保升级后业务正常运行。

      前提条件

      已安装x2openEuler工具

      操作步骤

      1. 单击页面左侧“新建任务”,在下拉菜单中选择“软件包评估”。在弹出框“新建软件评估任务”界面中输入任务名称,单击确定进入评估任务界面。

      2. 单击左上角“选择软件包”,进入如图 21所示界面,参考表 13上传需要评估的软件包。

        图 21 选择软件包
        选择软件包

        表 13 软件包扫描参数说明

        参数说明
        扫描方式上传软件包:支持上传多个软件包,支持elf/python/jar/shell/spec等类型的软件包。

        扫描路径:扫描x2openEuler安装节点上已存在的软件包。

        说明:
        仅支持扫描“/opt/x2openEuler/scan”路径下的文件。
        源操作系统待升级节点的操作系统,默认为CentOS 7.6,可通过上传操作系统数据库支持包支持更多操作系统。
        目标操作系统升级节点进行升级的目标操作系统,默认为openEuler 20.03-LTS-SP1,可通过上传操作系统支持包支持更多操作系统。
        系统架构源目操作系统所依托的硬件架构。
        • x86_64
        • aarch64
      3. 单击“确定“,执行软件评估任务。评估完成后,工具将自动跳转至分析结果界面,分析结果分为软件依赖关系图和软件评估报告,如图22所示,软件评估报告详细参数描述如表14所示。

        说明 说明:

        • 用户可以在软件包评估任务的列表中,单击指定已完成分析任务的任务名称查看分析报告。
        • 用户可以通过软件依赖关系图,分析软件包的依赖关系及在openEuler系统上的替换包。
        • 分析报告的名称为扫描的软件包名称和生成报告的时间组合。

        图 22 软件依赖关系图
        依赖关系图

        表 14 业务软件评估报告结果参数说明

        参数说明
        评估结果显示评估软件名称、源操作系统、目标操作系统、系统架构以及评估结果等评估任务信息。
        操作建议依据评估报告中的兼容性结果,提供对应解决方案建议。
        依赖包兼容性显示软件安装所需要的直接依赖以及依赖文件在各个系统上对应的rpm包。
        • 若查询到的直接依赖的rpm的名字和版本都一样,会显示 版本未变更
        • 若查询到的直接依赖的rpm的版本不一样,但接口无差异,会显示 版本有变更
        • 若查询到的直接依赖的rpm的包名发生变化,但接口无差异,会显示 包名有变更
        • 若源操作系统查到rpm,目标操作系统没有查到,会显示 缺失
        • 若源操作系统没有查到rpm,目标操作系统有查到,或者所在包有接口变化则会显示, 需要检查
        • 若源操作系统和目标操作系统都没有查到rpm,则会放到 other 里边,并显示 需要检查
        接口兼容性(C/C++)
        • 调用函数名称:表示被评估软件中调用的函数名称。
        • 调用的接口程序:表示被评估软件中被存在差异的外部接口调用的程序。
        • 结果:
          • 已移除:表示缺失的接口。
          • 已变更:表示函数入参,返回值,或者实现有变化
        • 展开的详细信息中:
          • 操作系统:表示迁移评估的系统名称。
          • 函数名:接口表示。
          • 文件名:表示外部接口所在的文件名。
          • 依赖包:表示接口所在的外部so库。
          • 接口差异项:表示外部接口的变化差异,如果是已移除接口,则此项为空。
        接口兼容性(JDK)

        表示扫描Jar包中调用的jdk接口在待迁移的系统上对应满足运行条件的最小jdk上发生的变更。

        • openEuler jdk:openEuler上满足Jar包运行环境的最小jdk版本。
        • 对象构建jdk:扫描jar包对应构建的jdk版本。
        • jar包名:扫描的jar包名称。
        • 方法名:存在接口差异的方法名。
        • 函数调用签名:存在接口差异的方法函数签名。
        • 包名:存在接口差异的方法所在的包(packageName+className)。
        • 差异项:接口差异选项。
        接口兼容性(Java)

        Jar接口差异主要描述了当前jar包接口在待迁移的系统上发生的变更。

        • 调用的jar包:表示当前被调用的jar包名称。
        • 所属的rpm包:表示当前的jar包所属的rpm包。
        • 展开的详细信息中:
          • centos7.6 Methods:表示CentOS 7.6上不兼容的接口名称。
          • package:表示不兼容的接口所属的jar包。
          • class:表示不兼容的接口所属的类。
          • openEuler20.03-LTS-SP1 Change:表示不兼容的接口在openEuler20.03-LTS-SP1上发生的变更,这部分变更描述包含了方法的移除,方法返回参数、方法签名、方法修饰、异常等变更。
      4. 单击右下角“下载环境信息和日志”获取环境信息和日志文件,单击“导出HTML报告”导出当前评估任务的分析结果。

      升级后验证与回滚

      升级后验证

      前提条件

      待升级节点已经完成升级且升级过程无报错信息。

      操作步骤

      1. 执行以下命令查看操作系统版本。

        cat /etc/os-release
        
      2. 尽快执行以下命令重启机器进入openEuler系统。

        reboot
        

      升级后回退

      前提条件

      待升级节点已经完成升级。

      操作步骤

      须知 须知: 若要进行回退操作,必须先重启机器,否则会导致回退异常。

      1. 重启系统后执行以下命令进行回退操作。

        sh /usr/bin/centos2openEuler rollback
        

        图 33 回退过程
        回退过程

      2. (可选)检查回退一致性,重启系统后需要手动执行收集系统信息和系统信息对比的命令。

        1. 收集回滚后系统信息请参考4

        2. 执行以下命令进行回滚后系统信息对比。

          x2openEuler-client system-info-compare -d /opt/x2openEuler-client/output/
          

          图 34 回滚后系统信息对比
          回滚后信息对比

      文档捉虫

      “有虫”文档片段

      问题描述

      提交类型 issue

      有点复杂...

      找人问问吧。

      PR

      小问题,全程线上修改...

      一键搞定!

      问题类型
      规范和低错类

      ● 错别字或拼写错误;标点符号使用错误;

      ● 链接错误、空单元格、格式错误;

      ● 英文中包含中文字符;

      ● 界面和描述不一致,但不影响操作;

      ● 表述不通顺,但不影响理解;

      ● 版本号不匹配:如软件包名称、界面版本号;

      易用性

      ● 关键步骤错误或缺失,无法指导用户完成任务;

      ● 缺少必要的前提条件、注意事项等;

      ● 图形、表格、文字等晦涩难懂;

      ● 逻辑不清晰,该分类、分项、分步骤的没有给出;

      正确性

      ● 技术原理、功能、规格等描述和软件不一致,存在错误;

      ● 原理图、架构图等存在错误;

      ● 命令、命令参数等错误;

      ● 代码片段错误;

      ● 命令无法完成对应功能;

      ● 界面错误,无法指导操作;

      风险提示

      ● 对重要数据或系统存在风险的操作,缺少安全提示;

      内容合规

      ● 违反法律法规,涉及政治、领土主权等敏感词;

      ● 内容侵权;

      您对文档的总体满意度

      非常不满意
      非常满意
      提交
      根据您的反馈,会自动生成issue模板。您只需点击按钮,创建issue即可。
      文档捉虫
      编组 3备份