aodh/doc/source/install/prereq-common.rst
Hangdong Zhang ee801ff3e8 Update the response table info of some sample commands in doc.
I found the response table info of some sanple commands were out of date,
so I update them after my practice with the latest codes.

Change-Id: Ife8d6365aad5a34d518985d25547ed5a71d41c5e
2017-07-14 14:55:08 +08:00

5.4 KiB

Prerequisites

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

      CREATE DATABASE aodh;
    • Grant proper access to the aodh database:

      GRANT ALL PRIVILEGES ON aodh.* TO 'aodh'@'localhost' \
        IDENTIFIED BY 'AODH_DBPASS';
      GRANT ALL PRIVILEGES ON aodh.* TO 'aodh'@'%' \
        IDENTIFIED BY 'AODH_DBPASS';

      Replace AODH_DBPASS with a suitable password.

    • Exit the database access client.

  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 aodh user:

      $ openstack user create --domain default \
        --password-prompt aodh
      User Password:
      Repeat User Password:
      +---------------------+----------------------------------+
      | Field               | Value                            |
      +---------------------+----------------------------------+
      | domain_id           | default                          |
      | enabled             | True                             |
      | id                  | b7657c9ea07a4556aef5d34cf70713a3 |
      | name                | aodh                             |
      | options             | {}                               |
      | password_expires_at | None                             |
      +---------------------+----------------------------------+
    • Add the admin role to the aodh user:

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

      Note

      This command provides no output.

    • Create the aodh service entity:

      $ openstack service create --name aodh \
        --description "Telemetry" alarming
      +-------------+----------------------------------+
      | Field       | Value                            |
      +-------------+----------------------------------+
      | description | Telemetry                        |
      | enabled     | True                             |
      | id          | 3405453b14da441ebb258edfeba96d83 |
      | name        | aodh                             |
      | type        | alarming                         |
      +-------------+----------------------------------+
  4. Create the Alarming service API endpoints:

    $ openstack endpoint create --region RegionOne \
      alarming public http://controller:8042
      +--------------+----------------------------------+
      | Field        | Value                            |
      +--------------+----------------------------------+
      | enabled      | True                             |
      | id           | 340be3625e9b4239a6415d034e98aace |
      | interface    | public                           |
      | region       | RegionOne                        |
      | region_id    | RegionOne                        |
      | service_id   | 8c2c7f1b9b5049ea9e63757b5533e6d2 |
      | service_name | aodh                             |
      | service_type | alarming                         |
      | url          | http://controller:8042           |
      +--------------+----------------------------------+
    
    $ openstack endpoint create --region RegionOne \
      alarming internal http://controller:8042
      +--------------+----------------------------------+
      | Field        | Value                            |
      +--------------+----------------------------------+
      | enabled      | True                             |
      | id           | 340be3625e9b4239a6415d034e98aace |
      | interface    | internal                         |
      | region       | RegionOne                        |
      | region_id    | RegionOne                        |
      | service_id   | 8c2c7f1b9b5049ea9e63757b5533e6d2 |
      | service_name | aodh                             |
      | service_type | alarming                         |
      | url          | http://controller:8042           |
      +--------------+----------------------------------+
    
    $ openstack endpoint create --region RegionOne \
      alarming admin http://controller:8042
      +--------------+----------------------------------+
      | Field        | Value                            |
      +--------------+----------------------------------+
      | enabled      | True                             |
      | id           | 340be3625e9b4239a6415d034e98aace |
      | interface    | admin                            |
      | region       | RegionOne                        |
      | region_id    | RegionOne                        |
      | service_id   | 8c2c7f1b9b5049ea9e63757b5533e6d2 |
      | service_name | aodh                             |
      | service_type | alarming                         |
      | url          | http://controller:8042           |
      +--------------+----------------------------------+