Red Hat Bare Metal Hardware Certification Workflow Guide

Procedure

1. Run the provision command.

   # rhcert-provision <path_to_test_plan_document>

   Replace <path_to_test_plan_document> with the test plan file saved on the test host.

Procedure

1. Run tests

   # rhcert run

   The non-interactive tag is an RHCert flag used to run all certification-related mandatory tests.

2. Save the test result file

   # rhcert-save

   By default, the result file is saved as /var/rhcert/save/rhcert-results-<host-name>-<timestamp>.xml.

Procedure

1. Log in to authenticate your device.

   Note

   Logging in is mandatory to submit the test results file.

   # rhcert-cli login

   1. Open the generated URL in a new browser window or tab.
   2. Enter the login and password and click Log in.

   3. Click Grant access.

      Device log in successful message displays.

   4. Return to the terminal and enter yes to the Please confirm once you grant access prompt.

2. Submit the result file.

   # rhcert-submit

   When prompted, enter your Certification ID.

Procedure

1. Log in to Red Hat Certification portal.

2. On the homepage, enter the product case number in the search bar.

   Select the case number from the list that is displayed.

3. On the Summary tab, under the Files section, click Upload.

Procedure

1. Log in to the Red Hat Partner Connect portal.
2. Click the Red Hat Enterprise Linux System certification that is related to the assisted installer certification you want to open.
3. Click the Related Certifications tab on the upper left side of the table.
4. Click the Red Hat OpenShift Container Platform certification that is related to the assisted installer certification you want to open.
5. Click the Related Certifications tab on the upper left side of the table.

6. At the top of the certifications table, click Add Related Certification.

   The Create Related Certification window appears.

7. Select Supplemental and click Next.

8. Review the certification information and click Open.

   The supplemental certification is created.

9. Leave a comment to the Red Hat certification team to specify that you want either or both of the following components added to the test plan:

   • Bare Metal Management
   • Assisted Installer
10. After you get the new test plan, start testing.

Procedure

1. Identify the IP address of the node where the Ironic service is running. For example:

   # oc -n openshift-machine-api get pods -o wide | egrep -v ‘image|controller|operator’
   
   NAME                                              READY   STATUS    RESTARTS   AGE   IP             NODE
   metal3-78b556db65-lgkrp                    7/7     Running   0          12d   172.22.0.111   worker-0

   The metal3 pod runs the Ironic service that the test uses to install the bare-metal node undergoing certification. Make a note of its IP address; this is the Ironic API endpoint that you will use in a later step.

2. Get the credentials of the Ironic service and make a note of them. You will use them in a later step.

   # oc -n openshift-machine-api get secret/metal3-ironic-password -o template --template '{{.data.username}}' | base64 -d
   
   # oc -n openshift-machine-api get secret/metal3-ironic-password -o template --template '{{.data.password}}' | base64 -d

3. Log in to any cluster node. For example:

   # oc debug host/master-0

4. Prepare the node to run the certification test:

   1. Install podman if it is not already installed.

   2. Create the /tmp/results directory. The test will store the results in this directory

      Note

      The node must have access to the baremetal and the provisioning networks if both are available on the RHOCP environment. If you only configured the baremetal network, the node must be connected to it.

   3. Log in to the Red Hat Certification image registry:

      # podman login registry.redhat.io
      Username: <registry_service_account_username>
      Password: <registry_service_account_password>
      Login Succeeded!

   4. Download the redhat-certification-baremetal image from the Red Hat catalog:

      # podman pull registry.redhat.io/rhcertification/redhat-certification-baremetal

5. Run the IPI test:

   # podman run -it --net host -v /tmp/results:/var/rhcert_results:Z redhat-certification-baremetal

   Table 11.1. IPI test parameter description

   Parameter	Description
   -it	Starts an interactive session.
   --net host	Podman uses the network stack of the host for the container. The network configuration of the container is the same as that of the host. The container shares the same service ports that are available to the host.
   -v tmp/results:/var/rhcert_results	Allows mounting the content of a host folder /tmp/results to /var/rhcert_results.
   :Z	Ensures you have read and write permissions on the mount point.

6. Enter the username, password, and the URL of the Ironic service that you acquired before. The URL must be in the format https://<Ironic_IP_address>:6385.

7. Select the bare-metal node on which you want to run the test.

   The UUID, Name, Power State, and Provision State of the selected node displays. The test will start after you select the node.

8. Confirm whether the bare-metal node is powered on when prompted. After you confirm this, the test restarts the bare-metal node.

   Test result files are generated at /tmp/results.

9. At the Red Hat certification website, submit the results to the supplemental RHOCP certification for your server.

Procedure

1. Log in to the single-node cluster.

2. Install the following redhat-certification packages:

   • redhat-certification

   • redhat-certification-openshift

     For example:

     # dnf install redhat-certification redhat-certification-openshift

3. In the Red Hat Hybrid Cloud Console, generate an OpenShift Manager API token.

4. Add the token to the OFFLINE_TOKEN variable and export it.

   For example,

   # export OFFLINE_TOKEN=<value_of_your_token>

5. Confirm if the cluster is accessible by using the following command:

   # oc status

6. Run the tests according to test plan:

   # rhcert-run

   The similar set of tests get displayed as follows:

   

   Alternatively, you can use rhcert-cli to run the test as follows:

   # rhcert-cli plan

   # rhcert-cli run –test assisted_installer

   Save the test result:

   # rhcert-cli save

7. Submit the results of both tests to the supplemental RHOCP certification for your server at the Red Hat Certification website.