Install and configure for Ubuntu

This section describes how to install and configure the openstack service for Ubuntu 14.04 (LTS).

Prerequisites

Before you install and configure the openstack service, you must create a database, service credentials, and API endpoints.

1. To create the database, complete these steps:

   • Use the database access client to connect to the database server as the root user:

     $ mysql -u root -p
     

   • Create the zun_tempest_plugin database:

     CREATE DATABASE zun_tempest_plugin;
     

   • Grant proper access to the zun_tempest_plugin database:

     GRANT ALL PRIVILEGES ON zun_tempest_plugin.* TO 'zun_tempest_plugin'@'localhost' \
       IDENTIFIED BY 'ZUN_TEMPEST_PLUGIN_DBPASS';
     GRANT ALL PRIVILEGES ON zun_tempest_plugin.* TO 'zun_tempest_plugin'@'%' \
       IDENTIFIED BY 'ZUN_TEMPEST_PLUGIN_DBPASS';
     

     Replace ZUN_TEMPEST_PLUGIN_DBPASS with a suitable password.

   • Exit the database access client.

     exit;
     

2. Source the admin credentials to gain access to admin-only CLI commands:

   $ . admin-openrc
   

3. To create the service credentials, complete these steps:

   • Create the zun_tempest_plugin user:

     $ openstack user create --domain default --password-prompt zun_tempest_plugin
     

   • Add the admin role to the zun_tempest_plugin user:

     $ openstack role add --project service --user zun_tempest_plugin admin
     

   • Create the zun_tempest_plugin service entities:

     $ openstack service create --name zun_tempest_plugin --description "openstack" openstack
     

4. Create the openstack service API endpoints:

   $ openstack endpoint create --region RegionOne \
     openstack public http://controller:XXXX/vY/%\(tenant_id\)s
   $ openstack endpoint create --region RegionOne \
     openstack internal http://controller:XXXX/vY/%\(tenant_id\)s
   $ openstack endpoint create --region RegionOne \
     openstack admin http://controller:XXXX/vY/%\(tenant_id\)s
   

Install and configure components

1. Install the packages:

   # apt-get update
   
   # apt-get install
   

2. Edit the /etc/zun_tempest_plugin/zun_tempest_plugin.conf file and complete the following actions:

• In the [database] section, configure database access:

  [database]
  ...
  connection = mysql+pymysql://zun_tempest_plugin:ZUN_TEMPEST_PLUGIN_DBPASS@controller/zun_tempest_plugin
  

Finalize installation

Restart the openstack services:

# service openstack-zun_tempest_plugin-api restart