cyborg/doc/source/install/common_prerequisites.rst

Prerequisites

Before you install and configure the Accelerator Life Cycle Management 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 cyborg database:

     CREATE DATABASE cyborg;

   • Grant proper access to the cyborg database:

     GRANT ALL PRIVILEGES ON cyborg.* TO 'cyborg'@'localhost' IDENTIFIED BY 'CYBORG_DBPASS';

     Replace CYBORG_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 cyborg user:

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

   • Add the admin role to the cyborg user:

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

   • Create the cyborg service entities:

     $ openstack service create --name cyborg --description "Acceleration Service" accelerator

4. Create the Acceleration service API endpoints:

   • If cyborg-api service is deployed using uwsgi, create the following endpoints:

   $ openstack endpoint create --region RegionOne \
     accelerator public http://<cyborg-ip>/accelerator/v1
   $ openstack endpoint create --region RegionOne \
     accelerator internal http://<cyborg-ip>/accelerator/v1
   $ openstack endpoint create --region RegionOne \
     accelerator admin http://<cyborg-ip>/accelerator/v1

   • Otherwise, if cyborg-api service is running as a python process, create the following endpoints:

   $ openstack endpoint create --region RegionOne \
     accelerator public http://<cyborg-ip>:6666/v1
   $ openstack endpoint create --region RegionOne \
     accelerator internal http://<cyborg-ip>:6666/v1
   $ openstack endpoint create --region RegionOne \
     accelerator admin http://<cyborg-ip>:6666/v1

   Note

   URLs (publicurl, internalurl and adminurl) may be different depending on your environment.