From f21b07153d7e7849883efde6a9b6c11288b17add Mon Sep 17 00:00:00 2001 From: Chris Dent Date: Thu, 3 Jan 2019 13:21:50 +0000 Subject: [PATCH] Remove placement from nova install docs In a fairly hack and slash fashion, remove the installation of placement from the nova install docs. Placement will have its own installation docs. Configuring access to placement from the controller and compute nodes is still described. The depends-on is to the patch that provides placement install docs. The output of 'nova-status upgrade check' is updated to reflect the current state of the output of that command; this means it now includes a fair bit more than checking cells v2 and the existence of the placement API. Depends-On: https://review.openstack.org/#/c/628220/ Change-Id: I9e082a9c6d4b6369f1ec6c17bbd3ccc417a5e97b --- doc/source/install/controller-install-obs.rst | 142 ++-------------- doc/source/install/controller-install-rdo.rst | 158 ++---------------- .../install/controller-install-ubuntu.rst | 132 ++------------- doc/source/install/get-started-compute.rst | 17 +- doc/source/install/verify.rst | 41 +++-- 5 files changed, 67 insertions(+), 423 deletions(-) diff --git a/doc/source/install/controller-install-obs.rst b/doc/source/install/controller-install-obs.rst index 9104530c30d6..01b77620d482 100644 --- a/doc/source/install/controller-install-obs.rst +++ b/doc/source/install/controller-install-obs.rst @@ -19,15 +19,13 @@ databases, service credentials, and API endpoints. $ mysql -u root -p - * Create the ``nova_api``, ``nova``, ``nova_cell0``, and ``placement`` - databases: + * Create the ``nova_api``, ``nova``, and ``nova_cell0`` 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: @@ -48,12 +46,7 @@ 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`` and ``PLACEMENT_DBPASS`` with a suitable password. + Replace ``NOVA_DBPASS`` with a suitable password. * Exit the database access client. @@ -166,107 +159,6 @@ databases, service credentials, and API endpoints. | url | http://controller:8774/v2.1 | +--------------+-------------------------------------------+ -#. Create a Placement service user using your chosen ``PLACEMENT_PASS``: - - .. code-block:: console - - $ openstack user create --domain default --password-prompt placement - - User Password: - Repeat User Password: - +---------------------+----------------------------------+ - | Field | Value | - +---------------------+----------------------------------+ - | domain_id | default | - | enabled | True | - | id | fa742015a6494a949f67629884fc7ec8 | - | name | placement | - | options | {} | - | password_expires_at | None | - +---------------------+----------------------------------+ - -#. Add the Placement user to the service project with the admin role: - - .. code-block:: console - - $ openstack role add --project service --user placement admin - - .. note:: - - This command provides no output. - -#. Create the Placement API entry in the service catalog: - - .. code-block:: console - - $ openstack service create --name placement \ - --description "Placement API" placement - - +-------------+----------------------------------+ - | Field | Value | - +-------------+----------------------------------+ - | description | Placement API | - | enabled | True | - | id | 2d1a27022e6e4185b86adac4444c495f | - | name | placement | - | type | placement | - +-------------+----------------------------------+ - -#. Create the Placement API service endpoints: - - .. code-block:: console - - $ openstack endpoint create --region RegionOne \ - placement public http://controller:8780 - - +--------------+----------------------------------+ - | Field | Value | - +--------------+----------------------------------+ - | enabled | True | - | id | 2b1b2637908b4137a9c2e0470487cbc0 | - | interface | public | - | region | RegionOne | - | region_id | RegionOne | - | service_id | 2d1a27022e6e4185b86adac4444c495f | - | service_name | placement | - | service_type | placement | - | url | http://controller:8780 | - +--------------+----------------------------------+ - - $ openstack endpoint create --region RegionOne \ - placement internal http://controller:8780 - - +--------------+----------------------------------+ - | Field | Value | - +--------------+----------------------------------+ - | enabled | True | - | id | 02bcda9a150a4bd7993ff4879df971ab | - | interface | internal | - | region | RegionOne | - | region_id | RegionOne | - | service_id | 2d1a27022e6e4185b86adac4444c495f | - | service_name | placement | - | service_type | placement | - | url | http://controller:8780 | - +--------------+----------------------------------+ - - $ openstack endpoint create --region RegionOne \ - placement admin http://controller:8780 - - +--------------+----------------------------------+ - | Field | Value | - +--------------+----------------------------------+ - | enabled | True | - | id | 3d71177b9e0f406f98cbff198d74b182 | - | interface | admin | - | region | RegionOne | - | region_id | RegionOne | - | service_id | 2d1a27022e6e4185b86adac4444c495f | - | service_name | placement | - | service_type | placement | - | url | http://controller:8780 | - +--------------+----------------------------------+ - Install and configure components -------------------------------- @@ -293,7 +185,7 @@ Install and configure components # zypper install openstack-nova-api openstack-nova-scheduler \ openstack-nova-conductor openstack-nova-consoleauth \ - openstack-nova-novncproxy openstack-nova-placement-api iptables + openstack-nova-novncproxy iptables #. Edit the ``/etc/nova/nova.conf`` file and complete the following actions: @@ -307,8 +199,8 @@ Install and configure components # ... enabled_apis = osapi_compute,metadata - * In the ``[api_database]``, ``[database]``, and ``[placement_database]`` - sections, configure database access: + * In the ``[api_database]`` and ``[database]`` sections, configure database + access: .. path /etc/nova/nova.conf .. code-block:: ini @@ -321,12 +213,8 @@ 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 and ``PLACEMENT_DBPASS`` for Placement database. + databases. * In the ``[DEFAULT]`` section, configure ``RabbitMQ`` message queue access: @@ -432,7 +320,8 @@ Install and configure components # ... lock_path = /var/run/nova - * In the ``[placement]`` section, configure the Placement API: + * In the ``[placement]`` section, configure access to the Placement + service: .. path /etc/nova/nova.conf .. code-block:: ini @@ -449,10 +338,11 @@ Install and configure components password = PLACEMENT_PASS Replace ``PLACEMENT_PASS`` with the password you choose for the - ``placement`` user in the Identity service. Comment out any other options - in the ``[placement]`` section. + ``placement`` service user created when installing + :placement-doc:`Placement `. Comment out or remove any other + options in the ``[placement]`` section. -#. Populate the ``nova-api`` and ``placement`` databases: +#. Populate the ``nova-api`` database: .. code-block:: console @@ -496,14 +386,6 @@ Install and configure components Finalize installation --------------------- -* Enable the placement API Apache vhost: - - .. code-block:: console - - # mv /etc/apache2/vhosts.d/nova-placement-api.conf.sample \ - /etc/apache2/vhosts.d/nova-placement-api.conf - # systemctl reload apache2.service - * Start the Compute services and configure them to start when the system boots: .. code-block:: console diff --git a/doc/source/install/controller-install-rdo.rst b/doc/source/install/controller-install-rdo.rst index b44a8b7f6142..7914aecf9901 100644 --- a/doc/source/install/controller-install-rdo.rst +++ b/doc/source/install/controller-install-rdo.rst @@ -19,14 +19,13 @@ databases, service credentials, and API endpoints. $ mysql -u root -p - * Create the ``nova_api``, ``nova``, ``nova_cell0``, and ``placement`` databases: + * Create the ``nova_api``, ``nova``, and ``nova_cell0`` 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: @@ -47,12 +46,7 @@ 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`` and ``PLACEMENT_DBPASS`` with a suitable password. + Replace ``NOVA_DBPASS`` with a suitable password. * Exit the database access client. @@ -165,107 +159,6 @@ databases, service credentials, and API endpoints. | url | http://controller:8774/v2.1 | +--------------+-------------------------------------------+ -#. Create a Placement service user using your chosen ``PLACEMENT_PASS``: - - .. code-block:: console - - $ openstack user create --domain default --password-prompt placement - - User Password: - Repeat User Password: - +---------------------+----------------------------------+ - | Field | Value | - +---------------------+----------------------------------+ - | domain_id | default | - | enabled | True | - | id | fa742015a6494a949f67629884fc7ec8 | - | name | placement | - | options | {} | - | password_expires_at | None | - +---------------------+----------------------------------+ - -#. Add the Placement user to the service project with the admin role: - - .. code-block:: console - - $ openstack role add --project service --user placement admin - - .. note:: - - This command provides no output. - -#. Create the Placement API entry in the service catalog: - - .. code-block:: console - - $ openstack service create --name placement \ - --description "Placement API" placement - - +-------------+----------------------------------+ - | Field | Value | - +-------------+----------------------------------+ - | description | Placement API | - | enabled | True | - | id | 2d1a27022e6e4185b86adac4444c495f | - | name | placement | - | type | placement | - +-------------+----------------------------------+ - -#. Create the Placement API service endpoints: - - .. code-block:: console - - $ openstack endpoint create --region RegionOne \ - placement public http://controller:8778 - - +--------------+----------------------------------+ - | Field | Value | - +--------------+----------------------------------+ - | enabled | True | - | id | 2b1b2637908b4137a9c2e0470487cbc0 | - | interface | public | - | region | RegionOne | - | region_id | RegionOne | - | service_id | 2d1a27022e6e4185b86adac4444c495f | - | service_name | placement | - | service_type | placement | - | url | http://controller:8778 | - +--------------+----------------------------------+ - - $ openstack endpoint create --region RegionOne \ - placement internal http://controller:8778 - - +--------------+----------------------------------+ - | Field | Value | - +--------------+----------------------------------+ - | enabled | True | - | id | 02bcda9a150a4bd7993ff4879df971ab | - | interface | internal | - | region | RegionOne | - | region_id | RegionOne | - | service_id | 2d1a27022e6e4185b86adac4444c495f | - | service_name | placement | - | service_type | placement | - | url | http://controller:8778 | - +--------------+----------------------------------+ - - $ openstack endpoint create --region RegionOne \ - placement admin http://controller:8778 - - +--------------+----------------------------------+ - | Field | Value | - +--------------+----------------------------------+ - | enabled | True | - | id | 3d71177b9e0f406f98cbff198d74b182 | - | interface | admin | - | region | RegionOne | - | region_id | RegionOne | - | service_id | 2d1a27022e6e4185b86adac4444c495f | - | service_name | placement | - | service_type | placement | - | url | http://controller:8778 | - +--------------+----------------------------------+ - Install and configure components -------------------------------- @@ -276,8 +169,7 @@ Install and configure components .. code-block:: console # yum install openstack-nova-api openstack-nova-conductor \ - openstack-nova-novncproxy openstack-nova-scheduler \ - openstack-nova-placement-api + openstack-nova-novncproxy openstack-nova-scheduler #. Edit the ``/etc/nova/nova.conf`` file and complete the following actions: @@ -290,8 +182,8 @@ Install and configure components # ... enabled_apis = osapi_compute,metadata - * In the ``[api_database]``, ``[database]``, and ``[placement_database]`` - sections, configure database access: + * In the ``[api_database]`` and ``[database]`` sections, configure database + access: .. path /etc/nova/nova.conf .. code-block:: ini @@ -304,12 +196,8 @@ 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 and ``PLACEMENT_DBPASS`` for Placement database. + databases. * In the ``[DEFAULT]`` section, configure ``RabbitMQ`` message queue access: @@ -414,7 +302,8 @@ Install and configure components # ... lock_path = /var/lib/nova/tmp - * In the ``[placement]`` section, configure the Placement API: + * In the ``[placement]`` section, configure access to the Placement + service: .. path /etc/nova/nova.conf .. code-block:: ini @@ -431,34 +320,11 @@ Install and configure components password = PLACEMENT_PASS Replace ``PLACEMENT_PASS`` with the password you choose for the - ``placement`` user in the Identity service. Comment out any other options - in the ``[placement]`` section. + ``placement`` service user created when installing + :placement-doc:`Placement `. Comment out or remove any other + options in the ``[placement]`` section. - * Due to a `packaging bug - `_, you must enable - access to the Placement API by adding the following configuration to - ``/etc/httpd/conf.d/00-nova-placement-api.conf``: - - .. path /etc/httpd/conf.d/00-nova-placement-api.conf - .. code-block:: ini - - - = 2.4> - Require all granted - - - Order allow,deny - Allow from all - - - - * Restart the httpd service: - - .. code-block:: console - - # systemctl restart httpd - -#. Populate the ``nova-api`` and ``placement`` databases: +#. Populate the ``nova-api`` database: .. code-block:: console diff --git a/doc/source/install/controller-install-ubuntu.rst b/doc/source/install/controller-install-ubuntu.rst index 001292c5bf43..5f7c6d2faed7 100644 --- a/doc/source/install/controller-install-ubuntu.rst +++ b/doc/source/install/controller-install-ubuntu.rst @@ -19,15 +19,13 @@ databases, service credentials, and API endpoints. # mysql - * Create the ``nova_api``, ``nova``, ``nova_cell0``, and ``placement`` - databases: + * Create the ``nova_api``, ``nova``, and ``nova_cell0`` 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: @@ -48,11 +46,6 @@ 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. @@ -166,107 +159,6 @@ databases, service credentials, and API endpoints. | url | http://controller:8774/v2.1 | +--------------+-------------------------------------------+ -#. Create a Placement service user using your chosen ``PLACEMENT_PASS``: - - .. code-block:: console - - $ openstack user create --domain default --password-prompt placement - - User Password: - Repeat User Password: - +---------------------+----------------------------------+ - | Field | Value | - +---------------------+----------------------------------+ - | domain_id | default | - | enabled | True | - | id | fa742015a6494a949f67629884fc7ec8 | - | name | placement | - | options | {} | - | password_expires_at | None | - +---------------------+----------------------------------+ - -#. Add the Placement user to the service project with the admin role: - - .. code-block:: console - - $ openstack role add --project service --user placement admin - - .. note:: - - This command provides no output. - -#. Create the Placement API entry in the service catalog: - - .. code-block:: console - - $ openstack service create --name placement \ - --description "Placement API" placement - - +-------------+----------------------------------+ - | Field | Value | - +-------------+----------------------------------+ - | description | Placement API | - | enabled | True | - | id | 2d1a27022e6e4185b86adac4444c495f | - | name | placement | - | type | placement | - +-------------+----------------------------------+ - -#. Create the Placement API service endpoints: - - .. code-block:: console - - $ openstack endpoint create --region RegionOne \ - placement public http://controller:8778 - - +--------------+----------------------------------+ - | Field | Value | - +--------------+----------------------------------+ - | enabled | True | - | id | 2b1b2637908b4137a9c2e0470487cbc0 | - | interface | public | - | region | RegionOne | - | region_id | RegionOne | - | service_id | 2d1a27022e6e4185b86adac4444c495f | - | service_name | placement | - | service_type | placement | - | url | http://controller:8778 | - +--------------+----------------------------------+ - - $ openstack endpoint create --region RegionOne \ - placement internal http://controller:8778 - - +--------------+----------------------------------+ - | Field | Value | - +--------------+----------------------------------+ - | enabled | True | - | id | 02bcda9a150a4bd7993ff4879df971ab | - | interface | internal | - | region | RegionOne | - | region_id | RegionOne | - | service_id | 2d1a27022e6e4185b86adac4444c495f | - | service_name | placement | - | service_type | placement | - | url | http://controller:8778 | - +--------------+----------------------------------+ - - $ openstack endpoint create --region RegionOne \ - placement admin http://controller:8778 - - +--------------+----------------------------------+ - | Field | Value | - +--------------+----------------------------------+ - | enabled | True | - | id | 3d71177b9e0f406f98cbff198d74b182 | - | interface | admin | - | region | RegionOne | - | region_id | RegionOne | - | service_id | 2d1a27022e6e4185b86adac4444c495f | - | service_name | placement | - | service_type | placement | - | url | http://controller:8778 | - +--------------+----------------------------------+ - Install and configure components -------------------------------- @@ -284,12 +176,12 @@ Install and configure components .. code-block:: console # apt install nova-api nova-conductor nova-consoleauth \ - nova-novncproxy nova-scheduler nova-placement-api + nova-novncproxy nova-scheduler #. Edit the ``/etc/nova/nova.conf`` file and complete the following actions: - * In the ``[api_database]``, ``[database]``, and ``[placement_database]`` - sections, configure database access: + * In the ``[api_database]`` and ``[database]`` sections, configure database + access: .. path /etc/nova/nova.conf .. code-block:: ini @@ -302,12 +194,8 @@ 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 and ``PLACEMENT_DBPASS`` for Placement database. + databases. * In the ``[DEFAULT]`` section, configure ``RabbitMQ`` message queue access: @@ -416,7 +304,8 @@ Install and configure components * Due to a packaging bug, remove the ``log_dir`` option from the ``[DEFAULT]`` section. - * In the ``[placement]`` section, configure the Placement API: + * In the ``[placement]`` section, configure access to the Placement + service: .. path /etc/nova/nova.conf .. code-block:: ini @@ -433,10 +322,11 @@ Install and configure components password = PLACEMENT_PASS Replace ``PLACEMENT_PASS`` with the password you choose for the - ``placement`` user in the Identity service. Comment out any other options - in the ``[placement]`` section. + ``placement`` service user created when installing + :placement-doc:`Placement `. Comment out or remove any other + options in the ``[placement]`` section. -#. Populate the ``nova-api`` and ``placement`` databases: +#. Populate the ``nova-api`` database: .. code-block:: console diff --git a/doc/source/install/get-started-compute.rst b/doc/source/install/get-started-compute.rst index 1225449719ed..cf8f2b48de42 100644 --- a/doc/source/install/get-started-compute.rst +++ b/doc/source/install/get-started-compute.rst @@ -8,12 +8,13 @@ Use OpenStack Compute to host and manage cloud computing systems. OpenStack Compute is a major part of an Infrastructure-as-a-Service (IaaS) system. The main modules are implemented in Python. -OpenStack Compute interacts with OpenStack Identity for authentication; -OpenStack Image service for disk and server images; and OpenStack Dashboard for -the user and administrative interface. Image access is limited by projects, and -by users; quotas are limited per project (the number of instances, for -example). OpenStack Compute can scale horizontally on standard hardware, and -download images to launch instances. +OpenStack Compute interacts with OpenStack Identity for authentication, +OpenStack Placement for resource inventory tracking and selection, OpenStack +Image service for disk and server images, and OpenStack Dashboard for the user +and administrative interface. Image access is limited by projects, and by +users; quotas are limited per project (the number of instances, for example). +OpenStack Compute can scale horizontally on standard hardware, and download +images to launch instances. OpenStack Compute consists of the following areas and their components: @@ -42,10 +43,6 @@ OpenStack Compute consists of the following areas and their components: queue and performs a series of system commands such as launching a KVM instance and updating its state in the database. -``nova-placement-api`` service - Tracks the inventory and usage of each provider. For details, see - :placement-doc:`Placement <>`. - ``nova-scheduler`` service Takes a virtual machine instance request from the queue and determines on which compute server host it runs. diff --git a/doc/source/install/verify.rst b/doc/source/install/verify.rst index b0333d0c4363..98d4b9de21b5 100644 --- a/doc/source/install/verify.rst +++ b/doc/source/install/verify.rst @@ -95,7 +95,8 @@ Verify operation of the Compute service. | 9a76d9f9-9620-4f2e-8c69-6c5691fae163 | cirros | active | +--------------------------------------+-------------+-------------+ -#. Check the cells and placement API are working successfully: +#. Check the cells and placement API are working successfully and that other + necessary prerequisites are in place: .. _verify-install-nova-status: @@ -103,18 +104,26 @@ Verify operation of the Compute service. # nova-status upgrade check - +---------------------------+ - | Upgrade Check Results | - +---------------------------+ - | Check: Cells v2 | - | Result: Success | - | Details: None | - +---------------------------+ - | Check: Placement API | - | Result: Success | - | Details: None | - +---------------------------+ - | Check: Resource Providers | - | Result: Success | - | Details: None | - +---------------------------+ + +--------------------------------------------------------------------+ + | Upgrade Check Results | + +--------------------------------------------------------------------+ + | Check: Cells v2 | + | Result: Success | + | Details: None | + +--------------------------------------------------------------------+ + | Check: Placement API | + | Result: Success | + | Details: None | + +--------------------------------------------------------------------+ + | Check: Ironic Flavor Migration | + | Result: Success | + | Details: None | + +--------------------------------------------------------------------+ + | Check: Request Spec Migration | + | Result: Success | + | Details: None | + +--------------------------------------------------------------------+ + | Check: Console Auths | + | Result: Success | + | Details: None | + +--------------------------------------------------------------------+