Red Hat SummitChapter 3. Installing the OpenStack Integration Test Suite
This section describes how to install the OpenStack Integration Test Suite using either the director or a manual installation.
3.1. Using the Director
Edit /home/stack/undercloud.conf. By default, enable_tempest is set to false. Change this to true:
enable_tempest = true
enable_tempest = trueYou are now ready to install the tempest packages and plug-ins, 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 need to first install the necessary packages and create a configuration file that will tell the Integration Test Suite where to find the various OpenStack services and other testing behaviour switches.
On the controller node, as a root user, create a virtual machine named tempest. This machine must run Red Hat Enterprise Linux 7.3 or greater; it also needs to be able to reach the cloud, but it does not have to be part of the cloud. For more information, see Creating Guests with Virt-Manager.
In addition, before installing the OpenStack Integration Test Suite, the following networks are required within your Red Hat OpenStack Platform environment:
- An external network that can provide a floating IP address.
- A private network.
These networks must be connected through a router.
Create the private network:
openstack network create _<network_name>_ --share openstack subnet create _<subnet_name>_ --subnet-range _<address/prefix>_ openstack router create _<router_name>_ openstack router add subnet _<router_name>_ _<subnet_name>_ --network _<network_name>_
$ openstack network create _<network_name>_ --share $ openstack subnet create _<subnet_name>_ --subnet-range _<address/prefix>_ $ openstack router create _<router_name>_ $ openstack router add subnet _<router_name>_ _<subnet_name>_ --network _<network_name>_Copy to Clipboard Copied! Toggle word wrap Toggle overflow Create the public network:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Create the required keystone roles:
openstack role create swiftoperator openstack role create heat_stack_owner
$ openstack role create swiftoperator $ openstack role create heat_stack_ownerCopy to Clipboard Copied! Toggle word wrap Toggle overflow
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:
sudo yum install openstack-tempest
$ sudo yum install openstack-tempestCopy to Clipboard Copied! Toggle word wrap Toggle overflow However, this command will not install any tempest plug-ins. These are installed manually in the following steps, depending on your OpenStack installation:
Install the appropriate tempest plug-in for each component you have, separated by spaces, in the following format:
sudo yum install <component1> <component2> <component3>
$ sudo yum install <component1> <component2> <component3>Copy to Clipboard Copied! Toggle word wrap Toggle overflow You can list multiple components in the same command.
Or:
sudo python /usr/share/openstack-tempest-13.0.0/tools/install_test_packages.py
$ sudo python /usr/share/openstack-tempest-13.0.0/tools/install_test_packages.pyCopy to Clipboard Copied! Toggle word wrap Toggle overflow Review the list of installed plugins:
tempest list-plugins
$ tempest list-pluginsCopy to Clipboard Copied! Toggle word wrap Toggle overflow See Section 3.3.1, “List of Tempest Plug-in Packages” for a list of available tempest plug-ins for each OpenStack component.
3.3.1. List of Tempest Plug-in Packages
| Component | Package Name |
|---|---|
| aodh | python-aodh-tests |
| ceilometer | python-ceilometer-tests |
| cinder | python-cinder-tests |
| designate | python-designate-tests-tempest |
| gnocchi | python-gnocchi-tests Note To ensure that the Gnocchi component installs correctly, install python-gnocchi-tests. |
| heat | python-heat-tests |
| horizon | python-horizon-tests-tempest |
| ironic | python-ironic-tests |
| keystone | python-keystone-tests |
| manila | python-manila-tests |
| mistral | python-mistral-tests |
| neutron | python-neutron-tests |
| neutron-fwaas | python-neutron-fwaas-tests |
| neutron-lbaas | python-neutron-lbaas-tests |
| neutron-vpnaas | python-neutron-vpnaas-tests |
| sahara | python-sahara-tests-tempest |
| zaqar | python-zaqar-tests |
nova, swift, and glance do not have individual test plugins; their tests reside within the tempest package.
'%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}