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

📅 2026/6/30 17:12:41
新手入门: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会在社区官网发布兼容性清单。测试完成后需要将以下文件上传至相关的适配issueoec-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),仅供参考