x2openEuler 用户指南

前言

概述

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

读者对象

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

  • openEuler操作系统的用户
  • 鲲鹏平台的开发者
  • 鲲鹏平台的软件用户
  • ISV开发者

符号约定

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

符号

说明

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

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

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

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

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

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

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

命令行格式约定

格式

意义

粗体

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

斜体

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

[ ]

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

{ x | y | ... }

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

[ x | y | ... ]

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

{ x | y | ... }*

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

[ x | y | ... ]*

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

&<1-n>

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

#

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

修改记录

文档版本

发布日期

修改说明

01

2021-12-30

第一次正式发布。

免责声明

  • 建议您在非生产环境使用本工具,避免影响生产业务运行。
  • 您上传及查阅源码前已确认您为源码所有者或者已获得源码所有者的充足授权同意。
  • 未经所有者授权,任何个人或组织均不得使用该源码从事任何活动。华为公司不对由此造成的一切后果负责,亦不承担任何法律责任。必要时,将追究其法律责任。
  • 未经所有者授权,任何个人或组织均不得私自传播该源码。华为公司不对由此造成的一切后果负责,亦不承担任何法律责任。必要时,将追究其法律责任。
  • 该源码及相关评估报告等,仅做查阅参考,不具有法律效力,也不以任何方式或形式构成特定指引和法律建议。
  • 除非法律法规或双方合同另有规定,华为对本评估建议及相关内容不做任何明示或暗示的声明或保证,不对本评估建议及相关内容的适销性、满意度、非侵权性或特定用途适用性等做出任何保证或承诺。
  • 您根据本评估建议及相关内容所采取的任何行为均由您自行承担风险,华为在任何情况下均不对任何性质的损害或损失负责。
  • 点击确认将上传源码至当前服务器工作目录下,用于源码扫描分析。本工具不会将这些源码用于其他目的,通过其他用户名登录同一台服务器的用户无权查看您工作目录的代码。

工具概述

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

根据支持的特性不同,分为轻量级x2openEuler和全量级x2openEuler。轻量级x2openEuler仅支持配置收集与评估和硬件评估特性,全量级x2openEuler支持全部特性。

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支持在物理机上安装运行,物理机要求如表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

22.03_LTS

x86_64:openEuler-22.03_LTS-everything-x86_64-dvd.iso

aarch:openEuler-22.03_LTS-everything-aarch64-dvd.iso

依赖要求

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

表 5 依赖组件

分类

组件

说明

轻量级x2openEuler工具

bzip2

解压缩工具。

bzip2-devel

解压缩工具。

cmake

自动化构建系统。

dmidecode

查询硬件信息工具包。

gcc

C/C++编译器。

git

版本管理工具。

libxml2

xml解析函数库。

libxml2-devel

xml解析函数库。

libxslt

xml解析库。

libxslt-devel

xml解析库。

net-tools

网络命令工具箱。

python3

python开发运行环境,要求版本3.7及以上。

pciutils

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

redis

数据库,建议版本4.0.11及以上版本。

sqlite

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

说明:

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

util-linux

Linux系统标准软件套件。

zlib

解压缩工具。

zlib-devel

解压缩工具。

全量级x2openEuler工具

bzip2

解压缩工具。

bzip2-devel

解压缩工具。

cmake

自动化构建系统。

dmidecode

查询硬件信息工具包。

gcc

C/C++编译器。

git

版本管理工具。

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总线配置寄存器的可移植库。

redis

数据库,建议版本4.0.11及以上。

rpm-build

rpm包制作管理工具。

sqlite

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

说明:

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

tcl

编译SQLite需要的依赖包。

sqlite-devel

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

util-linux

Linux系统标准软件套件。

zlib

解压缩工具。

zlib-devel

解压缩工具。

获取软件包

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

表 6 获取工具安装包

软件包名称

软件包说明

获取方法

x2openEuler-x.x-x.noarch.rpm

全量级x2openEuler软件安装包

x2openEuler-collect-x.x-x.noarch.rpm

轻量级x2openEuler软件安装包

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

软件数字签名验证

为了防止软件包在传递过程或存储期间被恶意篡改,下载软件包时需下载对应的数字签名文件用于完整性验证。

