长期支持版本

    社区创新版本

      x2openEuler 用户指南(630)

      前言

      概述

      本文档介绍了获取x2openEuler工具安装包,以及对其进行安装、使用的方法,对x2openEuler插件的操作界面及各项功能做了详细介绍。

      读者对象

      本文档主要适用于以下人员:

      • openEuler操作系统用户
      • 软件开发者

      符号约定

      在本文中可能出现下列标志,它们所代表的含义如下。

      符号

      说明

      表示如不避免则将会导致死亡或严重伤害的具有高等级风险的危害。

      表示如不避免则可能导致死亡或严重伤害的具有中等级风险的危害。

      表示如不避免则可能导致轻微或中度伤害的具有低等级风险的危害。

      用于传递设备或环境安全警示信息。如不避免则可能会导致设备损坏、数据丢失、设备性能降低或其他不可预知的结果。

      “须知”不涉及人身伤害。

      对正文中重点信息的补充说明。

      “说明”不是安全警示信息,不涉及人身、设备及环境伤害信息。

      命令行格式约定

      格式

      意义

      粗体

      命令行关键字(命令中保持不变、必须照输的部分)采用加粗字体表示。

      斜体

      命令行参数(命令中必须由实际值进行替代的部分)采用斜体表示。

      [ ]

      表示用“[ ]”括起来的部分在命令配置时是可选的。

      { x | y | ... }

      表示从两个或多个选项中选取一个。

      [ x | y | ... ]

      表示从两个或多个选项中选取一个或者不选。

      { x | y | ... }*

      表示从两个或多个选项中选取多个,最少选取一个,最多选取所有选项。

      [ x | y | ... ]*

      表示从两个或多个选项中选取多个或者不选。

      &<1-n>

      表示符号“&”前面的参数可以重复1~n次。

      #

      表示由“#”开始的行为注释行。

      修改记录

      文档版本

      发布日期

      修改说明

      03

      2022-03-30

      第三次正式发布。

      02

      2022-01-21

      第二次正式发布。

      01

      2021-12-31

      第一次正式发布。

      免责声明

      须知: 工具会对部分命令进行提权操作,用于进行硬件评估及配置分析。具体命令如下:

      • /bin/cat /boot/grub2/grub.cfg
      • /usr/sbin/lspci -nvvv
      • /usr/sbin/lspci -xxx
      • /bin/netstat -npl
      • /usr/sbin/sysctl -a
      • /usr/sbin/dmidecode -t bios -t system -t baseboard -t chassis -t processor -t memory -t cache -t connector -t slot
      • /usr/sbin/dmidecode -s system-product-name
      • /bin/cat /boot/efi/EFI/centos/grub.cfg

      工具会分析系统信息,收集系统配置项,用于进行配置分析。对应的文件配置如下:

      • /boot/grub2/grub.cfg
      • /etc/default/grub
      • /usr/include/asm/unistd_64.h
      • /etc/fstab
      • /etc/profile
      • /etc/sysctl.conf
      • /boot/conifg-*
      • 建议您在非生产环境使用本工具,避免影响生产业务运行。
      • 您上传源码及软件包前已确认您为源码、软件包所有者或者已获得源码、软件包所有者的充足授权同意。
      • 未经所有者授权,任何个人或组织均不得使用该源码从事任何活动。
      • 未经所有者授权,任何个人或组织均不得私自传播该源码及软件包。
      • 相关评估报告仅做查阅参考,不具有法律效力,也不以任何方式或形式构成特定指引和法律建议。
      • 您根据本评估建议及相关内容所采取的任何行为均由您自行承担风险。
      • 上传源码及软件包至当前服务器工作目录下,用于兼容性评估。本工具不会将这些源码及软件包用于其他目的,通过其他用户名登录同一台服务器的用户无权查看您工作目录下的文件。
      • 若软件包中存在jar包,本工具会对jar包进行反编译,用于兼容性评估分析。本工具不会将这些jar包用于其他目的。

      工具概述

      x2openEuler迁移评估工具是基于Visual Studio Code提供给开发者面向openEuler操作系统进行软件迁移分析的轻量级端到端工具,支持软件评估、配置收集与评估以及硬件评估。x2openEuler插件作为客户端调用服务端的工具,完成扫描迁移任务,可以对待迁移软件进行快速扫描分析,提供专业的代码迁移指导,极大简化客户应用从CentOS迁移到openEuler的过程。当客户有软件需要从CentOS平台迁移到openEuler平台上时,可先用该工具分析可迁移性和迁移投入,以解决客户软件迁移评估中分析投入大、准确率低、整体效率低下的痛点。

      x2openEuler工具支持的特性功能如下:

      • 软件评估

        通过识别应用软件依赖的软件包清单信息,对rpm/tar/zip/gzip/jar/py/pyc/sh/bin应用进行扫描评估,并生成.html评估报告。

      • 配置收集与评估

        支持对用户环境数据进行收集并生成json格式文件,支持收集硬件配置、配置接口、内核选项配置参数、系统配置参数(sysctl/proc/sys)、环境变量、服务、进程、端口、命令接口、系统调用项和设备驱动接口等信息,并完成配置信息分析评估。

      • 硬件评估

        评估运行环境的整机(x86/aarch64)、整机板卡(RAID/NIC/FC/IB/GPU/SSD/TPM)是否在openEuler兼容性清单。

      安装

      安装x2openEuler工具

      环境要求

      说明: 本工具仅适用于开发和测试环境。

      物理机要求

      x2openEuler支持在物理机上安装运行,物理机要求如表1所示。

      表 1 硬件要求

      硬件类型

      说明

      服务器

      • x86服务器
      • 基于鲲鹏916/920处理器的服务器

      CPU

      双核及以上配置

      内存

      系统空闲内存要求8GB及以上

      硬盘

      20GB及以上剩余空间

      虚拟机要求

      x2openEuler支持安装在虚拟机上运行,虚拟机要求如表2所示。

      表 2 虚拟机要求

      硬件类型

      说明

      架构

      aarch64或x86_64

      CPU

      双核及以上

      内存

      系统空闲内存要求8GB及以上

      硬盘

      20GB及以上剩余空间

      源操作系统要求

      运行环境操作系统要求表3所示。

      表 3 源操作系统要求

      操作系统名称

      版本

      操作系统镜像文件名称

      CentOS

      6.8

      x86_64:CentOS-6.8-x86_64-bin-DVD1.iso

      7.6

      x86_64:CentOS-7-x86_64-Everything-1810.iso

      aarch:CentOS-7-aarch64-Everything-1810.iso

      8.2

      x86_64:CentOS-8.2.2004-x86_64-dvd1.iso

      aarch:CentOS-8.2.2004-aarch64-dvd1.iso

      说明: 如果当前服务器环境无法联网或修改过操作系统yum源,工具安装过程中需要操作系统镜像文件用于安装依赖包,所需操作系统镜像文件请参见表3,请自行获取对应操作系统版本的镜像文件。

      目标操作系统要求

      目标操作系统要求表4所示。

      表 4 目标操作系统要求

      操作系统名称

      版本

      操作系统镜像文件名称

      openEuler

      20.03 LTS SP1

      x86_64:openEuler-20.03-LTS-SP1-everything-x86_64-dvd.iso

      aarch:openEuler-20.03-LTS-SP1-everything-aarch64-dvd.iso

      依赖要求

      x2openEuler自动安装的依赖组件如表5所示。

      表 5 依赖组件

      分类

      组件

      说明

      x2openEuler工具

      bzip2

      解压缩工具。

      bzip2-devel

      解压缩工具。

      cmake

      自动化构建系统。

      dmidecode

      查询硬件信息工具包。

      libxml2

      xml解析函数库。

      libxml2-devel

      xml解析函数库。

      libxslt

      xml解析库。

      libxslt-devel

      xml解析库。

      libffi

      编译python需要的依赖包。

      libffi-devel

      编译python需要的依赖包。

      net-tools

      网络命令工具箱。

      java-1.8.0-openjdk

      Java软件开发工具包。

      java-1.8.0-openjdk-devel

      Java软件开发工具包。

      java-1.8.0-openjdk-headless

      Java软件开发工具包。

      openssl

      编译python需要的依赖包。

      openssl-devel

      编译python需要的依赖包。

      python3

      自动化构建系统。

      pciutils

      访问PCI总线配置寄存器的可移植库。

      rpm-build

      rpm包制作管理工具。

      sqlite

      数据库,要求版本3.7.17及以上。

      说明:

      CentOS 6.8 采用x2openEuler工具集成的SQLite数据库。

      sqlite-devel

      用于访问SQLite数据的依赖包。

      util-linux

      Linux系统标准软件套件。

      zlib

      解压缩工具。

      zlib-devel

      解压缩工具。

      获取软件包

      安装过程中所需软件包如表6所示。

      表 6 获取工具安装包

      软件包名称

      软件包说明

      获取方法

      x2openEuler-x.x-x.aarch64.rpm

      x2openEuler-x.x-x.x86_64.rpm

      x2openEuler软件安装包

      说明: 软件包名称中的“x.x-x”表示版本号。

      安装

      前提条件
      • 已准备用于安装x2openEuler工具的x86服务器或者基于鲲鹏916/920的服务器。
      • 已安装操作系统,操作系统版本要求请参见表3
      • 已安装远程SSH登录工具,如Xshell、MobaXterm、PuTTY等。
      操作步骤

      须知:

      • 安装x2openEuler工具需要保证网络连接正常,若操作系统环境不可以联网,则需要先参考配置操作系统yum源配置yum源。
      • 重新安装前需要卸载其他版本的x2openEuler工具。

      本章以CentOS(x86_64)环境下安装x2openEuler工具为例,可以通过以下两种方式安装x2openEuler工具:

      选择手动下载并在服务器上安装x2openEuler工具
      1. 使用SSH远程登录工具,以普通用户进入CentOS操作系统命令行界面。

      2. 执行以下命令切换至root用户。

        su - root
        
      3. 使用SSH远程登录工具,将获取软件包中获取的x2openEuler工具安装包拷贝到自定义路径下。

      4. 执行如下命令进入存放x2openEuler工具安装包的自定义路径。

        cd 自定义路径
        
      5. 执行如下命令安装x2openEuler工具,其中“x2openEuler-x.x-x.x86_64.rpm”为x2openEuler工具安装包名称,请使用实际待安装的x2openEuler工具安装包名称进行替换。

        须知: x2openEuler工具仅支持在x2openEuler用户下使用,因此x2openEuler工具安装过程中会自动创建x2openEuler用户。若系统中已有x2openEuler用户,则在安装x2openEuler工具前需要确认该x2openEuler用户允许被工具使用,否则工具可能无法正常运行。

        yum install x2openEuler-x.x-x.x86_64.rpm
        

        安装完成后,如下为用户相关的目录。

        /var/log/x2openEuler        # 存放工具日志文件的目录
        /var/log/aparser            # 存放配置收集器日志文件的目录
        /opt/x2openEuler/output     # 报告默认输出目录
        /opt/x2openEuler/update     # 配置文件更新目录(用于存放更新包和对应的 license 文件)
        /etc/x2openEuler/config     # 存放静态配置文件的目录
        /etc/x2openEuler/sqlite     # 存放数据库文件的目录
        /usr/local/x2openEuler      # 程序文件存放路径
        /opt/x2openEuler/source     # 存放兼容性数据文件的目录
        

        说明: 安装过程中,若出现“error: Failed dependencies:”提示信息时,表示缺少依赖软件包,请参考安装时出现缺少依赖软件包导致安装失败进行处理。

      6. 设置x2openEuler用户密码。

        passwd x2openEuler
        

        说明: 登录用户的密码。密码建议满足如下复杂度要求:

        • 密码长度为8~32个字符
        • 必须包含大写字母、小写字母、数字、特殊字符(`~!@#$%^&*()-_=+\|[{}];:'",<.>/?)中的两种及以上类型的组合
        • 密码不能包含空格
        • 密码不能是用户名
      7. 执行如下命令切换到x2openEuler用户和x2openEuler用户的家目录(/home/x2openEuler)。

        须知: x2openEuler工具仅支持在x2openEuler用户下使用,使用前请务必切换用户为x2openEuler用户,同时建议将工作目录切换为x2openEuler用户的家目录。

        su - x2openEuler
        
      选择使用插件部署功能一键式安装
      1. 安装x2openEuler插件后,单击,阅读并确认接受免责声明后,进入x2openEuler插件配置指引界面。选择“x2openEuler工具部署”进入工具部署界面。

        图 1 配置指引界面

      2. 在工具部署界面,配置工具部署参数进行x2openEuler工具安装,参数描述如表7

        图 2 工具部署界面

        表 7 配置工具部署参数说明

        参数

        说明

        服务器IP地址

        部署x2openEuler工具的目标服务器IP地址。

        SSH端口

        登录至目标服务器的SSH端口,默认为22。

        SSH用户名

        部署x2openEuler工具需要以root用户登录至目标服务器进行安装,该参数应为root用户。

        说明:

        由于root用户拥有极高的权限,建议您在完成工具部署后,配置禁止root用户SSH登录,以保证运行环境安全。

        SSH密码

        登录至目标服务器进行工具部署的root用户密码。

      3. 单击“开始部署”后,进入“安装前准备”界面。设置x2openEuler用户密码,若目标服务器未联网则需上传x2openEuler软件安装包。单击“下一步”进行工具部署。

        图 3 安装前准备

        说明: 设置的密码需要满足如下复杂度要求:

        • 密码长度为8~32个字符
        • 必须包含大写字母、小写字母、数字、特殊字符(`~!@#$%^&*()-_=+\|[{}];:'",<.>/?)中的两种及以上类型的组合
        • 密码不能包含空格
        • 密码不能是用户名
      4. 工具部署安装完成后,界面会提示“x2openEuler工具部署成功”,可单击“配置远端服务器”,参考配置远端服务器进行配置。若工具部署失败,请参考VS Code底部输出框信息重新进行工具部署。

      验证

      验证安装的插件模式

      登录x2openEuler插件界面,详细步骤请参见通过插件使用x2openEuler工具,能够成功登录说明x2openEuler工具安装成功。

      验证安装的CLI模式
      1. 使用SSH远程登录工具,以任意用户进入CentOS操作系统命令行界面。

      2. 执行以下命令,切换至x2openEuler用户。

        su - x2openEuler
        
      3. 执行如下命令查看版本信息。

        x2openEuler -v
        

        显示如下格式内容说明安装成功(其中“x.x.x”表示版本号,请以实际情况为准)。

        x2openEuler x.x.x
        

      卸载

      前提条件

      没有正在运行中的任务。

      操作步骤
      1. 使用SSH远程登录工具,以root用户进入操作系统命令行界面。

      2. 执行如下命令卸载x2openEuler工具。

        rpm -e x2openEuler

        说明:

        • 当用户执行卸载命令时,如果有正在运行的任务,用户需要先终止或等待运行的任务结束。若用户仍选择卸载,当前运行的任务会直接中断。
        • 卸载完成后,需手动移除x2openEuler用户,以保证系统环境安全。

      安装x2openEuler插件

      环境要求

      当前版本已在如下操作系统上验证:

      • Windows 10
      • macOS 10.0 x86
      • macOS 10.0 ARM

      安装方式

      说明: 该插件兼容VS Code最新版本。

      在Visual Studio Code应用商店安装x2openEuler插件

      在Visual Studio Code扩展菜单中搜索“x2openEuler”,单击“安装”。(或在Visual Studio Code应用商店中安装)。
      安装完成后,在左侧菜单栏中单击打开x2openEuler工具。

      特性指南

      须知:

      • 用户在登录服务器后长时间处于空置状态,可能会存在安全风险。建议您在服务器中配置超时机制,以提升系统安全性。
      • 不建议多个客户端同时操作同一远端服务器上的x2openEuler工具。
      • 不同客户端在同一远端服务器上传相同文件名称的文件时,会导致先上传的文件被覆盖。

      通过插件使用x2openEuler工具

      配置远端服务器

      前提条件

      已成功安装x2openEuler工具和x2openEuler插件。

      操作步骤
      1. 在VS Code左侧菜单栏,单击打开x2openEuler插件。

      2. 在VS Code左侧侧边栏,单击“配置远端服务器”,打开如图1所示界面,参数描述如表8所示。

        图 4 配置远端服务器

        表 8 配置远端服务器参数说明

        参数

        说明

        服务器IP地址

        成功部署x2openEuler工具的远端服务器IP地址。

        SSH端口

        工具安装过程中设置的SSH端口。

        说明:

        如果服务器已开通防火墙,使用x2openEuler工具前请确认服务器OS防火墙已开通SSH端口(默认为22)。

        SSH用户名

        工具安装过程中设置的SSH用户名(x2openEuler)。

        SSH密码

        工具安装过程中设置的SSH密码(x2openEuler用户密码)。

      3. 根据实际环境输入各参数值,单击“开始配置”。

        配置成功后,进入“x2openEuler向导”界面,如图5所示。在“x2openEuler向导”中可立即创建评估任务。

        图 5 x2openEuler向导

      远端服务器管理

      前提条件
      • 已成功安装x2openEuler插件。
      • 已完成配置远端服务器。
      操作步骤
      1. 在VS Code左侧侧边栏选中“远端服务器管理”,单击进行配置远端服务器

        图 6 远端服务器管理

      2. 在VS Code左侧侧边栏选择“远端服务器管理”,单击清空服务器记录。在右下角弹出框中,选择“确定”清空服务器记录。

        图 7 清空服务器记录

      3. 在VS Code左侧侧边栏选择“远端服务器管理”,单击展开服务器记录列表。选中任意服务器记录,可单击进行删除服务器记录,单击进行编辑服务器。

      软件评估

      特性描述

      软件迁移评估帮助用户完成从CentOS 7.6(CentOS 8.2、CentOS 6.8)向openEuler 20.03 LTS SP1系统的迁移评估。

      特性操作
      前提条件

      已安装x2openEuler插件并配置远端服务器成功。

      已完成x2openEuler工具部署。

      操作步骤
      1. 在页面左侧,选择“软件评估”,点击创建任务。

      2. 在创建分析任务区选择“单应用”或“多应用”,并对以下参数进行配置。

        说明: “单应用”和“多应用”相互独立,可根据实际需求选择其中的一个。

        图 8 创建软件评估任务

        表 9 创建软件评估参数项说明

        参数

        说明

        软件类型

        • 单应用:支持rpm/tar/zip/gzip/jar/py/pyc/sh/bin软件包。
        • 多应用:支持对同一目录下的多个bin文件进行评估分析,并对每个bin文件产生评估报告。

        软件存放路径

        单击“上传”按钮上传软件包。

        说明:
        • 多应用下只能上传包含多个bin文件的文件夹。
        • 只允许同时上传一个软件包,软件包小于或等于2GB,且解压后小于或等于剩余磁盘空间的一半。
        • 软件包支持rpm/tar/zip/gzip/jar/py/pyc/sh/bin类型。

        源操作系统

        选择源系统版本。可选择:

        • CentOS 6.8
        • CentOS 7.6
        • CentOS 8.2

        目标系统

        选择目标系统版本。可选择:

        openEuler 20.03-LTS-SP1

        系统架构

        选择系统架构。可选择:

        • x86_64
        • aarch64
      3. 单击“开始评估”,生成评估报告。

        评估完成后,自动跳转至分析报告详情界面,如图9所示,参数描述如表10所示。

        说明:

        • 用户可在任务进行过程中单击“取消评估”,取消评估任务。
        • 用户可以在历史报告的列表中,单击指定分析任务的报告名称查看分析报告。
        • 分析报告的名称为扫描的软件包名称和生成报告的时间组合。

        图 9 软件评估报告结果

        表 10 软件评估报告结果参数说明

        参数

        说明

        评估结果

        显示评估软件名称、源操作系统、目标操作系统、系统架构以及评估结果等评估任务信息。

        操作建议

        依据评估报告中的兼容性结果,提供对应解决方案建议。

        依赖包兼容性

        显示软件安装所需要的直接依赖以及依赖文件在各个系统上对应的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. 返回创建任务页面,在右侧历史报告中,可进行软件评估报告下载、删除等操作。

        说明: 评估报告存储在运行环境的“/opt/x2openEuler/output/”目录下,从页面历史报告中进行的删除操作不会完全移除评估报告,如需完全移除,请在运行环境中进行删除操作。

      配置收集与评估

      特性描述

      配置与收集评估功能帮助用户自动识别当前服务器环境架构,同时从用户环境收集配置信息进行评估分析。

      特性操作
      前提条件

      已安装x2openEuler插件并配置远端服务器成功。

      已完成x2openEuler工具部署。

      操作步骤
      1. 在页面左侧,选择“配置收集与评估”,点击创建任务。

      2. 在创建分析任务区选择“评估”或“收集”,并对以下参数进行配置。

        说明:

        • “评估”和“收集”相互独立,可根据实际需求选择其中的一个。
        • “评估”既能评估当前服务器环境配置信息,也可以通过“外部导入”对其他服务器环境进行分析。

        图 10 创建配置收集与评估任务

        表 11 创建配置收集与评估参数项说明

        参数

        说明

        任务类型

        • 评估:自动识别当前服务器环境架构及配置信息进行评估。
        • 收集:对当前服务器配置信息和硬件信息进行收集。

        配置信息源

        • 本地扫描:对当前服务器环境进行配置信息扫描与收集。
        • 外部导入:上传通过配置与评估中收集的信息,格式为tar.gz。
          说明:

          不支持输入外部配置信息路径。

        源操作系统

        选择源系统版本。可选择:

        • CentOS 6.8
        • CentOS 7.6
        • CentOS 8.2

        目标系统

        选择目标系统版本。可选择:

        openEuler 20.03-LTS-SP1

        系统架构

        选择系统架构。可选择:

        • x86_64
        • aarch64
      3. 单击“开始评估”,生成评估报告。

        评估完成后,自动跳转至分析报告详情界面,如图11所示,参数描述如表12所示。

        说明:

        • 用户可在任务进行过程中单击取消评估,取消评估任务。
        • 用户可以在分析报告的列表中,单击指定分析任务的报告名称查看分析报告。

        图 11 配置收集与评估报告结果

        表 12 配置收集与评估报告结果参数说明

        参数

        说明

        评估结果

        显示配置评估系统的架构信息和迁移说明。

        系统静态配置

        对比五项系统信息:内核配置、内核启动参数、内存页大小、内核参数和挂载参数。

        说明:

        若上述对比信息发生变化则结论会显示 需要检查,需要用户手动查看相应配置信息。若没有发生变化,会显示 未改变

        系统动态配置

        对比两项系统信息:系统配置和系统服务。

        说明:

        若上述对比信息发生变化则结论会显示 需要检查,需要用户手动查看相应配置信息。若没有发生变化,会显示 未改变

        返回创建任务页面,在右侧历史报告中,可进行配置评估报告下载、删除等操作。

        说明: 评估报告存储在运行环境的“/opt/x2openEuler/output/”目录下,从页面历史报告中进行的删除操作不会完全移除评估报告,如需完全移除,请在运行环境中进行删除操作。

      硬件评估

      特性描述

      硬件评估功能支持用户环境收集硬件信息进行分析评估。

      说明: 硬件评估任务只能在物理机上进行。

      特性操作
      前提条件

      已安装x2openEuler插件并配置远端服务器成功。

      已完成x2openEuler工具部署。

      操作步骤
      1. 在页面左侧,选择“硬件评估”,点击创建任务。

      2. 在创建分析任务区选择“本地扫描”或“外部导入”,并对以下参数进行配置。

        说明:

        • “本地扫描”和“外部导入”相互独立,可根据实际需求选择其中的一个。
        • “硬件评估”建议在物理环境中执行。

        图 12 创建硬件评估任务

        表 13 创建配置收集与评估参数项说明

        参数

        说明

        硬件信息源

        • 本地扫描:自动扫描收集当前服务器硬件配置信息进行评估。
        • 外部导入:导入通过配置与评估中收集的信息,格式为tar.gz。
          说明:

          不支持输入外部硬件信息路径。

        目标操作系统

        选择目标系统版本。可选择:

        openEuler20.03-LTS-SP1

      3. 单击“开始评估”,生成评估报告。

        评估完成后,自动跳转至分析报告详情界面,如图13所示,参数描述如表14所示。

        说明:

        • 用户可在任务进行过程中单击取消评估,取消评估任务。
        • 用户可以在分析报告的列表中,单击指定分析任务的报告名称查看分析报告。

        图 13 硬件评估报告结果

        表 14 硬件评估报告结果参数说明

        参数

        说明

        评估结果

        显示评估环境中的系统、基本系统、CPU以及整机兼容性信息。

        板卡在openEuler 20.03 LTS SP1 兼容性清单

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

        返回创建任务页面,在右侧历史报告中,可进行硬件评估报告下载、删除等操作。

        说明: 评估报告存储在运行环境的“/opt/x2openEuler/output/”目录下,从页面历史报告中进行的删除操作不会完全移除评估报告,如需完全移除,请在运行环境中进行删除操作。

      通过CLI使用x2openEuler工具

      软件评估

      特性描述

      软件迁移评估帮助用户完成从CentOS 7.6(CentOS 8.2、CentOS 6.8)向openEuler 20.03 LTS SP1系统的迁移评估。

      特性操作
      通过CLI命令进行应用包扫描

      前提条件

      须知: x2openEuler工具仅支持在x2openEuler用户下使用,使用前请务必切换用户为x2openEuler用户,同时建议将工作目录切换为x2openEuler用户的家目录。

      使用SSH远程登录工具以x2openEuler用户登录。

      命令功能

      对单应用或多应用进行扫描分析,评估应用从源操作系统迁移至目标操作系统的可行性。

      命令格式

      x2openEuler scan [-arch ARCH] [-os_name OS_NAME] [-target_os_name TARGET_OS_NAME] {filename | directoryname}
      x2openEuler scan -batch [-arch ARCH] [-os_name OS_NAME] [-target_os_name TARGET_OS_NAME] directoryname
      

      参数说明

      表 15 参数说明

      命令

      参数选项

      说明

      -batch

      -

      多应用场景,若无此参数,表示单应用场景。

      -arch

      ARCH

      操作系统架构

      可选参数

      可选x86_64或aarch64,默认为x86_64

      例如"-arch x86_64" #选择操作系统架构为x86_64

      -os_name

      OS_NAME

      源操作系统

      可选参数

      默认参数为centos7.6

      例如"-os_name centos8.2" #选择源操作系统为CentOS 8.2

      说明:

      当前源操作系统支持CentOS 6.8/CentOS 7.6/CentOS 8.2 。

      -target_os_name

      TARGET_OS_NAME

      目标操作系统

      可选参数

      默认参数为openEuler20.03-LTS-SP1

      例如"-target_os_name openEuler20.03-LTS-SP1" #选择目标操作系统为openEuler20.03-LTS-SP1

      说明:

      当前目标操作系统仅支持openEuler20.03-LTS-SP1 。

      -

      filename

      需要扫描的应用包。

      必选参数

      例如"x2openEuler scan file_name_version.rpm" #选择扫描的应用包为file_name_version.rpm

      说明:

      当前扫描支持rpm/tar/zip/gzip/jar/py/pyc/sh/bin文件。

      -

      directoryname

      需要扫描的应用包所在目录。

      必选参数

      例如"x2openEuler scan directory1" #选择扫描directory1目录下的单应用包

      例如"x2openEuler scan -batch directory2" #选择扫描directory2目录下的多应用包

      说明:

      只支持单层目录,不支持嵌套目录。

      使用实例

      此处以评估wpa_supplicant-2.6-1.el7.x86_64.rpm应用包并输出软件评估报告为例,请根据实际情况选择所需参数并替换为需要扫描的软件包或软件包目录。

       x2openEuler scan wpa_supplicant-2.6-1.el7.x86_64.rpm 
      

      返回信息如下:

      2021-11-30 09:12:01,222 - INFO - x2openEuler scan /home/x2openEuler/wpa_supplicant-2.6-12.el7.x86_64.rpm -os_name centos7.6 -target_os_name openEuler20.03-LTS-SP1 -arch x86_64
      2021-11-30 09:12:01,224 - INFO - Start unpacking package wpa_supplicant-2.6-12.el7.x86_64.rpm
      2021-11-30 09:12:01,768 - INFO - Decompression completed
      2021-11-30 09:12:01,768 - INFO - Start scanning so...
      2021-11-30 09:12:06,046 - INFO - Start scanning dependencies...
      2021-11-30 09:12:09,089 - INFO - Start scanning C/C++ interfaces...
      2021-11-30 09:12:26,422 - INFO - Start scanning Jar interfaces...
      2021-11-30 09:12:26,423 - WARNING - No jars found
      2021-11-30 09:12:27,851 - INFO - Start scanning Python imcenport's package...
      2021-11-30 09:12:35,942 - INFO - Start generating HTML report...
      2021-11-30 09:12:35,960 - INFO - Generate Success! The results are saved: /opt/x2openEuler/output/wpa_supplicant-2.6-12.el7.x86_64-20211130091235.html
      

      返回信息中,“/opt/x2openEuler/output/wpa_supplicant-2.6-12.el7.x86_64-20211130091235.html”为评估报告文件。

      说明: 软件兼容性评估报告分四块内容展示软件兼容性,分别是依赖包兼容性、C/C++接口兼容性、jdk接口兼容性和java接口兼容性。

      • 依赖包兼容性:反映了软件包安装过程中的直接依赖,非100%表明无法正确安装。
      • 接口兼容性:反映的是单个软件运行过程中对其他软件包、动态库或系统接口的调用变化,非100%表明在某个功能调用时可能会触发异常。 部分结果建议人工复核,最终软件包使用优先级建议 openEuler已移植包>openEuler上人工重编译包>CentOS软件包。

      配置收集与评估

      特性描述

      配置收集与评估功能帮助用户自动识别当前服务器环境架构,同时从用户环境收集配置信息进行评估分析。

      特性操作
      通过CLI命令进行配置信息和硬件信息收集

      前提条件

      须知:

      • x2openEuler工具仅支持在x2openEuler用户下使用,使用前请务必切换用户为x2openEuler用户,同时建议将工作目录切换为x2openEuler用户的家目录。
      • 使用该功能需要多次输入x2openEuler的用户密码。

      使用SSH远程登录工具以x2openEuler用户登录。

      命令功能

      收集当前环境的配置信息和硬件信息。

      命令格式

      x2openEuler conf-collect
      

      使用实例

      此处以收集当前环境配置信息为例,没有其他额外参数。请根据实际情况确定是否需要收集环境配置信息。

      x2openEuler conf-collect 
      

      返回信息如下:

      2021-11-30 09:13:39,172 - INFO - x2openEuler conf-collect
      2021-11-30 09:13:39,173 INFO manager/get_param_config/179: Parameter configuration file loaded.
      2021-11-30 09:13:39,197 INFO manager/get_regex_config/218: Regex pattern compiled.
      2021-11-30 09:13:39,197 INFO manager/load_parsers/233: All builtin parsers loaded.
      2021-11-30 09:13:39,198 INFO manager/load_parsers/236: All custom parsers loaded.
      2021-11-30 09:13:39,622 INFO time_utils/wrapper/21: 0.42s taken for running function [get_data]
      2021-11-30 09:13:39,644 WARNING list/parse_content/47: no data in ls_usr_bin
      2021-11-30 09:13:39,646 WARNING list/parse_content/47: no data in ls_usr_sbin
      2021-11-30 09:13:39,720 INFO time_utils/wrapper/21: 0.10s taken for running function [get_parsed_content]
      2021-11-30 09:13:39,720 INFO manager/write_res/135: write to /opt/x2openEuler/_tmp_6glzc3gv_/run/c0132d4a-517a-11ec-af45-000c296b94c0/sysconf/kernel_startup_param.json.
      2021-11-30 09:13:39,721 INFO manager/write_res/135: write to /opt/x2openEuler/_tmp_6glzc3gv_/run/c0132d4a-517a-11ec-af45-000c296b94c0/sysconf/syscall_interface.json.
      2021-11-30 09:13:39,721 INFO manager/write_res/135: write to /opt/x2openEuler/_tmp_6glzc3gv_/run/c0132d4a-517a-11ec-af45-000c296b94c0/sysconf/path.json.
      2021-11-30 09:13:39,722 INFO manager/write_res/135: write to /opt/x2openEuler/_tmp_6glzc3gv_/run/c0132d4a-517a-11ec-af45-000c296b94c0/sysconf/port.json.
      2021-11-30 09:13:39,722 INFO manager/write_res/135: write to /opt/x2openEuler/_tmp_6glzc3gv_/run/c0132d4a-517a-11ec-af45-000c296b94c0/sysconf/device_interface.json.
      2021-11-30 09:13:39,722 INFO manager/write_res/135: write to /opt/x2openEuler/_tmp_6glzc3gv_/run/c0132d4a-517a-11ec-af45-000c296b94c0/sysconf/linux_command.json.
      2021-11-30 09:13:39,730 INFO manager/write_res/135: write to /opt/x2openEuler/_tmp_6glzc3gv_/run/c0132d4a-517a-11ec-af45-000c296b94c0/sysconf/hardware_configure.json.
      2021-11-30 09:13:39,732 INFO manager/write_res/135: write to /opt/x2openEuler/_tmp_6glzc3gv_/run/c0132d4a-517a-11ec-af45-000c296b94c0/sysconf/proc.json.
      2021-11-30 09:13:39,734 INFO manager/write_res/135: write to /opt/x2openEuler/_tmp_6glzc3gv_/run/c0132d4a-517a-11ec-af45-000c296b94c0/sysconf/system_configure.json.
      2021-11-30 09:13:39,736 INFO manager/write_res/135: write to /opt/x2openEuler/_tmp_6glzc3gv_/run/c0132d4a-517a-11ec-af45-000c296b94c0/sysconf/system_service.json.
      2021-11-30 09:13:39,746 INFO manager/write_res/135: write to /opt/x2openEuler/_tmp_6glzc3gv_/run/c0132d4a-517a-11ec-af45-000c296b94c0/sysconf/kernel_configure.json.
      2021-11-30 09:13:39,784 - INFO - The system configs are saved: /opt/x2openEuler/output/sysconf-20211130091339.tar.gz
      

      返回信息中,“/opt/x2openEuler/output/sysconf-20211130091339.tar.gz”为收集的信息文件。信息中各json文件含义如下:

      • kernel_startup_param.json:配置接口,内核启动参数。
      • syscall_interface.json:系统调用接口,提供系统调用接口。
      • path.json:环境变量,变量Path信息。
      • port.json:端口,动态信息。
      • device_interface.json:设备驱动接口,用户态提供设备接口。
      • linux_command.json:命令接口,Linux命令。
      • hardware_configure.json:硬件配置,收集x86/aarch64 板卡信息。
      • proc.json:进程,动态信息。
      • system_configure.json:系统配置参数(sysctl/proc/sys),动态信息。
      • system_service.json:服务,系统服务。
      • kernel_configure.json:内核选项配置参数,静态信息。
      通过CLI命令进行配置信息分析

      前提条件

      须知:

      • x2openEuler工具仅支持在x2openEuler用户下使用,使用前请务必切换用户为x2openEuler用户,同时建议将工作目录切换为x2openEuler用户的家目录。
      • 使用该功能需要多次输入x2openEuler的用户密码。

      使用SSH远程登录工具以x2openEuler用户登录。

      命令功能

      对本地扫描或外部导入的配置信息进行分析评估。

      命令格式

      x2openEuler conf-analyse [-os_name OS_NAME][-target_os_name TARGET_OS_NAME] [-local | -load LOAD [-arch ARCH]]
      

      参数说明 表 16 参数说明

      命令

      参数选项

      说明

      -os_name

      OS_NAME

      源操作系统

      可选参数

      默认参数为centos7.6

      例如"-os_name centos8.2" #选择源操作系统为CentOS 8.2

      说明:

      当前源操作系统支持CentOS 6.8/CentOS 7.6 /CentOS 8.2 。

      -target_os_name

      TARGET_OS_NAME

      目标操作系统

      可选参数

      默认参数为openEuler20.03-LTS-SP1

      例如"-target_os_name openEuler20.03-LTS-SP1" #选择目标操作系统为openEuler20.03-LTS-SP1

      说明:

      当前目标操作系统仅支持openEuler20.03-LTS-SP1 。

      -local

      -

      指定分析的数据为本地扫描生成数据。

      可选参数

      默认参数为-local

      例如

      "x2openEuler conf-analyse" #选择分析数据为本地生成数据

      -load

      LOAD

      指定分析的数据为外部导入数据。

      例如

      "x2openEuler conf-analyse -load file_Name.tar.gz" #选择分析数据为外部导入数据

      说明:

      外部导入数据必须为tar.gz文件且必须为配置收集与评估功能收集的数据。

      -arch

      ARCH

      操作系统架构

      可选参数

      可选x86_64或aarch64,默认为x86_64

      例如"-arch x86_64" #选择操作系统架构为x86_64

      使用实例

      此处以评估从外部导入的“sysconf-20211130091339.tar.gz”配置信息为例,请根据实际情况选择所需参数并替换为需要进行评估的外部导入数据。

       x2openEuler conf-analyse -load /opt/x2openEuler/output/sysconf-20211130091339.tar.gz 
      

      返回信息如下:

      2021-11-30 09:24:13,191 - INFO - x2openEuler conf-analyse -load /opt/x2openEuler/output/sysconf-20211130091339.tar.gz -os_name centos7.6 -target_os_name openEuler20.03-LTS-SP1 -arch x86_64 
      2021-11-30 09:24:14,052 - INFO - Producing report...
      2021-11-30 09:24:14,053 - INFO - Generate Success! The results are saved: /opt/x2openEuler/output/conf_info_report-20211130092414.html
      

      返回信息中,“/opt/x2openEuler/output/conf_info_report-20211130092414.html”为评估报告文件。

      硬件评估

      特性描述

      须知:

      • 建议硬件评估任务在物理机上进行,若在虚拟机上执行硬件信息分析,则无法产生分析报告。
      • 使用该功能需要多次输入x2openEuler的用户密码。

      硬件评估功能支持对用户环境硬件信息进行分析评估。

      特性操作
      通过CLI命令进行硬件信息分析

      前提条件

      须知: x2openEuler工具仅支持在x2openEuler用户下使用,使用前请务必切换用户为x2openEuler用户,同时建议将工作目录切换为x2openEuler用户的家目录。

      使用SSH远程登录工具以x2openEuler用户登录。

      命令功能

      对本地扫描或外部导入的硬件资源进行兼容性评估。

      命令格式

      x2openEuler hardware-analyse [-local | -load LOAD]
      

      参数说明

      表 17 参数说明

      命令

      参数选项

      说明

      -local

      -

      指定分析的数据为本地扫描生成数据。

      可选参数

      默认参数为-local

      例如

      "x2openEuler hardware-analyse" #选择分析数据为本地生成数据

      -load

      LOAD

      指定分析的数据为外部导入数据。

      例如

      "x2openEuler hardware-analyse -load file_Name.tar.gz" #选择分析数据为外部导入数据

      说明:

      外部导入数据必须为tar.gz文件且必须为配置收集与评估功能收集的数据。

      使用实例

      此处以分析本地硬件资源信息为例,请根据实际情况选择分析本地硬件资源信息或外部导入硬件信息数据。

       x2openEuler hardware-analyse 
      

      返回信息如下:

      2021-11-30 09:41:20,865 - INFO - Log save directory: /var/log/x2openEuler
      2021-11-30 09:41:20,887 - INFO - x2openEuler hardware-analyse
      2021-11-30 09:41:20,888 INFO manager/get_param_config/179: Parameter configuration file loaded.
      2021-11-30 09:41:20,905 INFO manager/get_regex_config/218: Regex pattern compiled.
      2021-11-30 09:41:20,905 INFO manager/load_parsers/233: All builtin parsers loaded.
      2021-11-30 09:41:20,905 INFO manager/load_parsers/236: All custom parsers loaded.
      2021-11-30 09:41:21,254 INFO time_utils/wrapper/21: 0.35s taken for running function [get_data]
      2021-11-30 09:41:21,269 WARNING list/parse_content/47: no data in ls_dev
      2021-11-30 09:41:21,377 INFO time_utils/wrapper/21: 0.12s taken for running function [get_parsed_content]
      2021-11-30 09:41:21,377 INFO manager/write_res/135: write to /opt/x2openEuler/_tmp_18ambppj_/run/9e81f536-517e-11ec-ae65-a01c8dfeddfa/sysconf/kernel_startup_param.json.
      2021-11-30 09:41:21,378 INFO manager/write_res/135: write to /opt/x2openEuler/_tmp_18ambppj_/run/9e81f536-517e-11ec-ae65-a01c8dfeddfa/sysconf/syscall_interface.json.
      2021-11-30 09:41:21,378 INFO manager/write_res/135: write to /opt/x2openEuler/_tmp_18ambppj_/run/9e81f536-517e-11ec-ae65-a01c8dfeddfa/sysconf/path.json.
      2021-11-30 09:41:21,379 INFO manager/write_res/135: write to /opt/x2openEuler/_tmp_18ambppj_/run/9e81f536-517e-11ec-ae65-a01c8dfeddfa/sysconf/port.json.
      2021-11-30 09:41:21,379 INFO manager/write_res/135: write to /opt/x2openEuler/_tmp_18ambppj_/run/9e81f536-517e-11ec-ae65-a01c8dfeddfa/sysconf/device_interface.json.
      2021-11-30 09:41:21,380 INFO manager/write_res/135: write to /opt/x2openEuler/_tmp_18ambppj_/run/9e81f536-517e-11ec-ae65-a01c8dfeddfa/sysconf/linux_command.json.
      2021-11-30 09:41:21,387 INFO manager/write_res/135: write to /opt/x2openEuler/_tmp_18ambppj_/run/9e81f536-517e-11ec-ae65-a01c8dfeddfa/sysconf/hardware_configure.json.
      2021-11-30 09:41:21,396 INFO manager/write_res/135: write to /opt/x2openEuler/_tmp_18ambppj_/run/9e81f536-517e-11ec-ae65-a01c8dfeddfa/sysconf/proc.json.
      2021-11-30 09:41:21,404 INFO manager/write_res/135: write to /opt/x2openEuler/_tmp_18ambppj_/run/9e81f536-517e-11ec-ae65-a01c8dfeddfa/sysconf/system_configure.json.
      2021-11-30 09:41:21,408 INFO manager/write_res/135: write to /opt/x2openEuler/_tmp_18ambppj_/run/9e81f536-517e-11ec-ae65-a01c8dfeddfa/sysconf/system_service.json.
      2021-11-30 09:41:21,412 INFO manager/write_res/135: write to /opt/x2openEuler/_tmp_18ambppj_/run/9e81f536-517e-11ec-ae65-a01c8dfeddfa/sysconf/kernel_configure.json.
      2021-11-30 09:41:21,426 - INFO - Producing report...
      2021-11-30 09:41:21,427 - INFO - Generate Success! The results are saved: /opt/x2openEuler/output/hw_compat_report-20211130094121.html
      

      返回信息中,“/opt/x2openEuler/output/hw_compat_report-20211130094121.html”为评估报告文件。

      常用操作

      查看x2openEuler工具命令参数说明

      须知: 当前x2openEuler工具仅支持在x2openEuler用户下使用,使用前请切换用户为已创建的x2openEuler用户。

      前提条件

      已创建x2openEuler用户。

      已安装x2openEuler工具。

      操作步骤

      1. 使用SSH远程连接工具,以x2openEuler用户登录服务器。

      2. 执行以下命令查看所有命令的参数说明。

        x2openEuler -h

        返回如下命令参数说明信息。

        usage: x2openEuler [-h] [-v]
                               {scan,conf-collect,conf-analyse,hardware-analyse,update}
                               ...
        
        x2openEuler tool chain
        
        optional arguments:
          -h, --help            show this help message and exit
          -v, --version         Display version
        
        subcommands:
          subcommand parser
        
          {scan,conf-collect,conf-analyse,hardware-analyse,update}
            scan                migration assessment tool
            conf-collect        aparser tool
            conf-analyse        analyse system configures and generate report
            hardware-analyse    analyse system hardware and generate report
            update              update data
        

      查看x2openEuler工具版本信息(CLI)

      命令功能

      查看当前安装的x2openEuler工具的版本信息。

      命令格式

      x2openEuler -v
      

      说明: “/opt/x2openEuler”为工具安装目录,请根据实际情况替换。

      使用实例

      查看当前安装的x2openEuler的版本信息。

      x2openEuler -v
      

      返回信息如下所示(其中“x.x.x”表示版本号,请以实际情况为准):

      x2openEuler x.x.x
      

      查看评估报告(CLI)

      前提条件

      已完成评估并生成评估报告。

      操作步骤

      1. 使用SSH远程连接工具,以x2openEuler用户登录服务器。

      2. 执行如下命令进入评估报告目录。

        cd /opt/x2openEuler/output
        
      3. 将需要查看的评估报告通过文件传输工具传输至PC,使用浏览器查看。

        评估报告名称规则如下:

        • yyy-xxx:软件评估报告,yyy为评估的软件名,xxx为评估时间。
        • conf_info_report-xxx:配置评估报告,xxx为评估时间。
        • hw_compat_report-xxx:硬件评估报告,xxx为评估时间。

        说明: IE浏览器可能存在不兼容性,导致评估报告显示不正常。推荐使用Chrome浏览器查看已下载的.html评估报告。

      配置操作系统yum源

      须知: 如果操作系统环境可以联网,且确保操作系统默认yum源可用,则可跳过本章节。

      以下步骤以CentOS 7.6为例,其他操作系统配置yum源的步骤相同。

      1. 从CentOS官网下载CentOS镜像文件“CentOS-7-x86_64-Everything-1810.iso”。

      2. 使用SSH远程登录工具,将CentOS 7.6镜像上传至/root目录。

      3. 使用SSH远程登录工具,进入CentOS操作系统命令行界面。

      4. 执行如下命令将CentOS 7.6的ISO镜像文件挂载到本地目录下。

        mount /root/CentOS-7-x86_64-Everything-1810.iso /media -o loop
        

        须知: 系统重启后需要重新挂载。

      5. 执行如下命令备份原始yum源(mv命令中的“path”表示备份目录,请用实际情况代替)。

        cd /etc/yum.repos.d/      //进入yum源配置目录
        mv ./* path       //备份之前的yum源配置
        
      6. 配置yum源。

        1. 执行如下命令修改“media.repo”文件。

          vi /etc/yum.repos.d/media.repo
          
        2. 按“i”进入编辑模式,在“media.repo”文件中写入如下内容:

          [InstallMedia]
          name=CentOS7.6
          metadata_expire=-1
          gpgcheck=0
          cost=500
          baseurl=file:///media
          enabled=1
          
        3. 按“ESC”,输入“:wq”,按“Enter”保存并退出。

      7. 执行如下命令更新yum源本地缓存信息。

        yum clean all
        yum makecache
        

      查询操作系统的版本信息

      执行uname -a命令查询cpu硬件架构,工具只支持x86或者基于鲲鹏916/920的服务器。

      查询操作系统的版本信息。

      • 若不清楚操作系统类型,用户可以依次执行下列命令查看操作系统的版本信息。

        说明: 根据表18所知,查询工具已兼容的操作系统的命令分成以下四种。

        • cat /etc/os-release
        • cat /etc/issue
        • cat /etc/redhat-release
        • nkvers
      • 若已确定操作系统类型,需要查询具体的发行版本,可以根据表18执行对应的命令查询。

      表 18 查询操作系统版本信息

      工具已兼容的操作系统

      查看操作系统的命令

      操作系统全称

      CentOS 7.6/8.2

      cat /etc/redhat-release

      CentOS 7.6: CentOS Linux release 7.6.1810(AltArch)

      CentOS 8.2: CentOS Linux release 8.2.2001(Core)

      openEuler 20.03 SP1

      cat /etc/os-release

      openEuler 20.03 SP1:openEuler release 20.03(LTS-SP1)

      配置超时机制

      前提条件

      • 已经完成x2openEuler工具部署。
      • 已经完成x2openEuler插件安装。

      操作步骤

      1. 使用SSH远程登录工具,以普通用户进入运行环境命令行界面。

      2. 执行以下命令切换至root用户。

        su - root
        
      3. 执行以下命令修改SSH配置文件“/etc/ssh/sshd_config”。

        vi /etc/ssh/sshd_config
        

        配置如下参数:

        TCPKeepAlive yes
        ClientAliveInterval 60
        ClientAliveCountMax 5
        

        修改完成后,按“Esc”,输入“:wq!”,按“Enter”保存并退出文件编辑。

      4. 重启SSH服务。

      反馈建议

      如对工具及插件有任何建议,请提交issue至以下链接。 问题反馈:https://gitee.com/openeuler/oec-application/issues

      FAQ

      查看评估报告,页面显示不正常

      现象描述

      查看已下载的.html评估报告时,页面显示不正常。

      可能原因

      IE浏览器不兼容评估报告页面,导致评估报告显示不正常。

      处理步骤

      推荐使用Chrome浏览器查看已下载的.html评估报告。

      安装时出现缺少依赖软件包导致安装失败

      现象描述

      安装x2openEuler工具过程中,可能出现缺少依赖软件包,从而导致安装被中断,最终安装失败。缺少依赖软件包的提示信息如下所示。

      图 14 缺少依赖软件包的提示信息

      可能原因

      操作系统中未安装x2openEuler工具安装需要的依赖软件包。

      处理步骤

      1. 根据安装过程中的缺少软件包报错信息,确定待安装的依赖软件包名称,如bzip2,bzip2-devel。

      2. 参考配置操作系统yum源配置yum源。

      3. 执行如下命令安装依赖软件包。

        yum install -y bzip2 bzip2-devel
        

      附录

      运行环境数据使用说明

      注意事项

      请注意,产品功能涉及的数据使用场景如下表19所示,请注意信息保护。

      运行环境数据使用场景说明

      表 19 数据使用信息说明

      收集信息的场景或功能

      收集信息使用的命令或文件

      信息采集必要性

      有无额外收集数据

      信息使用目的

      信息存储及保护措施

      信息销毁

      • 配置与硬件信息收集
      • 配置信息差异分析
      • 硬件兼容性评估
      • /bin/cat /boot/grub2/grub.cfg
      • /usr/sbin/lspci -nvvv
      • /usr/sbin/lspci -xxx
      • /bin/netstat -npl
      • /usr/sbin/sysctl -a
      • /usr/sbin/dmidecode -t bios -t system -t baseboard -t chassis -t processor -t memory -t cache -t connector -t slot
      • /usr/sbin/dmidecode -s system-product-name
      • /bin/cat /boot/efi/EFI/centos/grub.cfg

      必须采集

      用于进行硬件兼容性评估和配置信息差异分析。

      • 硬件兼容性评估采集的数据存放到内存中,不做持久化保存。
      • 配置与硬件信息收集采集的数据,保存在文件中,文件属主、属组为x2openEuler,其他用户无权限。可以通过IDE下载,需要用户自行保存。
      • x2openEuler用户可以删除“/opt/x2openEuler/output/”目录下存储的配置与硬件信息收集采集的数据文件。
      • 工具卸载时会完全删除“/opt/x2openEuler/output/”目录下存储的配置与硬件信息收集采集的数据文件。
      • /boot/grub2/grub.cfg
      • /etc/default/grub
      • /usr/include/asm/unistd_64.h
      • /etc/fstab
      • /etc/profile
      • /etc/sysctl.conf
      • /boot/conifg-*

      必须采集

      用于进行配置差异分析。

      相关链接

      表 20 相关链接

      相关内容

      网址

      openEuler开源社区

      https://www.openeuler.org/zh/

      openEuler开发资源

      https://www.hikunpeng.com/developer/openEuler

      openEuler repo源

      https://repo.openeuler.org/openEuler-20.03-LTS/ISO/

      openEuler oec-application项目交流

      https://gitee.com/openeuler/oec-application

      华为云开源镜像仓

      https://mirrors.huaweicloud.com/repository/conf/CentOS-AltArch-7.repo

      https://mirrors.huaweicloud.com/epel/7/$basearch

      术语

      B

      板卡

      指安装有一块芯片的单板插到另外一块单板上去。

      F

      服务器

      服务器是在网络环境中为客户(Client)提供各种服务的特殊计算机。

      W

      物理机

      与宿主机相对,指部署了普通操作系统的主机或未部署操作系统的裸机。

      X

        

      虚拟机

      在计算机科学中的体系结构里,是指一种特殊的软件,他可以在计算机平台和终端用户之间创建一种环境,而终端用户则是基于这个软件所创建的环境来操作软件。

      缩略语

      B

      BIN

      Binary

      一种二进制文件

      G

      GZIP

      GNU ZIP

      一种文件压缩格式

      J

      JAR

      Java Archive

      一种Java软件包格式文件

      P

      PY

      -

      一种Python的脚本文件

      PYC

      -

      一种二进制文件

      R

      RPM

      RHEL Package Manager

      一种Linux软件包格式

      T

      TAR

      -

      一种Linux软件包格式

      Z

      ZIP

      -

      一种文件压缩格式

      文档捉虫

      “有虫”文档片段

      问题描述

      提交类型 issue

      有点复杂...

      找人问问吧。

      PR

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

      一键搞定!

      问题类型
      规范和低错类

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

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

      ● 英文中包含中文字符;

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

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

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

      易用性

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

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

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

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

      正确性

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

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

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

      ● 代码片段错误;

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

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

      风险提示

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

      内容合规

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

      ● 内容侵权;

      您对文档的总体满意度

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