Install and configure for Ubuntu¶

Prerequisites¶

Before you install and configure the Cyborg Python Client 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 cyborgclient database:

     CREATE DATABASE cyborgclient;
     

   • Grant proper access to the cyborgclient database:

     GRANT ALL PRIVILEGES ON cyborgclient.* TO 'cyborgclient'@'localhost' \
       IDENTIFIED BY 'CYBORGCLIENT_DBPASS';
     GRANT ALL PRIVILEGES ON cyborgclient.* TO 'cyborgclient'@'%' \
       IDENTIFIED BY 'CYBORGCLIENT_DBPASS';
     

     Replace CYBORGCLIENT_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 cyborgclient user:

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

   • Add the admin role to the cyborgclient user:

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

   • Create the cyborgclient service entities:

     $ openstack service create --name cyborgclient --description "Cyborg Python Client" cyborg python client
     

4. Create the Cyborg Python Client service API endpoints:

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

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

     [database]
     ...
     connection = mysql+pymysql://cyborgclient:CYBORGCLIENT_DBPASS@controller/cyborgclient
     

Finalize installation¶

Restart the Cyborg Python Client services:

# service openstack-cyborgclient-api restart