diff --git a/docs/pictures/fc-1.png b/docs/pictures/fc-1.png new file mode 100644 index 0000000000000000000000000000000000000000..446644befb700ede20678908aad0be37ea9a0efd Binary files /dev/null and b/docs/pictures/fc-1.png differ diff --git a/docs/pictures/fc-2.png b/docs/pictures/fc-2.png new file mode 100644 index 0000000000000000000000000000000000000000..e2714b239d9483a5596d8423b551aaea7bc787f9 Binary files /dev/null and b/docs/pictures/fc-2.png differ diff --git a/docs/pictures/fc-3.png b/docs/pictures/fc-3.png new file mode 100644 index 0000000000000000000000000000000000000000..e9e221cb98e6d9aca8e1eb5170fcbb4e9eb6c7f0 Binary files /dev/null and b/docs/pictures/fc-3.png differ diff --git a/docs/pictures/fc-4.png b/docs/pictures/fc-4.png new file mode 100644 index 0000000000000000000000000000000000000000..e1f0c0639c789e76bc989a1dc13a438592bef61b Binary files /dev/null and b/docs/pictures/fc-4.png differ diff --git a/docs/pictures/nic-1.png b/docs/pictures/nic-1.png new file mode 100644 index 0000000000000000000000000000000000000000..49dcd555e91f797b2dfde85545d0e5efa80eb86a Binary files /dev/null and b/docs/pictures/nic-1.png differ diff --git a/docs/pictures/nic-2.png b/docs/pictures/nic-2.png new file mode 100644 index 0000000000000000000000000000000000000000..5d0baad1857ec402a42bee713a7033b9b13e25b6 Binary files /dev/null and b/docs/pictures/nic-2.png differ diff --git a/docs/pictures/nic-3.png b/docs/pictures/nic-3.png new file mode 100644 index 0000000000000000000000000000000000000000..d6a1402e1bb6d44f29431f4274c4ccafef631c52 Binary files /dev/null and b/docs/pictures/nic-3.png differ diff --git a/docs/pictures/raid-1.png b/docs/pictures/raid-1.png new file mode 100644 index 0000000000000000000000000000000000000000..ba06ab98b9269be4595fd80b20fcaaa1988f9ca9 Binary files /dev/null and b/docs/pictures/raid-1.png differ diff --git a/docs/pictures/raid-2.png b/docs/pictures/raid-2.png new file mode 100644 index 0000000000000000000000000000000000000000..52de869c7bb69ed06fbe0184eda693092471ed0f Binary files /dev/null and b/docs/pictures/raid-2.png differ diff --git a/docs/test_guide_doc/oech_test_guide.md b/docs/test_guide_doc/oech_test_guide.md new file mode 100644 index 0000000000000000000000000000000000000000..74a0889648ea7b38faa2266f80177506585fcdca --- /dev/null +++ b/docs/test_guide_doc/oech_test_guide.md @@ -0,0 +1,183 @@ +* [前言](#前言) +* [测试指导](#使用指导) + * [整机测试项](#整机测试项) + * [板卡测试项](#板卡测试项) + * [RAID](#RAID) + * [NIC](#NIC) + * [IB](#IB) + * [SSD](#SSD) + * [GPU](#GPU) + * [dpdk](#dpdk) + * [FC](#FC) +* [FAQ](#FAQ) + +# 前言 +在使用本指导前请确保已阅读 [oec-hardware工具说明](https://gitee.com/openeuler/oec-hardware/blob/master/README.md) + +# 测试指导 + +## 启动工具 +1. 在客户端启动测试框架。输入 `oech`启动工具，输入1 选择`compatible`测试类别 + ``` + # oech + Please select test category. + No. category + 1 compatible + 2 virtualization + Please select test category No:1 + ``` +2. 进入测试套选择界面。在用例选择界面，框架将自动扫描硬件并选取当前环境可供测试的测试套，输入 `edit` 可以进入测试套选择界面。 + + ``` + These tests are recommended to complete the compatibility test: + No. Run-Now? status Class Device driverName driverVersion chipModel boardModel + 1 yes NotRun acpi + 2 yes NotRun clock + 3 yes NotRun cpufreq + 4 yes NotRun disk + 5 yes NotRun ethernet enp3s0 hinic 2.3.2.17 Hi1822 SP580 + 6 yes NotRun ethernet enp4s0 hinic 2.3.2.17 Hi1822 SP580 + 7 yes NotRun ethernet enp125s0f0 hns3 HNS GE/10GE/25GE TM210/TM280 + 8 yes NotRun ethernet enp125s0f1 hns3 HNS GE/10GE/25GE TM210/TM280 + 9 yes NotRun raid 0000:04:00.0 megaraid_sas 07.714.04.00-rc1 SAS3408 SR150-M + 10 yes NotRun gpu 0000:03:00.0 amdgpu Navi Radeon PRO W6800 + 11 yes NotRun ipmi + 12 yes NotRun kabi + 13 yes NotRun kdump + 14 yes NotRun memory + 15 yes NotRun perf + 16 yes NotRun system + 17 yes NotRun usb + 18 yes NotRun watchdog + Ready to begin testing? (run|edit|quit) + ``` + +3. 选择测试套。`all|none` 分别用于 `全选|全取消`（必测项 `system` 不可取消，多次执行成功后 `system` 的状态会变为`Force`）；数字编号可选择测试套，建议每次选择一个数字，按回车符之后 `no` 变为 `yes`，表示已选择该测试套。 + + ``` + Select tests to run: + No. Run-Now? status Class Device driverName driverVersion chipModel boardModel + 1 no NotRun acpi + 2 no NotRun clock + 3 no NotRun cpufreq + 4 no NotRun disk + 5 yes NotRun ethernet enp3s0 hinic 2.3.2.17 Hi1822 SP580 + 6 no NotRun ethernet enp4s0 hinic 2.3.2.17 Hi1822 SP580 + 7 no NotRun ethernet enp125s0f0 hns3 HNS GE/10GE/25GE TM210/TM280 + 8 no NotRun ethernet enp125s0f1 hns3 HNS GE/10GE/25GE TM210/TM280 + 9 yes NotRun raid 0000:04:00.0 megaraid_sas 07.714.04.00-rc1 SAS3408 SR150-M + 10 yes NotRun gpu 0000:03:00.0 amdgpu Navi Radeon PRO W6800 + 11 yes NotRun ipmi + 12 yes NotRun kabi + 13 yes NotRun kdump + 14 yes NotRun memory + 15 yes NotRun perf + 16 yes NotRun system + 17 yes NotRun usb + 18 yes NotRun watchdog + Selection (|all|none|quit|run): + ``` +4. 开始测试。选择完成后输入"run"进行测试 + +## 整机测试项 + +* 整机测试项中有部分涉及重启操作的测试项，请对这类测试项单独进行测试` kdump watchdog` +* 测试项介绍详情请查看 [oec-hardware测试项介绍](https://gitee.com/openeuler/oec-hardware/tree/master/docs/test_suite_doc/test_suite.md) + +## 板卡测试项 + +### RAID + +1. 测试前请确保硬件已被工具识别，并且添加到测试项中 +![raid-1](../pictures/raid-1.png) + +2. 编辑`/usr/share/oech/lib/config/test_config.yaml`文件，更改raid卡pci地址 +![raid-2](../pictures/raid-2.png) + +3. 配置完成后，勾选raid测试项进行测试即可 + +### NIC/IB + +1. 网卡测试需要额外一台服务器作为服务端，并且需要客户端与服务端安装了相同的待测网卡并确保网卡直连 +![nic-1](../pictures/nic-1.png) +![nic-2](../pictures/nic-2.png) + +2. 使用`ifconfig xxx`命令配置客户端与服务端网口IP，IP根据自己需要选择 + +* 配置客户端 +``` +[root@localhost ~]# ifconfig enp4s0f0 2.2.2.3 +``` +* 配置服务端 +``` +[root@localhost ~]# ifconfig ens6f1 2.2.2.4 +``` +* 配置完成后任意一段ping另一段测试是否连通 +``` +[root@localhost ~]# ping 2.2.2.4 +PING 2.2.2.4 (2.2.2.4) 56(84) bytes of data. +64 bytes from 2.2.2.4: icmp_seq=1 ttl=64 time=0.302ms +64 bytes from 2.2.2.4: icmp_seq=1 ttl=64 time=0.140ms +64 bytes from 2.2.2.4: icmp_seq=1 ttl=64 time=0.124ms +``` +3. 服务端准备 +* 使用 `dnf` 安装服务端 oec-hardware-server。 + + ``` + dnf install oec-hardware-server + ``` + +* 启动服务。本服务通过搭配 nginx 服务提供 web 服务，默认使用 80 端口，可以通过 nginx 服务配置文件修改对外端口，启动前请保证这些端口未被占用。 + + ``` + systemctl start oech-server.service + systemctl start nginx.service + ``` + +* 关闭防火墙和 SElinux。 + + ``` + systemctl stop firewalld + iptables -F + setenforce 0 + ``` +4. 客户端测试 + +* 编辑`/usr/share/oech/lib/config/test_config.yaml`文件，更改网卡端口和服务端IP +![nic-3](../pictures/nic-3.png) + +* 配置完成后，勾选对应端口的网卡测试项进行测试即可 + + +### SSD + +确保硬件被工具识别，并且添加到测试项之后，勾选对应测试项进行测试即可 + + +### GPU + +1. 从对应GPU厂商官网下载outbox驱动，编译安装到当前环境上 + +2. 勾选对应测试项进行测试即可 + + +### dpdk + +1. 进行dpdk测试前，请确保网卡驱动支持dpdk测试（目前支持dpdk测试的驱动：*mlx4_core, mlx5_core, ixgbe, ice, hinic, igc*) +2. dpdk测试需要配置服务端，将两个以太网连成环回模式，在没有外部流量发生器的情况下， 客户端使用发包模式(Tx-only mode)作为数据包源，服务端使用收包模式(Rx-only mode) 作为数据包接收器, 测试端口传输速率功能。 [服务端配置参考](https://gitee.com/openeuler/oec-hardware#%E4%BD%BF%E7%94%A8%E6%AD%A5%E9%AA%A4) + +3. 服务端IP配置正确后，勾选对应测试项测试即可 + +### FC + +1. FC测试将使用 fio 工具进行FC存储服务器的顺序/随机读写测试，测试之前请先确保FC卡与存储服务器连通并且有传输速率 +![fc-1](../pictures/fc-1.png) + +2. 进入存储服务器配置磁盘阵列，配置完成后确保os侧能识别到盘 +![fc-2](../pictures/fc-2.png) + +3. 编辑`/usr/share/oech/lib/config/test_config.yaml`文件，更改fc卡pci地址 +![fc-3](../pictures/fc-3.png) +![fc-4](../pictures/fc-4.png) + +4. 配置完成后，勾选对应fc卡测试项进行测试即可 \ No newline at end of file diff --git a/docs/test_suite_doc/.keep b/docs/test_suite_doc/.keep deleted file mode 100644 index e69de29bb2d1d6434b8b29ae775ad8c2e48c5391..0000000000000000000000000000000000000000 diff --git a/docs/test_suite_doc/test_suite.md b/docs/test_suite_doc/test_suite.md index f382780108e7994c1fd4f4d914e6db95e1671f79..2d4b261f0a99964b0a7520b60751aa91a0bc5043 100644 --- a/docs/test_suite_doc/test_suite.md +++ b/docs/test_suite_doc/test_suite.md @@ -79,7 +79,7 @@ #### 测试 cpu 在不同调频策略下运行频率是否同预期 定义 CPUFreqTest 类： -1. 定义`test_performance test_powersave test_ondemand test_conservative test_userspace`方法，测试在五种调频策略下 CPU 频率变化对性能的影响，其中五中调频策略： +1. 定义`test_performance test_powersave test_ondemand test_conservative test_userspace`方法，测试在五种调频策略下 CPU 频率变化对性能的影响，其中五种调频策略： * performance：始终以最高频率运行，提供最佳性能，但可能消耗更多电力。 * powersave：尽可能降低频率运行，以节省电力，但可能牺牲性能。 * ondemand：根据负载动态调整频率，试图在性能和功耗之间找到平衡点。 @@ -94,29 +94,25 @@ * 设置一个容差值（tolerance），用于确定加速比的合理范围，并检查所计算的加速比是否落在预期范围。 3. test_ondemand 方法： - * 先尝试将所有 CPU 的频率调节策略设置为 powersave，接下来尝试将所有 CPU 的频率调节策略设置为 ondemand。 + * 先将所有 CPU 的频率调节策略设置为 powersave，接下来将所有 CPU 的频率调节策略设置为 ondemand。 * 确认 CPU 调节策略为 ondemand 的情况下，创建一个 Load 实例，并在选定的 CPU 上执行负载测试。 * 负载测试运行期间，获取 CPU 当前频率，检查频率是否已经调整到了最大频率。在负载较高情况下，ondemand 策略应将 CPU 频率提升至最大以提供最佳性能。 4. test_conservative 方法： - * 先尝试将所有 CPU 的频率调节策略设置为 powersave，接下来尝试将所有 CPU 的频率调节策略设置为 conservative。 + * 先将所有 CPU 的频率调节策略设置为 powersave，接下来将所有 CPU 的频率调节策略设置为 conservative。 * 确认 CPU 调节策略为 conservative 的情况下，创建一个 Load 实例，并在选定的 CPU 上执行负载测试。 * 负载测试运行期间，获取 CPU 当前频率，检查频率是否在最大频率与最小频率之间。在负载较高情况下，conservative 策略应将 CPU 频率在最小频率和最大频率之间动态调整，以平衡性能和节能。 5. test_powersave 方法： - * 尝试将所有 CPU 的频率调节策略设置为 powersave。 + * 将所有 CPU 的频率调节策略设置为 powersave。 * 确认 CPU 调节策略为 powersave 的情况下，检查选定的 CPU 频率是否等于最低频率。 * 创建一个 Load 实例，并在选定的 CPU 上执行负载测试。 6. test_performance 方法： - * 尝试将所有 CPU 的频率调节策略设置为 performance。 + * 将所有 CPU 的频率调节策略设置为 performance。 * 确认 CPU 调节策略为 performance 的情况下，检查选定的 CPU 频率是否等于最高频率。 * 创建一个 Load 实例，并在选定的 CPU 上执行负载测试。 -#### 测试 cpu 在不同频率下完全同规格计算量所需时间是否与频率值反相关。 - -在不同频率下进行负载测试时会获取负载测试的运行时间（load_test_time）。 - ### 3-clock #### 测试时间矢量性，不会倒回