Chapter 4. Setting up the test environment

https://docs.redhat.com/en/documentation/red_hat_hardware_certification/2025/html/red_hat_hardware_certification_test_suite_user_guide/assembly_setting-up-host-systems-for-running-tests_assembly_open_new_cert_portal ___

To certify your product, you must first set up the environment where you can run the tests. The test environment consists of a host under test (HUT).

Set up the test environment where you can run the tests.

The test environment consists of at least two systems:

System 1: Acts as the host under test (HUT)
System 2: Acts as the test server

A system on which the product that needs certification is installed or configured is referred to as the host under test (HUT).

Prerequisites

The HUT has RHEL version 8 or later installed. For convenience, Red Hat provides kickstart files to install the HUT’s operating system. Follow the instructions in the file that is appropriate for your system before launching the installation process.

Red Hat Hardware Certification requires using the General Availability (GA) kernel for the Red Hat Enterprise Linux version being certified for hardware certification.

When installing RHEL, please download and use the Binary DVD Offline Install Image, and not the Boot ISO image. The Boot ISO image requires a network connection, and will automatically install the current kernel instead of the required GA kernel.

Do not register the system with Red Hat Subscription Management (RHSM) during the installation process. Only register the system with RHSM after the installation process is completed.

Procedure

Configure the Red Hat Certification repository.

Use your RHN credentials to register your system using Red Hat Subscription Management:

Copy to Clipboard Toggle word wrap
```
# subscription-manager register
```
Display the list of available subscriptions for your system:

Copy to Clipboard Toggle word wrap
```
# subscription-manager list --available*
```
Search for the subscription which provides the Red Hat Certification (for RHEL Server) repository and make a note of the subscription and its Pool ID.
Attach the subscription to your system. Replace the pool_ID with the Pool ID of the subscription.

Copy to Clipboard Toggle word wrap
```
# subscription-manager attach --pool=<pool_ID>
```
Subscribe to the Red Hat Certification channel:

Copy to Clipboard Toggle word wrap
```
$ subscription-manager repos --enable=cert-1-for-rhel-<VERSION>-<HOSTTYPE>-rpms
```
Replace VERSION with the RHEL version number on the SUT

Copy to Clipboard Toggle word wrap
```
subscription-manager repos --enable=cert-1-for-rhel-9-<HOSTTYPE>-rpms
```
To find out the system architecture, run

Copy to Clipboard Toggle word wrap
```
$ uname -m
```
Replace HOSTTYPE with the system architecture.

Copy to Clipboard Toggle word wrap
```
$ subscription-manager repos --enable=cert-1-for-rhel-<VERSION>-x86_64-rpms
```
1. Install the software test suite package:
  
  This step is applicable only for RHEL version 9 or later.
  
  Copy to Clipboard Toggle word wrap
```
$ dnf install redhat-certification-hardware
```

Some of the tests running on the host under test (HUT) require a second system to pass. This second system is known as the test server.

For example, the test that checks bandwidth, transfers data from one system to another, in order to pass.

Prerequisites

The test server has RHEL version 8, 9 or 10 installed.

Red Hat recommends that your test server runs the same major version of RHEL as the HUT.

Red Hat provides kickstart files to install the HUT’s operating system, and you can also use them to install the test server. Follow the instructions in the file that is appropriate for your system before launching the installation process.

Procedure

Configure the Red Hat Certification repository.

Use your RHN credentials to register your system using Red Hat Subscription Management:

Copy to Clipboard Toggle word wrap
```
# subscription-manager register
```
Display the list of available subscriptions for your system:

Copy to Clipboard Toggle word wrap
```
# subscription-manager list --available*
```
Search for the subscription which provides the Red Hat Certification (for RHEL Server) repository and make a note of the subscription and its Pool ID.
Attach the subscription to your system. Replace the pool_ID with the Pool ID of the subscription.

Copy to Clipboard Toggle word wrap
```
# subscription-manager attach --pool=<pool_ID>
```
Subscribe to the Red Hat Certification channel:

Copy to Clipboard Toggle word wrap
```
$ subscription-manager repos --enable=cert-1-for-rhel-<VERSION>-<HOSTTYPE>-rpms
```
Replace VERSION with the RHEL version number on the SUT

Copy to Clipboard Toggle word wrap
```
subscription-manager repos --enable=cert-1-for-rhel-9-<HOSTTYPE>-rpms
```
To find out the system architecture, run

Copy to Clipboard Toggle word wrap
```
$ uname -m
```
Replace HOSTTYPE with the system architecture.

Copy to Clipboard Toggle word wrap
```
$ subscription-manager repos --enable=cert-1-for-rhel-<VERSION>-x86_64-rpms
```
1. Install the software test suite package:
  
  This step is applicable only for RHEL version 9 or later.
  
  Copy to Clipboard Toggle word wrap
```
$ dnf install redhat-certification-hardware
```

Set up the test environment to run the RHEL AI certification tests.

Procedure

From your HUT, log in to the Red Hat Hybrid Cloud Console subscriptions page by using your SSO login credentials to confirm you have an active Red Hat Partner Subscription. If not, contact your company’s organisation administrator to request for a partner subscription.
Log in to the Red Hat Insights application and go to the Inventory > System configuration > Activation Keys tab, to generate an activation key for your account. Also, this page displays your Organisation ID. Make a note of this ID for future reference.
Register your HUT with the Red Hat Insights application.

Copy to Clipboard Toggle word wrap
```
sudo rhc connect --organization <org_id> --activation-key <your_activation_key>
```
Enable your certification repository for downloading the certification test rpms.

Copy to Clipboard Toggle word wrap
```
subscription-manager repos --enable=cert-1-for-rhel-9-x86_64-rpms
```
Install the test suite and reboot the HUT.

Copy to Clipboard Toggle word wrap
```
rpm-ostree install redhat-certification-hardware-ai
```
Login to the Red Hat Registry by using the skopeo tool. This step enables you to download models during the test run.

Copy to Clipboard Toggle word wrap
```
skopeo login registry.redhat.io
```
It prompts you to enter your login credentials to access the Red Hat registry.

Running RHEL AI certification tests can be time-consuming. To quickly verify if your HUT is suitable for running these tests, go to /etc/rhcert.xml file and update the value of <rhelai training> parameter from full to short as shown below:

Copy to Clipboard Toggle word wrap

<rhelai training="short" epoch="2" config-update="true">

This acts as a sanity test allowing you to quickly identify any issues with the AI accelerators before running the certification tests. This test result is not considered for certification.

Verification

To verify if your test environment is set, execute the following command:

Copy to Clipboard Toggle word wrap

rpm-ostree status

It confirms the successful installation of redhat-certification-hardware-ai package.