Chapter 2. Installing the Integration Test Suite (tempest)

Procedure

1. Log in to the undercloud host as the stack user.
2. Edit the undercloud.conf file located in the home directory of the stack user.

3. Set the enable_tempest parameter to true.

   enable_tempest = true

4. Run the openstack undercloud install command to include the extra configuration in the undercloud:

   $ openstack undercloud install

Procedure

1. Ensure that the following networks are available within your Red Hat OpenStack Platform (RHOSP) environment:

   • An external network that can provide a floating IP.

   • A private network.

     Connect these networks through a router.

     1. To create the private network, specify the following options according to your network deployment:

        $ openstack network create <network_name> --share
        $ openstack subnet create <subnet_name> --subnet-range <address/prefix> \
          --network <network_name>
        $ openstack router create <router_name>
        $ openstack router add subnet <router_name> <subnet_name>

     2. To create the public network, specify the following options according to your network deployment:

        $ openstack network create <network_name> --external \
          --provider-network-type flat \
          --provider-physical-network datacentre
        $ openstack subnet create <subnet_name> --subnet-range <address/prefix> \
          --gateway <default_gateway> --no-dhcp --network <network_name>
        $ openstack router set <router_name> --external-gateway <public_network_name>

2. Install the packages related to the Integration Test Suite:

   $ sudo dnf -y install openstack-tempest

   This command does not install any tempest plugins. You must install the plugins manually, depending on your RHOSP installation.

3. Install the appropriate tempest plugin for each component in your environment. For example, enter the following command to install the keystone, neutron, cinder, and telemetry plugins:

   $ sudo dnf install python3-keystone-tests-tempest python3-neutron-tests-tempest python3-cinder-tests-tempest python3-telemetry-tests-tempest

   For a full list of packages, see Integration Test Suite packages.