From e06c287cbf0639d85533b27527ffd562898db9af Mon Sep 17 00:00:00 2001 From: chenxing Date: Tue, 26 Jun 2018 03:38:08 -0400 Subject: [PATCH] Update install guide for placement database configuration Change-Id: I295fe539321bcce3449b522d54121985577c4b35 Partial-Bug: #1778227 --- doc/source/install/controller-install-obs.rst | 23 ++++++++++++++----- doc/source/install/controller-install-rdo.rst | 22 +++++++++++++----- .../install/controller-install-ubuntu.rst | 21 +++++++++++++---- 3 files changed, 49 insertions(+), 17 deletions(-) diff --git a/doc/source/install/controller-install-obs.rst b/doc/source/install/controller-install-obs.rst index 9ced92acc569..a4bc3bd5c295 100644 --- a/doc/source/install/controller-install-obs.rst +++ b/doc/source/install/controller-install-obs.rst @@ -19,13 +19,15 @@ databases, service credentials, and API endpoints. $ mysql -u root -p - * Create the ``nova_api``, ``nova``, and ``nova_cell0`` databases: + * Create the ``nova_api``, ``nova``, ``nova_cell0``, and ``placement`` + databases: .. code-block:: console MariaDB [(none)]> CREATE DATABASE nova_api; MariaDB [(none)]> CREATE DATABASE nova; MariaDB [(none)]> CREATE DATABASE nova_cell0; + MariaDB [(none)]> CREATE DATABASE placement; * Grant proper access to the databases: @@ -46,7 +48,12 @@ databases, service credentials, and API endpoints. MariaDB [(none)]> GRANT ALL PRIVILEGES ON nova_cell0.* TO 'nova'@'%' \ IDENTIFIED BY 'NOVA_DBPASS'; - Replace ``NOVA_DBPASS`` with a suitable password. + MariaDB [(none)]> GRANT ALL PRIVILEGES ON placement.* TO 'placement'@'localhost' \ + IDENTIFIED BY 'PLACEMENT_DBPASS'; + MariaDB [(none)]> GRANT ALL PRIVILEGES ON placement.* TO 'placement'@'%' \ + IDENTIFIED BY 'PLACEMENT_DBPASS'; + + Replace ``NOVA_DBPASS`` and ``PLACEMENT_DBPASS`` with a suitable password. * Exit the database access client. @@ -293,8 +300,8 @@ Install and configure components # ... enabled_apis = osapi_compute,metadata - * In the ``[api_database]`` and ``[database]`` sections, configure database - access: + * In the ``[api_database]``, ``[database]``, and ``[placement_database]`` + sections, configure database access: .. path /etc/nova/nova.conf .. code-block:: ini @@ -307,8 +314,12 @@ Install and configure components # ... connection = mysql+pymysql://nova:NOVA_DBPASS@controller/nova + [placement_database] + # ... + connection = mysql+pymysql://placement:PLACEMENT_DBPASS@controller/placement + Replace ``NOVA_DBPASS`` with the password you chose for the Compute - databases. + databases and ``PLACEMENT_DBPASS`` for Placement database. * In the ``[DEFAULT]`` section, configure ``RabbitMQ`` message queue access: @@ -434,7 +445,7 @@ Install and configure components ``placement`` user in the Identity service. Comment out any other options in the ``[placement]`` section. -#. Populate the ``nova-api`` database: +#. Populate the ``nova-api`` and ``placement`` databases: .. code-block:: console diff --git a/doc/source/install/controller-install-rdo.rst b/doc/source/install/controller-install-rdo.rst index b3217ea4a799..a69deb4daaa5 100644 --- a/doc/source/install/controller-install-rdo.rst +++ b/doc/source/install/controller-install-rdo.rst @@ -19,13 +19,14 @@ databases, service credentials, and API endpoints. $ mysql -u root -p - * Create the ``nova_api``, ``nova``, and ``nova_cell0`` databases: + * Create the ``nova_api``, ``nova``, ``nova_cell0``, and ``placement`` databases: .. code-block:: console MariaDB [(none)]> CREATE DATABASE nova_api; MariaDB [(none)]> CREATE DATABASE nova; MariaDB [(none)]> CREATE DATABASE nova_cell0; + MariaDB [(none)]> CREATE DATABASE placement; * Grant proper access to the databases: @@ -46,7 +47,12 @@ databases, service credentials, and API endpoints. MariaDB [(none)]> GRANT ALL PRIVILEGES ON nova_cell0.* TO 'nova'@'%' \ IDENTIFIED BY 'NOVA_DBPASS'; - Replace ``NOVA_DBPASS`` with a suitable password. + MariaDB [(none)]> GRANT ALL PRIVILEGES ON placement.* TO 'placement'@'localhost' \ + IDENTIFIED BY 'PLACEMENT_DBPASS'; + MariaDB [(none)]> GRANT ALL PRIVILEGES ON placement.* TO 'placement'@'%' \ + IDENTIFIED BY 'PLACEMENT_DBPASS'; + + Replace ``NOVA_DBPASS`` and ``PLACEMENT_DBPASS`` with a suitable password. * Exit the database access client. @@ -284,8 +290,8 @@ Install and configure components # ... enabled_apis = osapi_compute,metadata - * In the ``[api_database]`` and ``[database]`` sections, configure database - access: + * In the ``[api_database]``, ``[database]``, and ``[placement_database]`` + sections, configure database access: .. path /etc/nova/nova.conf .. code-block:: ini @@ -298,8 +304,12 @@ Install and configure components # ... connection = mysql+pymysql://nova:NOVA_DBPASS@controller/nova + [placement_database] + # ... + connection = mysql+pymysql://placement:PLACEMENT_DBPASS@controller/placement + Replace ``NOVA_DBPASS`` with the password you chose for the Compute - databases. + databases and ``PLACEMENT_DBPASS`` for Placement database. * In the ``[DEFAULT]`` section, configure ``RabbitMQ`` message queue access: @@ -448,7 +458,7 @@ Install and configure components # systemctl restart httpd -#. Populate the ``nova-api`` database: +#. Populate the ``nova-api`` and ``placement`` databases: .. code-block:: console diff --git a/doc/source/install/controller-install-ubuntu.rst b/doc/source/install/controller-install-ubuntu.rst index c97d9d8ad03a..a8f7b03c9dd5 100644 --- a/doc/source/install/controller-install-ubuntu.rst +++ b/doc/source/install/controller-install-ubuntu.rst @@ -19,13 +19,15 @@ databases, service credentials, and API endpoints. # mysql - * Create the ``nova_api``, ``nova``, and ``nova_cell0`` databases: + * Create the ``nova_api``, ``nova``, ``nova_cell0``, and ``placement`` + databases: .. code-block:: console MariaDB [(none)]> CREATE DATABASE nova_api; MariaDB [(none)]> CREATE DATABASE nova; MariaDB [(none)]> CREATE DATABASE nova_cell0; + MariaDB [(none)]> CREATE DATABASE placement; * Grant proper access to the databases: @@ -46,6 +48,11 @@ databases, service credentials, and API endpoints. MariaDB [(none)]> GRANT ALL PRIVILEGES ON nova_cell0.* TO 'nova'@'%' \ IDENTIFIED BY 'NOVA_DBPASS'; + MariaDB [(none)]> GRANT ALL PRIVILEGES ON placement.* TO 'placement'@'localhost' \ + IDENTIFIED BY 'PLACEMENT_DBPASS'; + MariaDB [(none)]> GRANT ALL PRIVILEGES ON placement.* TO 'placement'@'%' \ + IDENTIFIED BY 'PLACEMENT_DBPASS'; + Replace ``NOVA_DBPASS`` with a suitable password. * Exit the database access client. @@ -274,8 +281,8 @@ Install and configure components #. Edit the ``/etc/nova/nova.conf`` file and complete the following actions: - * In the ``[api_database]`` and ``[database]`` sections, configure database - access: + * In the ``[api_database]``, ``[database]``, and ``[placement_database]`` + sections, configure database access: .. path /etc/nova/nova.conf .. code-block:: ini @@ -288,8 +295,12 @@ Install and configure components # ... connection = mysql+pymysql://nova:NOVA_DBPASS@controller/nova + [placement_database] + # ... + connection = mysql+pymysql://placement:PLACEMENT_DBPASS@controller/placement + Replace ``NOVA_DBPASS`` with the password you chose for the Compute - databases. + databases and ``PLACEMENT_DBPASS`` for Placement database. * In the ``[DEFAULT]`` section, configure ``RabbitMQ`` message queue access: @@ -418,7 +429,7 @@ Install and configure components ``placement`` user in the Identity service. Comment out any other options in the ``[placement]`` section. -#. Populate the nova-api database: +#. Populate the ``nova-api`` and ``placement`` databases: .. code-block:: console