SR-IOV
The SR-IOV test verifies that NICs on the host under test support Single Root I/O Virtualization features.
The SR-IOV test verifies Single-Root I/O Virtualization (SR-IOV) support. It checks the network interface controllers (NICs) installed on the host under test (HUT) and the test server.
You can run this test to validate that a single physical hardware device can be shared among multiple virtual machines or containers. This capability improves network performance and the efficiency of I/O operations.
- What the test does
- The SR-IOV test certifies the NIC cards installed on the host under test (HUT) and the test server. It checks if the SR-IOV functionality is supported on the cards.
The test is based on Single Root I/O Virtualization (SR-IOV) technology. This technology enables a single physical hardware device to be shared among multiple virtual machines or containers. Sharing improves network performance and the efficiency of I/O operations.
- RHEL version supported
-
- RHEL 9
- RHEL 10
- What the test covers
- The test checks if the NIC card installed on the x86_64 system supports SR-IOV technology.
- Preparing for the test
-
Before running the test:
- Install the NIC card on both the HUT and test server.
- Ensure that the NIC card undergoing testing has two ports each.
- Ensure that the test server and HUT are connected through two direct Ethernet cables back to back for the test to pass successfully.
- Ensure to enable Intel VT-d or AMD IOMMU and SR-IOV Global Enable parameters in your system’s BIOS. For more details, refer to the system’s BIOS configuration manual or any other methods provided by the manufacturer.
- Ensure to enable SRIOV for the NIC card under Device Settings. For more details, refer to the NIC card configuration manual or any other methods provided by the manufacturer.
- Install the following RPMs on both HUT and the test server, in the same order as mentioned.
- Enable the epel repository and then install beakerlib:
- For RHEL 9
# yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm# yum install beakerlib - For RHEL 10
# yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-10.noarch.rpm# yum install beakerlib
- For RHEL 9
- SR-IOV
- Configure Hugepage
# grubby --args='intel_iommu=on iommu=pt default_hugepagesz=1G hugepagesz=1G hugepages=32' --update-kernel=$(grubby --default-kernel)Ensure to reboot the system after configuration completes. Ensure to provision the HUT and test server. See Configuring the systems and running tests by using CLI.
- Configure Hugepage
- Enable the epel repository and then install beakerlib:
- Running the test
-
On HUT:
- Edit the config file generated at this path according to your system’s configuration,
/etc/redhat-certification/sriov/nic_cert.confNote You must update and keep a backup of the config file every time after running the provision command.
- Run the test:
# rhcert-runWhile the test runs on the HUT, a corresponding test run also runs in auto mode on the test server. The test is non-interactive and runs in the background.
- Edit the config file generated at this path according to your system’s configuration,
- Run time
- The test takes around 2 hours to run. Any other mandatory or selected tests add to the overall run time.