Chapter 4. Setting up the test environment


The first step towards certifying your product is setting up the environment where you can run the tests. The test environment consists of only the Undercloud node.

All the mandatory tests that verify the system configuration required for bare metal certification run on the Undercloud node.

Important

If you prefer using Cockpit instead of the command line for baremetal testing, you must set up the Cockpit first. See Configuring the systems and running tests by using Cockpit for instructions.

4.1. Setting up the Undercloud node

Prerequisites

  • You have installed RHOSP on the system based on the supported RHEL version, as applicable.

    Ensure to use RHOSP Director for installation, as it is the supported toolset for installing and managing RHOSP in production.

    The corresponding supported versions are as follows:

    RHOSP versionSupported RHEL version

    RHEL 16.0

    8.1

    RHEL 16.1

    8.2

    RHEL 16.2

    8.4

    RHEL 17.0

    9.0

    RHEL 17.1

    9.2 and 9.4

  • Ensure that the RSA private key file is in PEM format. See RHOSP 17.1 Configuration Reference document for more information.

Procedure

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

    # subscription-manager register
    Copy to clipboard
  2. Display the list of available subscriptions for your system:

    # subscription-manager list --available*
    Copy to clipboard

    Search for the subscription that provides the Red Hat Certification (for RHEL Server) repository and make a note of the subscription and its Pool ID.

  3. Attach the subscription to your system:

    # subscription-manager attach --pool=<pool_ID>
    Copy to clipboard

    Replace the pool_ID with the Pool ID of the subscription.

  4. Subscribe to the Red Hat Certification channel:

    • On RHEL 8:

      # subscription-manager repos --enable=cert-1-for-rhel-8-<HOSTTYPE>-rpms
      Copy to clipboard

      Replace HOSTTYPE with the system architecture. To find out the system architecture, run

      uname -m
      Copy to clipboard

      Example:

      # subscription-manager repos --enable=cert-1-for-rhel-8-x86_64-rpms
      Copy to clipboard
    • On RHEL 9:

      # subscription-manager repos --enable=cert-1-for-rhel-9-<HOSTTYPE>-rpms
      Copy to clipboard

      Replace HOSTTYPE with the system architecture. To find out the system architecture, run

      uname -m
      Copy to clipboard

      Example:

      # subscription-manager repos --enable=cert-1-for-rhel-9-x86_64-rpms
      Copy to clipboard
  5. Install the certification RPMs.

    • Only on RHEL 9

      # yum install redhat-certification
      Copy to clipboard
  6. Install OpenStack test suite package:

    yum install redhat-certification-baremetal
    Copy to clipboard

4.2. Configuring Bare Metal

See Bare Metal Provisioning service (ironic) functionality for installing, configuring, and using the Bare Metal service in the undercloud of a Red Hat OpenStack Platform environment.

4.3. Validating Bare Metal configuration

Procedure

You must validate that Bare Metal is working prior to starting the certification process. To see the registered nodes and their current status, follow the Troubleshooting node provisioning chapter described in the Installing and managing Red Hat OpenStack Platform with director guide.

Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat, Inc.