Red Hat SummitChapter 3. Installing the OpenStack Integration Test Suite
This section contains information about installing the OpenStack Integration Test Suite either with the director or with a manual installation.
3.1. Using the Director
Edit the undercloud.conf file, located in the home directory of the stack user. Ensure that the enable_tempest parameter is set to true:
enable_tempest = true
enable_tempest = true
If your undercloud is already installed, you can edit the undercloud.conf file and then run the openstack undercloud install command to include the extra configuration in the undercloud:
openstack undercloud upgrade
$ openstack undercloud upgrade
You are now ready to install the tempest packages and plugins, described in Section 3.3, “Installing the OpenStack Integration Test Suite Packages”.
3.2. Preparing a Manual Installation
To run the OpenStack Integration Test Suite, you must first install the necessary packages and create a configuration file that informs the Integration Test Suite where to find the various OpenStack services and other testing behaviour switches.
To install the OpenStack Integration Test Suite, the following networks must be available within your Red Hat OpenStack Platform environment:
- An external network which can provide floating IP
- A private network
These networks must be connected through a router.
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>
$ 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>Create the public network. Specify the following options according to your network deployment:
openstack network create <network_name> --external \ --provider-network-type flat 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>
$ openstack network create <network_name> --external \
--provider-network-type flat
$ 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>
You are now ready to install and configure the OpenStack Integration Test Suite within the tempest virtual machine. For more information, see Section 3.3, “Installing the OpenStack Integration Test Suite Packages”.
3.3. Installing the OpenStack Integration Test Suite Packages
Install the packages related to the OpenStack Integration Test Suite:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow sudo yum -y install openstack-tempest
$ sudo yum -y install openstack-tempestThis command does not install any tempest plugins. You must install the plugins manually, depending on your OpenStack installation.
Install the appropriate tempest plugin for each component in your environment. For example, run the following command to install the keystone, horizon, neutron, cinder, and telemetry plugins:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow sudo yum install python-keystone-tests-tempest python-horizon-tests-tempest python-neutron-tests-tempest python-cinder-tests-tempest python-telemetry-tests-tempest
$ sudo yum install python-keystone-tests-tempest python-horizon-tests-tempest python-neutron-tests-tempest python-cinder-tests-tempest python-telemetry-tests-tempestSee Section 3.3.1, “List of Tempest Plug-in Packages” for a list of the tempest plugins for each OpenStack component.
You can also install the openstack-tempest-all package. This package contains all of the tempest plugins.
3.3.1. List of Tempest Plug-in Packages
Run the following command to retrieve a list of tempest test packages:
sudo yum search $(openstack service list -c Name -f value) 2>/dev/null | grep test | awk '{print $1}'
$ sudo yum search $(openstack service list -c Name -f value) 2>/dev/null | grep test | awk '{print $1}'| Component | Package Name |
|---|---|
| barbican | python-barbican-tests-tempest |
| cinder | python-cinder-tests-tempest |
| designate | python-designate-tests-tempest |
| ec2-api | python-ec2api-tests-tempest |
| heat | python-heat-tests-tempest |
| horizon | python-horizon-tests-tempest |
| ironic | python-ironic-tests-tempest |
| keystone | python-keystone-tests-tempest |
| kuryr | python-kuryr-tests-tempest |
| manila | python-manila-tests-tempest |
| mistral | python-mistral-tests-tempest |
| networking-bgvpn | python-networking-bgpvpn-tests-tempest |
| networking-l2gw | python-networking-l2gw-tests-tempest |
| neutron | python-neutron-tests-tempest |
| nova-join | python-novajoin-tests-tempest |
| octavia | python-octavia-tests-tempest |
| patrole | python-patrole-tests-tempest |
| sahara | python-sahara-tests-tempest |
| telemetry | python-telemetry-tests-tempest |
| tripleo-common | python-tripleo-common-tests-tempest |
| zaqar | python-zaqar-tests-tempest |
Tempest test packages are specific to a Python version. For example, if your system uses Python 2, you must replace python- with python2- when installing the Tempest test packages.
The python-telemetry-tests-tempest package contains plugins for aodh, panko, gnocchi, and ceilometer tests. The python-ironic-tests-tempest package contains plugins for ironic and ironic-inspector.
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}