watcher/doc/source/install/common_prerequisites.rst
zhang.lei a1b0c09005 Remove -u root as mysql is executed with root user
As openstack installation guides suggest to run mysql with root shell
user, mysql will not ask for password, so in
controller-install-*.rst "-u root -p" is useless.

Change-Id: I511f39d734702ab3d1a209f7d868f52fb184f1fc
Related-Bug: #1785025
2018-08-14 12:08:23 +00:00

5.3 KiB

Prerequisites

Before you install and configure the Infrastructure Optimization service, you must create a database, service credentials, and API endpoints.

  1. Create the database, complete these steps:

    • Use the database access client to connect to the database server as the root user:

      # mysql
    • Create the watcher database:

      CREATE DATABASE watcher CHARACTER SET utf8;
    • Grant proper access to the watcher database:

      GRANT ALL PRIVILEGES ON watcher.* TO 'watcher'@'localhost' \
        IDENTIFIED BY 'WATCHER_DBPASS';
      GRANT ALL PRIVILEGES ON watcher.* TO 'watcher'@'%' \
        IDENTIFIED BY 'WATCHER_DBPASS';

      Replace WATCHER_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 watcher user:

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

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

      Note

      This command produces no output.

    • Create the watcher service entities:

      $ openstack service create --name watcher --description "Infrastructure Optimization" infra-optim
        +-------------+----------------------------------+
        | Field       | Value                            |
        +-------------+----------------------------------+
        | description | Infrastructure Optimization      |
        | enabled     | True                             |
        | id          | d854f6fff0a64f77bda8003c8dedfada |
        | name        | watcher                          |
        | type        | infra-optim                      |
        +-------------+----------------------------------+
  4. Create the Infrastructure Optimization service API endpoints:

    $ openstack endpoint create --region RegionOne \
      infra-optim public http://controller:9322
      +-------------+----------------------------------+
      | Field       | Value                            |
      +-------------+----------------------------------+
      | description | Infrastructure Optimization      |
      | enabled     | True                             |
      | id          | d854f6fff0a64f77bda8003c8dedfada |
      | name        | watcher                          |
      | type        | infra-optim                      |
      +-------------+----------------------------------+
    
    $ openstack endpoint create --region RegionOne \
      infra-optim internal http://controller:9322
      +--------------+----------------------------------+
      | Field        | Value                            |
      +--------------+----------------------------------+
      | enabled      | True                             |
      | id           | 225aef8465ef4df48a341aaaf2b0a390 |
      | interface    | internal                         |
      | region       | RegionOne                        |
      | region_id    | RegionOne                        |
      | service_id   | d854f6fff0a64f77bda8003c8dedfada |
      | service_name | watcher                          |
      | service_type | infra-optim                      |
      | url          | http://controller:9322           |
      +--------------+----------------------------------+
    
    $ openstack endpoint create --region RegionOne \
      infra-optim admin http://controller:9322
      +--------------+----------------------------------+
      | Field        | Value                            |
      +--------------+----------------------------------+
      | enabled      | True                             |
      | id           | 375eb5057fb546edbdf3ee4866179672 |
      | interface    | admin                            |
      | region       | RegionOne                        |
      | region_id    | RegionOne                        |
      | service_id   | d854f6fff0a64f77bda8003c8dedfada |
      | service_name | watcher                          |
      | service_type | infra-optim                      |
      | url          | http://controller:9322           |
      +--------------+----------------------------------+