Install and configure for Red Hat Enterprise Linux and CentOS

This section describes how to install and configure the pbrx service for Red Hat Enterprise Linux 7 and CentOS 7.

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:

    # yum install

  1. 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

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

# systemctl enable openstack-pbrx-api.service

# systemctl start openstack-pbrx-api.service