x2openEuler 用户指南(630)
前言
概述
本文档介绍了获取x2openEuler工具安装包,以及对其进行安装、使用的方法,对x2openEuler插件的操作界面及各项功能做了详细介绍。
读者对象
本文档主要适用于以下人员:
- openEuler操作系统用户
- 软件开发者
符号约定
在本文中可能出现下列标志,它们所代表的含义如下。
命令行格式约定
修改记录
免责声明
须知: 工具会对部分命令进行提权操作,用于进行硬件评估及配置分析。具体命令如下:
- /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 硬件要求
| |
虚拟机要求
x2openEuler支持安装在虚拟机上运行,虚拟机要求如表2所示。
表 2 虚拟机要求
源操作系统要求
运行环境操作系统要求表3所示。
表 3 源操作系统要求
说明: 如果当前服务器环境无法联网或修改过操作系统yum源,工具安装过程中需要操作系统镜像文件用于安装依赖包,所需操作系统镜像文件请参见表3,请自行获取对应操作系统版本的镜像文件。
目标操作系统要求
目标操作系统要求表4所示。
表 4 目标操作系统要求
依赖要求
x2openEuler自动安装的依赖组件如表5所示。
表 5 依赖组件
获取软件包
安装过程中所需软件包如表6所示。
表 6 获取工具安装包
|
说明: 软件包名称中的“x.x-x”表示版本号。
安装
前提条件
- 已准备用于安装x2openEuler工具的x86服务器或者基于鲲鹏916/920的服务器。
- 已安装操作系统,操作系统版本要求请参见表3。
- 已安装远程SSH登录工具,如Xshell、MobaXterm、PuTTY等。
操作步骤
须知:
- 安装x2openEuler工具需要保证网络连接正常,若操作系统环境不可以联网,则需要先参考配置操作系统yum源配置yum源。
- 重新安装前需要卸载其他版本的x2openEuler工具。
本章以CentOS(x86_64)环境下安装x2openEuler工具为例,可以通过以下两种方式安装x2openEuler工具:
选择手动下载并在服务器上安装x2openEuler工具
使用SSH远程登录工具,以普通用户进入CentOS操作系统命令行界面。
执行以下命令切换至root用户。
su - root
使用SSH远程登录工具,将获取软件包中获取的x2openEuler工具安装包拷贝到自定义路径下。
执行如下命令进入存放x2openEuler工具安装包的自定义路径。
cd 自定义路径
执行如下命令安装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:”提示信息时,表示缺少依赖软件包,请参考安装时出现缺少依赖软件包导致安装失败进行处理。
设置x2openEuler用户密码。
passwd x2openEuler
说明: 登录用户的密码。密码建议满足如下复杂度要求:
- 密码长度为8~32个字符
- 必须包含大写字母、小写字母、数字、特殊字符(`~!@#$%^&*()-_=+\|[{}];:'",<.>/?)中的两种及以上类型的组合
- 密码不能包含空格
- 密码不能是用户名
执行如下命令切换到x2openEuler用户和x2openEuler用户的家目录(/home/x2openEuler)。
须知: x2openEuler工具仅支持在x2openEuler用户下使用,使用前请务必切换用户为x2openEuler用户,同时建议将工作目录切换为x2openEuler用户的家目录。
su - x2openEuler
选择使用插件部署功能一键式安装
安装x2openEuler插件后,单击
,阅读并确认接受免责声明后,进入x2openEuler插件配置指引界面。选择“x2openEuler工具部署”进入工具部署界面。
在工具部署界面,配置工具部署参数进行x2openEuler工具安装,参数描述如表7。
表 7 配置工具部署参数说明
单击“开始部署”后,进入“安装前准备”界面。设置x2openEuler用户密码,若目标服务器未联网则需上传x2openEuler软件安装包。单击“下一步”进行工具部署。
说明: 设置的密码需要满足如下复杂度要求:
- 密码长度为8~32个字符
- 必须包含大写字母、小写字母、数字、特殊字符(`~!@#$%^&*()-_=+\|[{}];:'",<.>/?)中的两种及以上类型的组合
- 密码不能包含空格
- 密码不能是用户名
工具部署安装完成后,界面会提示“x2openEuler工具部署成功”,可单击“配置远端服务器”,参考配置远端服务器进行配置。若工具部署失败,请参考VS Code底部输出框信息重新进行工具部署。
验证
验证安装的插件模式
登录x2openEuler插件界面,详细步骤请参见通过插件使用x2openEuler工具,能够成功登录说明x2openEuler工具安装成功。
验证安装的CLI模式
使用SSH远程登录工具,以任意用户进入CentOS操作系统命令行界面。
执行以下命令,切换至x2openEuler用户。
su - x2openEuler
执行如下命令查看版本信息。
x2openEuler -v
显示如下格式内容说明安装成功(其中“x.x.x”表示版本号,请以实际情况为准)。
x2openEuler x.x.x
卸载
前提条件
没有正在运行中的任务。
操作步骤
使用SSH远程登录工具,以root用户进入操作系统命令行界面。
执行如下命令卸载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插件。
操作步骤
在VS Code左侧菜单栏,单击
打开x2openEuler插件。
在VS Code左侧侧边栏,单击“配置远端服务器”,打开如图1所示界面,参数描述如表8所示。
表 8 配置远端服务器参数说明
根据实际环境输入各参数值,单击“开始配置”。
配置成功后,进入“x2openEuler向导”界面,如图5所示。在“x2openEuler向导”中可立即创建评估任务。
远端服务器管理
前提条件
- 已成功安装x2openEuler插件。
- 已完成配置远端服务器。
操作步骤
在VS Code左侧侧边栏选中“远端服务器管理”,单击
进行配置远端服务器。
在VS Code左侧侧边栏选择“远端服务器管理”,单击
清空服务器记录。在右下角弹出框中,选择“确定”清空服务器记录。
在VS Code左侧侧边栏选择“远端服务器管理”,单击
展开服务器记录列表。选中任意服务器记录,可单击
进行删除服务器记录,单击
进行编辑服务器。
软件评估
特性描述
软件迁移评估帮助用户完成从CentOS 7.6(CentOS 8.2、CentOS 6.8)向openEuler 20.03 LTS SP1系统的迁移评估。
特性操作
前提条件
已安装x2openEuler插件并配置远端服务器成功。
已完成x2openEuler工具部署。
操作步骤
在页面左侧,选择“软件评估”,点击
创建任务。
在创建分析任务区选择“单应用”或“多应用”,并对以下参数进行配置。
说明: “单应用”和“多应用”相互独立,可根据实际需求选择其中的一个。
表 9 创建软件评估参数项说明
- 单应用:支持rpm/tar/zip/gzip/jar/py/pyc/sh/bin软件包。
- 多应用:支持对同一目录下的多个bin文件进行评估分析,并对每个bin文件产生评估报告。
- CentOS 6.8
- CentOS 7.6
- CentOS 8.2
- x86_64
- aarch64
单击“开始评估”,生成评估报告。
评估完成后,自动跳转至分析报告详情界面,如图9所示,参数描述如表10所示。
说明:
- 用户可在任务进行过程中单击“取消评估”,取消评估任务。
- 用户可以在历史报告的列表中,单击指定分析任务的报告名称查看分析报告。
- 分析报告的名称为扫描的软件包名称和生成报告的时间组合。
表 10 软件评估报告结果参数说明
返回创建任务页面,在右侧历史报告中,可进行软件评估报告下载、删除等操作。
说明: 评估报告存储在运行环境的“/opt/x2openEuler/output/”目录下,从页面历史报告中进行的删除操作不会完全移除评估报告,如需完全移除,请在运行环境中进行删除操作。
配置收集与评估
特性描述
配置与收集评估功能帮助用户自动识别当前服务器环境架构,同时从用户环境收集配置信息进行评估分析。
特性操作
前提条件
已安装x2openEuler插件并配置远端服务器成功。
已完成x2openEuler工具部署。
操作步骤
在页面左侧,选择“配置收集与评估”,点击
创建任务。
在创建分析任务区选择“评估”或“收集”,并对以下参数进行配置。
说明:
- “评估”和“收集”相互独立,可根据实际需求选择其中的一个。
- “评估”既能评估当前服务器环境配置信息,也可以通过“外部导入”对其他服务器环境进行分析。
表 11 创建配置收集与评估参数项说明
- 评估:自动识别当前服务器环境架构及配置信息进行评估。
- 收集:对当前服务器配置信息和硬件信息进行收集。
- 本地扫描:对当前服务器环境进行配置信息扫描与收集。
- 外部导入:上传通过配置与评估中收集的信息,格式为tar.gz。
- CentOS 6.8
- CentOS 7.6
- CentOS 8.2
- x86_64
- aarch64
单击“开始评估”,生成评估报告。
评估完成后,自动跳转至分析报告详情界面,如图11所示,参数描述如表12所示。
说明:
- 用户可在任务进行过程中单击取消评估,取消评估任务。
- 用户可以在分析报告的列表中,单击指定分析任务的报告名称查看分析报告。
表 12 配置收集与评估报告结果参数说明
返回创建任务页面,在右侧历史报告中,可进行配置评估报告下载、删除等操作。
说明: 评估报告存储在运行环境的“/opt/x2openEuler/output/”目录下,从页面历史报告中进行的删除操作不会完全移除评估报告,如需完全移除,请在运行环境中进行删除操作。
硬件评估
特性描述
硬件评估功能支持用户环境收集硬件信息进行分析评估。
说明: 硬件评估任务只能在物理机上进行。
特性操作
前提条件
已安装x2openEuler插件并配置远端服务器成功。
已完成x2openEuler工具部署。
操作步骤
在页面左侧,选择“硬件评估”,点击
创建任务。
在创建分析任务区选择“本地扫描”或“外部导入”,并对以下参数进行配置。
说明:
- “本地扫描”和“外部导入”相互独立,可根据实际需求选择其中的一个。
- “硬件评估”建议在物理环境中执行。
表 13 创建配置收集与评估参数项说明
- 本地扫描:自动扫描收集当前服务器硬件配置信息进行评估。
- 外部导入:导入通过配置与评估中收集的信息,格式为tar.gz。
单击“开始评估”,生成评估报告。
评估完成后,自动跳转至分析报告详情界面,如图13所示,参数描述如表14所示。
说明:
- 用户可在任务进行过程中单击取消评估,取消评估任务。
- 用户可以在分析报告的列表中,单击指定分析任务的报告名称查看分析报告。
表 14 硬件评估报告结果参数说明
板卡兼容必须满足 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 参数说明
使用实例
此处以评估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 参数说明
例如"-target_os_name openEuler20.03-LTS-SP1" #选择目标操作系统为openEuler20.03-LTS-SP1 | ||
"x2openEuler conf-analyse -load file_Name.tar.gz" #选择分析数据为外部导入数据 | ||
使用实例
此处以评估从外部导入的“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 参数说明
"x2openEuler hardware-analyse -load file_Name.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工具。
操作步骤
使用SSH远程连接工具,以x2openEuler用户登录服务器。
执行以下命令查看所有命令的参数说明。
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)
前提条件
已完成评估并生成评估报告。
操作步骤
使用SSH远程连接工具,以x2openEuler用户登录服务器。
执行如下命令进入评估报告目录。
cd /opt/x2openEuler/output
将需要查看的评估报告通过文件传输工具传输至PC,使用浏览器查看。
评估报告名称规则如下:
- yyy-xxx:软件评估报告,yyy为评估的软件名,xxx为评估时间。
- conf_info_report-xxx:配置评估报告,xxx为评估时间。
- hw_compat_report-xxx:硬件评估报告,xxx为评估时间。
说明: IE浏览器可能存在不兼容性,导致评估报告显示不正常。推荐使用Chrome浏览器查看已下载的.html评估报告。
配置操作系统yum源
须知: 如果操作系统环境可以联网,且确保操作系统默认yum源可用,则可跳过本章节。
以下步骤以CentOS 7.6为例,其他操作系统配置yum源的步骤相同。
从CentOS官网下载CentOS镜像文件“CentOS-7-x86_64-Everything-1810.iso”。
使用SSH远程登录工具,将CentOS 7.6镜像上传至/root目录。
使用SSH远程登录工具,进入CentOS操作系统命令行界面。
执行如下命令将CentOS 7.6的ISO镜像文件挂载到本地目录下。
mount /root/CentOS-7-x86_64-Everything-1810.iso /media -o loop
须知: 系统重启后需要重新挂载。
执行如下命令备份原始yum源(mv命令中的“path”表示备份目录,请用实际情况代替)。
cd /etc/yum.repos.d/ //进入yum源配置目录 mv ./* path //备份之前的yum源配置
配置yum源。
执行如下命令修改“media.repo”文件。
vi /etc/yum.repos.d/media.repo
按“i”进入编辑模式,在“media.repo”文件中写入如下内容:
[InstallMedia] name=CentOS7.6 metadata_expire=-1 gpgcheck=0 cost=500 baseurl=file:///media enabled=1
按“ESC”,输入“:wq”,按“Enter”保存并退出。
执行如下命令更新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 查询操作系统版本信息
配置超时机制
前提条件
- 已经完成x2openEuler工具部署。
- 已经完成x2openEuler插件安装。
操作步骤
使用SSH远程登录工具,以普通用户进入运行环境命令行界面。
执行以下命令切换至root用户。
su - root
执行以下命令修改SSH配置文件“/etc/ssh/sshd_config”。
vi /etc/ssh/sshd_config
配置如下参数:
TCPKeepAlive yes ClientAliveInterval 60 ClientAliveCountMax 5
修改完成后,按“Esc”,输入“:wq!”,按“Enter”保存并退出文件编辑。
重启SSH服务。
反馈建议
如对工具及插件有任何建议,请提交issue至以下链接。 问题反馈:https://gitee.com/openeuler/oec-application/issues
FAQ
查看评估报告,页面显示不正常
现象描述
查看已下载的.html评估报告时,页面显示不正常。
可能原因
IE浏览器不兼容评估报告页面,导致评估报告显示不正常。
处理步骤
推荐使用Chrome浏览器查看已下载的.html评估报告。
安装时出现缺少依赖软件包导致安装失败
现象描述
安装x2openEuler工具过程中,可能出现缺少依赖软件包,从而导致安装被中断,最终安装失败。缺少依赖软件包的提示信息如下所示。
可能原因
操作系统中未安装x2openEuler工具安装需要的依赖软件包。
处理步骤
根据安装过程中的缺少软件包报错信息,确定待安装的依赖软件包名称,如bzip2,bzip2-devel。
参考配置操作系统yum源配置yum源。
执行如下命令安装依赖软件包。
yum install -y bzip2 bzip2-devel
附录
运行环境数据使用说明
注意事项
请注意,产品功能涉及的数据使用场景如下表19所示,请注意信息保护。
运行环境数据使用场景说明
表 19 数据使用信息说明
相关链接
表 20 相关链接
https://mirrors.huaweicloud.com/repository/conf/CentOS-AltArch-7.repo |
术语
在计算机科学中的体系结构里,是指一种特殊的软件,他可以在计算机平台和终端用户之间创建一种环境,而终端用户则是基于这个软件所创建的环境来操作软件。 |