新手入门：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
在线安装方式（推荐）
如果您的测试机能够连接网络，这是最简单的安装方式：
- 首先配置openEuler官方repo源
- 使用dnf命令安装客户端和服务端
# 安装客户端 dnf install oec-hardware # 安装服务端 dnf install oec-hardware-server离线安装方式
对于无法连接外网的环境，可以采用离线安装：
- 下载openEuler官方的everything ISO镜像
- 挂载本地repo源
- 从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框架会默认扫描所有网卡，但建议：
- 测试前自行筛选被测网卡
- 确保测试端口连通，状态为up
- 不要使用业务网口进行网卡测试
- 如果是工具自动添加的IP地址，测试完成后服务端的IP需手动删除
图：网卡兼容性测试结果展示
🧪 第五步：开始测试与结果查看
启动测试流程
启动客户端工具
oech选择测试类别
- 输入
1选择兼容性测试（compatible） - 输入
2选择虚拟化测试（virtualization）
- 输入
填写配置信息
- ID：建议填写gitee上的issue ID（不能带特殊字符）
- URL：填写产品链接
- Server：填写服务端域名或IP地址
选择测试套件工具会自动扫描硬件并显示可用的测试项，您可以选择：
- 输入具体数字选择单个测试项
- 输入
all全选 - 输入
none全取消 - 必测项
system不可取消
开始测试输入
run开始执行测试
测试结果查看
测试完成后，您可以通过多种方式查看结果：
本地日志查看：测试日志保存在/usr/share/oech/logs/目录下
Web界面查看：
- 浏览器打开服务端IP地址
- 点击导航栏
Results界面 - 找到对应的测试ID进入查看详细结果
图：Web界面测试结果汇总页面
结果说明
测试结果分为两种状态：
- PASS：测试通过 ✅
- FAIL：测试失败 ❌
如果结果为FAIL，可以点击结果查看详细执行日志，根据报错信息进行问题排查。
图：单个任务的详细测试结果展示
💡 实用技巧与注意事项
测试前准备建议
- 网络连通性：确保测试机之间网络互通
- 驱动安装：对于GPU、VGPU、keycard等特殊硬件，需要提前安装外部驱动
- 磁盘空间：memory测试需要足够的swap空间（建议10G以上）
- 时间同步：确保所有测试机时间同步
常见问题处理
如果测试过程中遇到问题，可以：
- 查看
/usr/share/oech/logs/下的详细日志 - 参考 docs/test_guide_doc/oech_test_guide.md 中的测试指导
- 访问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），仅供参考