Install and configure for openSUSE and SUSE Linux Enterprise

This section describes how to install and configure the congress service for openSUSE Leap 42.1 and SUSE Linux Enterprise Server 12 SP1.

Prerequisites

Before you install and configure the congress 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 congress_tempest_plugin database:

     CREATE DATABASE congress_tempest_plugin;
     

   • Grant proper access to the congress_tempest_plugin database:

     GRANT ALL PRIVILEGES ON congress_tempest_plugin.* TO 'congress_tempest_plugin'@'localhost' \
       IDENTIFIED BY 'CONGRESS_TEMPEST_PLUGIN_DBPASS';
     GRANT ALL PRIVILEGES ON congress_tempest_plugin.* TO 'congress_tempest_plugin'@'%' \
       IDENTIFIED BY 'CONGRESS_TEMPEST_PLUGIN_DBPASS';
     

     Replace CONGRESS_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 congress_tempest_plugin user:

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

   • Add the admin role to the congress_tempest_plugin user:

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

   • Create the congress_tempest_plugin service entities:

     $ openstack service create --name congress_tempest_plugin --description "congress" congress
     

4. Create the congress service API endpoints:

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

Install and configure components

1. Install the packages:

   # zypper --quiet --non-interactive install
   

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

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

     [database]
     ...
     connection = mysql+pymysql://congress_tempest_plugin:CONGRESS_TEMPEST_PLUGIN_DBPASS@controller/congress_tempest_plugin
     

Finalize installation

Start the congress services and configure them to start when the system boots:

# systemctl enable openstack-congress_tempest_plugin-api.service

# systemctl start openstack-congress_tempest_plugin-api.service