x
/
fenix
Code Issues Proposed changes
fenix/doc/source/install/common_prerequisites.rst

2.4 KiB
Raw Blame History

Prerequisites

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

      CREATE DATABASE fenix;

    • Grant proper access to the fenix database:

      GRANT ALL PRIVILEGES ON fenix.* TO 'fenix'@'localhost' \
  IDENTIFIED BY 'FENIX_DBPASS';
GRANT ALL PRIVILEGES ON fenix.* TO 'fenix'@'%' \
  IDENTIFIED BY 'FENIX_DBPASS';

      Replace FENIX_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 fenix user:

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

    • Add the admin role to the fenix user:

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

    • Create the fenix service entities:

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

    Note! In Fenix workflow you may want to have ssh access to all nodes for your Fenix action plug-ins to scp filex and locally execute scripts on those nodes. This means you may want to have the ssh without password configured for Fenix service user.

  4. Create the fenix service API endpoints:

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

Installation

Note! Fenix is not currently included to Linux distros. You need to clone and install from source.

$ git clone https://opendev.org/x/fenix
$ cd fenix
$ sudo python setup.py install