Install and configure for Ubuntu

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

Prerequisites

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

     CREATE DATABASE pbrx;
     

   • Grant proper access to the pbrx database:

     GRANT ALL PRIVILEGES ON pbrx.* TO 'pbrx'@'localhost' \
       IDENTIFIED BY 'PBRX_DBPASS';
     GRANT ALL PRIVILEGES ON pbrx.* TO 'pbrx'@'%' \
       IDENTIFIED BY 'PBRX_DBPASS';
     

     Replace PBRX_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 pbrx user:

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

   • Add the admin role to the pbrx user:

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

   • Create the pbrx service entities:

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

4. Create the pbrx service API endpoints:

   $ openstack endpoint create --region RegionOne \
     pbrx public http://controller:XXXX/vY/%\(tenant_id\)s
   $ openstack endpoint create --region RegionOne \
     pbrx internal http://controller:XXXX/vY/%\(tenant_id\)s
   $ openstack endpoint create --region RegionOne \
     pbrx 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/pbrx/pbrx.conf file and complete the following actions:

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

     [database]
     ...
     connection = mysql+pymysql://pbrx:PBRX_DBPASS@controller/pbrx
     

Finalize installation

Restart the pbrx services:

# service openstack-pbrx-api restart