iPXE
The iPXE test validates that the underlying network interface controller supports the iPXE network boot environment.
The iPXE test validates that the underlying network interface controller (NIC) supports the iPXE network boot firmware by using an HTTP boot. You can run this test to verify that your system can successfully use enhanced Pre-Boot Execution Environment (PXE) features. These features let the system boot from HTTP, SAN, and wireless networks.
- What the iPXE test covers
-
The iPXE test is an interactive test that runs on x86 Red Hat Enterprise Linux (RHEL) systems. The system should boot in UEFI boot mode. If the
efi directoryexists the machine is running in the UEFI boot mode. Run the following command to determine if your machine is running in UEFI mode:ls /sys/firmware/efi/ - RHEL version supported
-
- RHEL 8
- RHEL 9
- What the test does
- iPXE is the leading open source network boot firmware. It provides a full PXE implementation enhanced with additional features such as boot from HTTP, SAN, and Wireless Network. This test checks if the underlying NIC supports iPXE by using the HTTP boot.
While performing the iPXE test, the test server does not return any bootable image. The boot screen displays an expected error message: could not boot.
The test server then boots with the next boot loader, which is the RHEL OS.
- Preparing for the test
-
- Ensure that the host under test is in the UEFI boot mode. iPXE tests the interface that it finds first. On the host under test, ensure the interface that needs to be tested is plugged in.
- Ensure that the
httpdservice is not running on the test server while running this test. This test uses port 80 to communicate with the test server.
- Running the test
-
- Run the following command and then select the appropriate
iPXEtest name from the list that displays.rhcert-run - The ipxe test does not appear in the test plan, so you must use the following commands to plan and run it manually, respectively.
# rhcert-cli plan --add --test iPXE# rhcert-cli run --test iPXE - The test first configures the Host Under Test (HUT) for the iPXE test. It saves the MAC details of the HUT and creates a new boot loader using the ipxe binary. It marks this boot loader as the next boot. After that, the test prompts for a reboot. Press Yes to continue. The test server then waits for a response after it sends the reboot command.
- The HUT reboots to the new boot loader, which loads the iPXE prompt. The iPXE prompt then sends a GET request to check if it can reach the test server. Because this is only a GET request, the boot fails as expected. The system then falls back to the next boot loader, which is the RHEL OS.
- The test server continuously monitors the host under test to see if it has rebooted. After the reboot, the test continues. The test first reverts the boot changes done for iPXE and then verify if iPXE boot was successful.
- It compares the MAC address received from the GET request of iPXE boot with the MAC already saved. If the MAC matches the iPXE test is successful.
- Run the following command and then select the appropriate
- Run time
- The test takes less than 5 minutes to run. Any other mandatory or selected tests add to the overall run time.