新手入门：oec-hardware安装与配置的5个关键步骤

新手入门：oec-hardware安装与配置的5个关键步骤

【免费下载链接】oec-hardwareUse for check hardware compatibility with openEuler项目地址: https://gitcode.com/openeuler/oec-hardware

前往项目官网免费下载：https://ar.openeuler.org/ar/

oec-hardware是openEuler社区提供的专业硬件兼容性测试工具，专门用于验证服务器整机、板卡与openEuler操作系统的兼容性。无论您是硬件厂商还是系统管理员，掌握oec-hardware的正确安装与配置方法都是确保硬件与openEuler系统完美兼容的基础。本文将为您详细介绍5个关键步骤，帮助您快速上手这款强大的兼容性测试工具。

🚀 第一步：环境准备与系统要求

在开始安装oec-hardware之前，您需要确保测试环境满足基本要求。这是保证测试准确性的基础！

系统版本要求

oec-hardware支持在openEuler 20.03 (LTS)或更高版本上运行。您可以通过以下命令检查当前系统版本：

cat /etc/openEuler-release

系统内核版本的支持情况可以在 scripts/kernelrelease.json 文件中查看。

硬件环境配置

根据测试类型的不同，环境要求有所差异：

整机测试环境要求：

  • 至少需要两台整机，业务网口互通
  • 硬件至少包含一张RAID卡和一张网卡（包括集成主板硬件）
  • 内存建议满配

板卡测试环境要求：

  • 服务器型号需为Taishan200(Model 2280)、2288H V5或同等类型
  • RAID卡需要配置至少RAID0
  • 网卡/IB卡需要服务端和测试端分别插入同类型板卡
  • 配置同网段IP，保证直连互通

图：oec-hardware测试环境组网示意图

📦 第二步：获取与安装oec-hardware

在线安装方式（推荐）

如果您的测试机能够连接网络，这是最简单的安装方式：

  1. 首先配置openEuler官方repo源
  2. 使用dnf命令安装客户端和服务端
# 安装客户端 dnf install oec-hardware # 安装服务端 dnf install oec-hardware-server

离线安装方式

对于无法连接外网的环境，可以采用离线安装：

  1. 下载openEuler官方的everything ISO镜像
  2. 挂载本地repo源
  3. 从openEuler官方repo的update目录获取最新软件包

验证安装成功

安装完成后，可以通过以下命令验证：

# 客户端验证 oech # 服务端验证 systemctl status oech-server.service

如果看到工具正常启动界面，说明安装成功！

⚙️ 第三步：服务端配置与启动

服务端配置是oec-hardware正常运行的关键环节，请仔细按照以下步骤操作。

启动服务

oec-hardware服务端通过搭配nginx提供Web服务，默认使用80端口：

# 启动oec-hardware服务 systemctl start oech-server.service # 启动nginx服务 systemctl start nginx.service

防火墙与SELinux配置

为了确保服务正常访问，需要关闭防火墙和SELinux：

# 关闭防火墙 systemctl stop firewalld iptables -F # 关闭SELinux setenforce 0

端口配置说明

如果服务端安装完成后需要修改默认端口，可以通过nginx配置文件进行调整。默认情况下，客户端连接时只需要输入服务端的业务IP地址；如果修改了端口，需要带上端口号，如：172.167.145.2:90。

图：系统测试结果展示界面

🔧 第四步：测试配置文件设置

oec-hardware提供了灵活的测试配置选项，您可以根据实际测试需求进行调整。

配置文件位置

主要配置文件位于：

  • /usr/share/oech/lib/config/test_config.yaml- 硬件测试项配置文件模板

关键配置项

对于不同的硬件测试项，配置要求不同：

需要预先配置的测试项：

  • FC卡测试
  • RAID卡测试
  • Disk磁盘测试
  • Ethernet网卡测试
  • Infiniband卡测试

无需配置的测试项：

  • System系统测试
  • Memory内存测试
  • CPU频率测试
  • 其他基本功能测试

网卡测试注意事项

oec-hardware框架会默认扫描所有网卡，但建议：

  1. 测试前自行筛选被测网卡
  2. 确保测试端口连通，状态为up
  3. 不要使用业务网口进行网卡测试
  4. 如果是工具自动添加的IP地址，测试完成后服务端的IP需手动删除

图：网卡兼容性测试结果展示

🧪 第五步：开始测试与结果查看

启动测试流程

  1. 启动客户端工具

    oech

  2. 选择测试类别

    • 输入1选择兼容性测试（compatible）
    • 输入2选择虚拟化测试（virtualization）

  3. 填写配置信息

    • ID：建议填写gitee上的issue ID（不能带特殊字符）
    • URL：填写产品链接
    • Server：填写服务端域名或IP地址

  4. 选择测试套件工具会自动扫描硬件并显示可用的测试项，您可以选择：

    • 输入具体数字选择单个测试项
    • 输入all全选
    • 输入none全取消
    • 必测项system不可取消

  5. 开始测试输入run开始执行测试

测试结果查看

测试完成后，您可以通过多种方式查看结果：

本地日志查看：测试日志保存在/usr/share/oech/logs/目录下

Web界面查看：

  1. 浏览器打开服务端IP地址
  2. 点击导航栏Results界面
  3. 找到对应的测试ID进入查看详细结果

图：Web界面测试结果汇总页面

结果说明

测试结果分为两种状态：

  • PASS：测试通过 ✅
  • FAIL：测试失败 ❌

如果结果为FAIL，可以点击结果查看详细执行日志，根据报错信息进行问题排查。

图：单个任务的详细测试结果展示

💡 实用技巧与注意事项

测试前准备建议

  1. 网络连通性：确保测试机之间网络互通
  2. 驱动安装：对于GPU、VGPU、keycard等特殊硬件，需要提前安装外部驱动
  3. 磁盘空间：memory测试需要足够的swap空间（建议10G以上）
  4. 时间同步：确保所有测试机时间同步

常见问题处理

如果测试过程中遇到问题，可以：

  1. 查看/usr/share/oech/logs/下的详细日志
  2. 参考 docs/test_guide_doc/oech_test_guide.md 中的测试指导
  3. 访问openEuler官方论坛获取社区支持

兼容性清单发布

通过oec-hardware测试的硬件产品，openEuler会在社区官网发布兼容性清单。测试完成后，需要将以下文件上传至相关的适配issue：

  • oec-hardware测试日志
  • oec-hardware-server生成的HTML测试报告
  • 兼容性清单文件（参考 templates/ 目录下的模板）

🎯 总结

掌握oec-hardware的安装与配置是进行硬件兼容性测试的第一步。通过本文介绍的5个关键步骤——环境准备、软件安装、服务端配置、测试设置、执行测试——您已经具备了使用这款工具的基本能力。

oec-hardware作为openEuler社区的重要工具，不仅简化了硬件兼容性测试流程，还提供了完善的测试报告和结果分析功能。无论您是进行整机测试还是板卡测试，都能获得准确可靠的兼容性验证结果。

记住，成功的硬件兼容性测试始于正确的安装配置。现在就开始您的oec-hardware之旅，为openEuler生态的硬件兼容性贡献一份力量吧！ 🚀

更多详细信息和高级用法，请参考项目文档中的 详细测试指导 和 测试套件说明。

【免费下载链接】oec-hardwareUse for check hardware compatibility with openEuler项目地址: https://gitcode.com/openeuler/oec-hardware

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考