Install and configure for Ubuntu

This section describes how to install and configure the aetos service for Ubuntu 24.04 (LTS).

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:

    # apt-get update

# apt-get install aetos-api

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

Restart the aetos services:

# service openstack-aetos-api restart