Install and configure for Red Hat Enterprise Linux and CentOS

This section describes how to install and configure the aetos service for Red Hat Enterprise Linux 9 and CentOS Stream 9.

Prerequisites

Before you install and configure the aetos service, you must create service credentials, and API endpoints.

1. Source the admin credentials to gain access to admin-only CLI commands:

   $ . admin-openrc
   

2. To create the service credentials, complete these steps:

   • Create the aetos user:

     $ openstack user create --domain default --password-prompt aetos
     User Password:
     Repeat User Password:
     +---------------------+----------------------------------+
     | Field               | Value                            |
     +---------------------+----------------------------------+
     | domain_id           | default                          |
     | enabled             | True                             |
     | id                  | b7657c9ea07a4556aef5d34cf70713a3 |
     | name                | aetos                            |
     | options             | {}                               |
     | password_expires_at | None                             |
     +---------------------+----------------------------------+
     

   • Add the admin role to the aetos user:

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

     Note

     This command provides no output.

   • Create the aetos service entities:

     $ openstack service create --name aetos --description "OpenStack Aetos Service" prometheus
     +-------------+----------------------------------+
     | Field       | Value                            |
     +-------------+----------------------------------+
     | description | OpenStack Aetos Service          |
     | enabled     | True                             |
     | id          | 3405453b14da441ebb258edfeba96d83 |
     | name        | aetos                            |
     | type        | prometheus                       |
     +-------------+----------------------------------+
     

3. Create the aetos service API endpoints:

   $ openstack endpoint create --region RegionOne \
     prometheus public http://controller/prometheus
     +--------------+-----------------------------------+
     | Field        | Value                             |
     +--------------+-----------------------------------+
     | enabled      | True                              |
     | id           | 1196727cc22a4a26a011688236c38da9  |
     | interface    | public                            |
     | region       | RegionOne                         |
     | region_id    | RegionOne                         |
     | service_id   | 3405453b14da441ebb258edfeba96d83  |
     | service_name | aetos                             |
     | service_type | prometheus                        |
     | url          | http://controller/prometheus      |
     +--------------+-----------------------------------+
   $ openstack endpoint create --region RegionOne \
     prometheus internal http://controller/prometheus
     +--------------+-----------------------------------+
     | Field        | Value                             |
     +--------------+-----------------------------------+
     | enabled      | True                              |
     | id           | 1196727cc22a4a26a011688236c38da9  |
     | interface    | internal                          |
     | region       | RegionOne                         |
     | region_id    | RegionOne                         |
     | service_id   | 3405453b14da441ebb258edfeba96d83  |
     | service_name | aetos                             |
     | service_type | prometheus                        |
     | url          | http://controller/prometheus      |
     +--------------+-----------------------------------+
   $ openstack endpoint create --region RegionOne \
     prometheus admin http://controller/prometheus
     +--------------+-----------------------------------+
     | Field        | Value                             |
     +--------------+-----------------------------------+
     | enabled      | True                              |
     | id           | 1196727cc22a4a26a011688236c38da9  |
     | interface    | admin                             |
     | region       | RegionOne                         |
     | region_id    | RegionOne                         |
     | service_id   | 3405453b14da441ebb258edfeba96d83  |
     | service_name | aetos                             |
     | service_type | prometheus                        |
     | url          | http://controller/prometheus      |
     +--------------+-----------------------------------+
   

Install and configure components

1. Install the packages:

   # dnf install openstack-aetos-api
   

2. Edit the /etc/aetos/aetos.conf file and complete the following actions:

   • In the [DEFAULT] section, configure prometheus access:

     [DEFAULT]
     prometheus_host=localhost
     prometheus_port=9090
     

   • In the [DEFAULT] and [keystone_authtoken] sections, configure Identity service access:

     [DEFAULT]
     ...
     auth_strategy = keystone
     
     [keystone_authtoken]
     ...
     www_authenticate_uri = http://controller:5000
     auth_url = http://controller:5000
     memcached_servers = controller:11211
     auth_type = password
     project_domain_id = default
     user_domain_id = default
     project_name = service
     username = aetos
     password = AETOS_PASS
     

     Replace AETOS_PASS with the password you chose for the aetos user in the Identity service.

Finalize installation

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

# systemctl enable openstack-aetos-api.service

# systemctl start openstack-aetos-api.service