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 | + +--------------------------------------------------------------------+