Chapter 4. Test Environment Overview

The primary application required in the Red Hat Certification workflow is a client server application. You may launch Red Hat Certification web user interface (UI) on a different host (test server). Also, you may use the web UI to run certification tests on an OpenStack deployment-under-test (test client).

It is recommended to setup a test server to run OpenStack Certification tests on the system-under-test or test client. This allows testing of multiple test clients from a single test server, enables quick validation, and prevents resource constraints.

The following diagram illustrates the environment setup required for testing the OpenStack deployment-under-test. The diagram includes the certification packages that need to be installed on each host (color coded).

Figure 4.1. Bare Metal Environment Setup

Test Environment Overview

4.1. Preparing the Test Server

The software packages required on the test server must be installed by subscribing to the Red Hat Certification channel via CDN. This ensures that the required dependencies are automatically installed.

To install the required software packages on the test server, perform the following steps:

  1. Select a persistent RHEL 7 host which can act as the test server. The chosen RHEL 7 host should be able to access Red Hat services including the certification channels and use the same network as the OpenStack deployment-under-test.

  2. Run the following command to install the redhat-certification package on the host: 

    # yum install redhat-certification -y

  3. Start Apache by executing the following command: 

    # systemctl start httpd

  4. Start the Red Hat certification back-end-server and the server listener process by executing the following command: 

    # rhcertd start
  5. Verify that your test server can reach the redhat certification services by opening the Web UI: http:/IP address of the test server.

Result

The test server (RHEL 7.x host) is now prepared. The redhat-certification package provides Red Hat Certification web UI which can be used to run certification tests on the OpenStack deployment-under-test/test client.

4.2. Preparing the Undercloud for Testing

Install the relevant version of Red Hat OpenStack Platform (against which the certification is required) using Red Hat OpenStack Platform Product Documentation. After Red Hat OpenStack Platform is installed, see the product documentation to understand its usage and configuration.

It is mandatory to use the Red Hat OpenStack Platform Director for installation as it is the supported toolset for installing and managing a Red Hat OpenStack Platform environment in production.

The software packages required on the OpenStack deployment-under-test machine must be installed by subscribing to Red Hat Certification channel via CDN. This ensures that the required dependencies are automatically installed.

Note

The OpenStack deployment-under-test refers to the node where BMC can be controlled/undercloud node. For more information, see Test Environment Overview section.

Perform the following steps on the Undercloud Director node that is configured for Bare Metal:

  1. Run the following command to install the redhat-certification-baremetal package. This automatically installs the required dependencies: 

    # yum install redhat-certification-baremetal

  2. Start the Red Hat Certification back-end server and the server listener process by executing the following command: 

    # rhcertd start

Result

The OpenStack deployment-under-test which refers to the node from where BMC can be controlled or undercloud node is installed is now prepared for certification testing.

4.3. Proxy Settings for Test Server and Test Client

If your network utilizes a proxy, you may need to manually configure the test server and/or test client for the proxy as outlined below:

In the test server, update the /etc/rhcert.xml file as per the following settings: 

<urls>
<proxy-url protocol="http">PROXY_SERVER:PROXY_PORT</proxy-url>
<proxy-url protocol="https">PROXY_SERVER:PROXY_PORT</proxy-url>
</urls>

Replace PROXY_SERVER with the IP or dns-name of your proxy server, and PROXY_PORT with your proxy port number.

For example: 

<proxy-url protocol="http">http://rhcert-example.redhat.com:3148<proxy-url>
<proxy-url protocol="https">https://rhcert-example.redhat.com:3148<proxy-url>

To open port 80 and port 8009 on test server and test client, run the rhcert-cli register command.

For more information, we recommend you to refer How can we access to the Hardware Certification (rhcertd web interface) via proxy?

4.4. Configuring Bare Metal

The Bare Metal Provisioning for RHOSP13 guide provides procedures for installing, configuring, and using the Bare Metal service in the undercloud of a Red Hat OpenStack Platform environment.

4.5. Confirming Bare Metal Configuration

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 Bare Metal Provisioning chapter described in the Director Installation and Usage guide.