Chapter 3. Installing the OpenStack Integration Test Suite
Chapter 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 : 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: 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: Create the public network. Specify the following options according to your network deployment: 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: This 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: See Section 3.3.1, "List of Tempest Plug-in Packages" for a list of the tempest plugins for each OpenStack component. Note 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: Component Package Name barbican python3-barbican-tests-tempest cinder python3-cinder-tests-tempest designate python3-designate-tests-tempest ec2-api python3-ec2api-tests-tempest heat python3-heat-tests-tempest horizon python3-horizon-tests-tempest ironic python3-ironic-tests-tempest keystone python3-keystone-tests-tempest kuryr python3-kuryr-tests-tempest manila python3-manila-tests-tempest mistral python3-mistral-tests-tempest networking-bgvpn python3-networking-bgpvpn-tests-tempest networking-l2gw python3-networking-l2gw-tests-tempest neutron python3-neutron-tests-tempest nova-join python3-novajoin-tests-tempest octavia python3-octavia-tests-tempest patrole python3-patrole-tests-tempest telemetry python3-telemetry-tests-tempest tripleo-common python3-tripleo-common-tests-tempest zaqar python3-zaqar-tests-tempest Note The python3-telemetry-tests-tempest package contains plugins for aodh, panko, gnocchi, and ceilometer tests. The python3-ironic-tests-tempest package contains plugins for ironic and ironic-inspector.
enable_tempest = true openstack undercloud upgrade 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> --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> sudo dnf -y install openstack-tempest sudo dnf install python3-keystone-tests-tempest python3-horizon-tests-tempest python3-neutron-tests-tempest python3-cinder-tests-tempest python3-telemetry-tests-tempest sudo dnf search USD(openstack service list -c Name -f value) 2>/dev/null | grep test | awk '{print USD1}'