0. 工具说明

社区网站发布通过OSV认证的厂商及版本号，对外价值 — 确保根生态一致性，核心特性继承，生态可复用；对内价值 — 反生态分裂识别，保障技术路线演进，OSV认证方案：聚焦openEuler内核和基础包，约束伙伴二次发行版生态核心特性不丢失，关键配置不更改

Compatible全量换标版本（暂不对外公布）

在Compatible 深度基础上，软件包版本、特性、配置、补丁全部保持一致，主要更换了发型版版本信息，与openEuler 仓库100%复用。

Compatible深度：主力行业场景生态复用（对外公布，通用OSV）

在Compatible 基础基础上，检测生态复用，扩展竞争力特性(etmem、热升级、isulad)继承检测；扩展标准包到L2包一致性，主流行业应用生态复用度90%。检查发行版是否结合社区选包策略及软件包等级策略，检查L1、L2软件包版本、打包方式、接口一致性，实现扩展仓库openEuler系共享、共用。

Compatible基础：特性/配置继承 (对外公布，企业OSV)

主要检测openEuler 技术路线，是否有反分裂行为，核心包L1(内核、glibc)及包管理体系一致性，KABI白名单，架构特性(如鲲鹏/X86特性)使能，性能优化配置。检查发行版是否技术路线一致，是否有反分裂行为，核心包一致性，如支持鲲鹏补丁、X86补丁、isulad、热升级等特性合入，充分发挥openEuler竞争力特性。

检查项

验证项

1. 运行环境

1.1. oecp运行环境依赖组件

1.2. oecp理论运行资源

在运行oecp分析之前，确保虚拟机或物理机的运行规格大于等于2U8G，运行前建议重启虚拟机，保证空闲内存足够，建议oecp所在目录空闲磁盘至少保留20GB（具体以实际扫描rpm包数量为准）

1.3. oecp网络需求

除了相关组件安装，oecp可完全离线运行，无需连接网络

2. 软件目录结构

3. 主要功能介绍

oecp工具适用于比较两个ISO镜像之间的差别，具体比较项有：

1）仓库rpm的packagelist（两个仓库包名、版本号、release号比较），对应报告比较类型如下：

• rpm package name
• rpm filelist

2）abi（库文件接口）、jabi（java接口）、config（rpm包内配置文件差异）、kabi（内核abi）、kconfig（内核配置文件），对应报告比较类型如下：

• rpm abi
• rpm jabi
• rpm config
• rpm kabi
• rpm kconfig

3）provides（rpm的provides）、requires（rpm的依赖）等, 对应报告比较类型如下：

• rpm provides
• rpm requires

4）unixbench, lmbench, mysql性能测试，对应报告比较类型如下：

• performacne

5）服务命令起停测试，对应报告比较类型如下：

• rpm test

4. oecp下载安装与部署

install abidiff (centos): ''' yum install -y epel-release yum install -y libabigail '''

install japi: ''' git clone https://github.com/lvc/japi-compliance-checker cd japi-compliance-checker sudo make install prefix=/usr '''

install oecp: ''' git clone https://gitee.com/lovelijunyi/oecp cd oecp pip3 install -r requirement '''

5. oecp使用

使用前，安装python依赖库 pip3 install -r requirement

python3 cli.py [-h] [-n PARALLEL] [-w WORK_DIR] [-p PLAN_PATH] [-c CATEGORY_PATH] [-b PERF_BASELINE_FILE] [-a {x86_64,aarch64}] [-f OUTPUT_FORMAT] [-o OUTPUT_FILE] file1 file2

• 位置参数(必选)

  • file 指定两个比较的iso文件

• 可选参数

  • -n, --parallel 指定进程池并发数量，默认cpu核数

  • -w, --work-dir 指定工作路径，默认路径为/tmp/oecp

  • -p, --plan 指定比较计划，默认为oecp/conf/plan/all.json

  • -c, --category 指定包级别信息，默认为oecp/conf/category/category.json

  • -b, --baseline 指定基线文件，默认为oecp/conf/performance/openEuler-20.03-LTS-aarch64-dvd.iso.performance.json

  • -f, --format 指定输出格式，默认为csv

  • -o, --output 指定输出结果路径，默认为/tmp/oecp

• 举例

  • python3 cli.py /root/openEuler-20.03-LTS-aarch64-dvd.iso /root/openEuler-20.03-LTS-SP1-aarch64-dvd.iso

• 比较计划说明

  • all.json 涵盖下面所有配置项的比较
  • abi.json 比较rpm包中so库文件的abi接口，需依赖RPMExtractDumper（提取解压rpm的dumper类）
  • config_file.json 比较rpm包中配置文件内容的差异，需依赖RPMExtractDumper（提取解压rpm的dumper类）
  • filelist.json 比较rpm包文件列表差异，可通过rpm -pql ${rpm_path}命令获取rpm文件列表
  • jabi.json 比较rpm中jar包的java接口，需依赖RPMExtractDumper（提取解压rpm的dumper类）
  • kabi.json 比较内核rpm包的abi接口，需依赖RPMExtractDumper（提取解压rpm的dumper类） 默认白名单为aarch64，如需要比较x86需要更换"white_list": "kabi_whitelist/x86_64"
  • kconfig.json 比较内核配置文件，需依赖RPMExtractDumper（提取解压rpm的dumper类）
  • package_list.json 比较两个rpm集合包名称、版本、发行版本的差异
  • provides_requires.json 比较rpm的provides和requires差异，可通过rpm -pq --provides/requires ${rpm_path}查询

6. 软件卸载与环境清理

7. 常见问题与处理