在软件包下载之后,请参考《OpenPGP签名验证指南》,对从Support网站下载的软件包进行PGP数字签名校验。如果校验失败,请不要使用该软件包,先联系华为技术支持工程师解决。

使用软件包安装/升级之前,也需要按上述过程先验证软件包的数字签名,确保软件包未被篡改。

运营商客户请访问:http://support.huawei.com/carrier/digitalSignatureAction

企业客户请访问:https://support.huawei.com/enterprise/zh/tool/pgp-verify-TL1000000054

安装

前提条件

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

操作步骤

须知:

  • 安装x2openEuler工具需要保证网络连接正常,若操作系统环境不可以联网,则需要先参考配置操作系统yum源配置yum源。

本章以CentOS(x86_64)环境下安装全量级x2openEuler工具为例,轻量级x2openEuler工具安装方法以及其他操作系统环境下安装方法相同。

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

  2. 执行如下命令安装x2openEuler工具的依赖组件。

    yum install -y bzip2 bzip2-devel gcc git java java-devel libffi-devel libxml2-devel libxslt libxslt-devel net-tools openssl-devel pciutils rpm-build sqlite-devel tcl zlib-devel
    
  3. 安装Redis数据库。

    说明: 仅安装全量级x2openEuler工具时需要执行本步骤,安装轻量级x2openEuler工具时则不需要。

    yum install -y redis
    

    若回显信息显示“No package redis available”,表示yum源中缺少Redis软件包,Redis数据库安装失败。请到https://pkgs.org/download/redis网站下载与实际环境匹配的Redis安装包。执行如下命令安装Redis数据库,其中“redis-3.2.12-2.el7.aarch64.rpm”仅为示例,请使用实际下载的Redis安装包进行替换。

    rpm -ivh redis-3.2.12-2.el7.aarch64.rpm
    
  4. 使用SSH远程登录工具,将获取软件包中获取的x2openEuler工具安装包拷贝到自定义路径下。

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

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

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

    rpm -ivh x2openEuler-x.x-x.noarch.rpm
    

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

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

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

  7. 设置x2openEuler用户密码和权限。

    1. 设置x2openEuler用户密码。

      passwd x2openEuler
      

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

      • 密码长度为8~32个字符
      • 必须包含大写字母、小写字母、数字、特殊字符(`~!@#$%^&*()-_=+\|[{}];:'",<.>/?)中的两种及以上类型的组合
      • 密码不能包含空格
      • 密码不能是用户名
    2. 执行如下命令编辑/etc/sudoers文件,提升用户权限。

      visudo
      

      说明: x2openEuler工具需要尽可能的全面采集配置数据,因此需要对x2openEuler用户提升权限以对部分命令进行提权操作。

      /etc/sudoers文件中,在注释## Allow root to run any commands anywhere后添加以下内容允许用户执行配置采集命令。

      ## Allow root to run any commands anywhere
      x2openEuler ALL=(root) NOPASSWD: /bin/cat /boot/grub2/grub.cfg 
      x2openEuler ALL=(root) NOPASSWD: /usr/sbin/lspci -nvvv 
      x2openEuler ALL=(root) NOPASSWD: /usr/sbin/lspci -xxx 
      x2openEuler ALL=(root) NOPASSWD: /bin/netstat -npl 
      x2openEuler ALL=(root) NOPASSWD: /usr/sbin/sysctl -a 
      x2openEuler ALL=(root) NOPASSWD: /usr/sbin/dmidecode -t bios -t system -t baseboard -t chassis -t processor -t memory -t cache -t connector -t slot 
      

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

  8. 执行如下命令切换到x2openEuler用户和x2openEuler用户的家目录(/home/x2openEuler)。

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

    su - x2openEuler
    
  9. 初始化配置Redis数据库。

    说明:

    • 仅安装全量级x2openEuler工具时需要执行本步骤,安装轻量级x2openEuler工具时则不需要。
    • 首次使用x2openEuler工具时需要进行Redis数据库初始化配置,否则在执行x2openEuler工具命令时会出现如下报错信息,无法使用x2openEuler工具。
    Please execute "x2openeuler init" first to complete the environment check
    
    1. 执行如下命令录入Redis数据库IP地址、端口号、数据库索引号(0-16)、数据库密码,此处以本地数据库为例。

      x2openEuler redis-db -init
      
      Please enter the IP address of redis: 127.0.0.1
      Please enter the port of redis: 6379
      Please enter the database index of redis(from 0 to 16): 0
      Please enter the password of redis:
      

      说明: 若Redis密码未设置或者为空时,则按下回车即可。

    2. 执行如下命令导入资源包到Redis数据库,此处以导入安装x2openEuler工具时的默认资源包为例。

      x2openEuler init /opt/x2openEuler/source_centos7.6-openEuler22.03_LTS.tar.gz
      

验证

  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用户,以保证系统环境安全。

特性指南

软件评估

特性描述

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

特性操作

通过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
参数说明

表 7 参数说明

命令

参数选项

说明

-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

目标操作系统

可选参数

默认参数为openEuler22.03_LTS

例如"-target_os_name openEuler22.03_LTS" #选择目标操作系统为openEuler22.03_LTS

说明:

当前目标操作系统仅支持openEuler22.03_LTS 。

-

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 batch scan 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 openEuler22.03_LTS -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“为评估报告文件。

配置收集与评估

特性描述

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

特性操作

通过CLI命令进行配置信息和硬件信息收集
前提条件

须知: 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用户的家目录。

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

命令功能

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

命令格式
x2openEuler conf-analyse [-os_name OS_NAME][-target_os_name TARGET_OS_NAME] [-local | -load LOAD [-arch ARCH]]
参数说明

表 8 参数说明

命令

参数选项

说明

-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

目标操作系统

可选参数

默认参数为openEuler22.03_LTS

例如"-target_os_name openEuler22.03_LTS" #选择目标操作系统为openEuler22.03_LTS

说明:

当前目标操作系统仅支持openEuler22.03_LTS 。

-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 openEuler22.03_LTS -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“为评估报告文件。

硬件评估

特性描述

须知: 建议硬件评估任务在物理机上进行,若在虚拟机上执行硬件信息分析,则无法产生分析报告。

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

特性操作

通过CLI命令进行硬件信息分析
前提条件

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

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

命令功能

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

命令格式
x2openEuler hardware-analyse [-local | -load LOAD]
参数说明

表 9 参数说明

命令

参数选项

说明

-local

-

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

可选参数

默认参数为-local

例如

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

-load

LOAD

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

例如

"x2openEuler conf-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,init,redis-db}
                           ...
    
    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,init,redis-db}
        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
        init                init config libraries and environment check
        redis-db            Redis database configuration initialization and update
    
    

查看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 -r命令查询cpu硬件架构,工具只支持x86或者基于鲲鹏916/920的服务器。

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

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

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

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

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

工具已兼容的操作系统

查看操作系统的命令

操作系统全称

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 22.03_LTS

cat /etc/os-release

openEuler 22.03_LTS:openEuler release 22.03_LTS

FAQ

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

现象描述

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

可能原因

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

处理步骤

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

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

现象描述

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

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

可能原因

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

处理步骤

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

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

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

    yum install -y bzip2 bzip2-devel
    

附录

相关链接

表 11 相关链接

相关内容

网址

openEuler开源社区

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

openEuler开发资源

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

openEuler repo源

https://repo.openeuler.org/openEuler-22.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

-

一种文件压缩格式

有奖捉虫 help

“有虫”文档片段

0/500

存在的问题

文档存在风险与错误

● 拼写,格式,无效链接等错误;

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

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

● 版本号不匹配:文档版本或内容描述和实际软件不一致;

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

● 排版不美观,影响阅读;

内容描述不清晰

● 描述存在歧义;

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

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

内容获取有困难

● 很难通过搜索引擎,openEuler官网,相关博客找到所需内容;

示例代码错误

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

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

内容有缺失

● 关键步骤错误或缺失,无法指导用户完成任务,比如安装、配置、部署等;

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

0/500

您对文档的总体满意度

非常不满意
非常满意

请问是什么原因让您参与到这个问题中

您的邮箱

创Issue赢奖品
根据您的反馈,会自动生成issue模板。您只需点击按钮,创建issue即可。

一共有个关于的结果