Merge "[install-guide-rst] add nova chapter"
This commit is contained in:
Jenkins
Gerrit Code Review
commit
8f318099db
4
doc/install-guide-rst/source/nova-compute-install.rst
Normal file
4
doc/install-guide-rst/source/nova-compute-install.rst
Normal file
@ -0,0 +1,4 @@
|
||||
Install and configure a compute node
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
.. TODO
|
||||
360
doc/install-guide-rst/source/nova-controller-install.rst
Normal file
360
doc/install-guide-rst/source/nova-controller-install.rst
Normal file
@ -0,0 +1,360 @@
|
||||
Install and configure controller node
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
This section describes how to install and configure the
|
||||
Compute service, code-named nova, on the controller node.
|
||||
|
||||
To configure prerequisites
|
||||
--------------------------
|
||||
|
||||
Before you install and configure the Compute service, you must
|
||||
create a database, service credentials, and API endpoint.
|
||||
|
||||
#. To create the database, complete these steps:
|
||||
|
||||
* Use the database access client to connect to
|
||||
the database server as the ``root`` user:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ mysql -u root -p
|
||||
|
||||
* Create the ``nova`` database:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
CREATE DATABASE nova;
|
||||
|
||||
* Grant proper access to the ``nova`` database:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
GRANT ALL PRIVILEGES ON nova.* TO 'nova'@'localhost' \
|
||||
IDENTIFIED BY 'NOVA_DBPASS';
|
||||
GRANT ALL PRIVILEGES ON nova.* TO 'nova'@'%' \
|
||||
IDENTIFIED BY 'NOVA_DBPASS';
|
||||
|
||||
Replace ``NOVA_DBPASS`` with a suitable password.
|
||||
|
||||
* Exit the database access client.
|
||||
|
||||
#. Source the ``admin`` credentials to gain access to
|
||||
admin-only CLI commands:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ source admin-openrc.sh
|
||||
|
||||
#. To create the service credentials, complete these steps:
|
||||
|
||||
* Create the ``nova`` user:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ openstack user create --password-prompt nova
|
||||
User Password:
|
||||
Repeat User Password:
|
||||
+----------+----------------------------------+
|
||||
| Field | Value |
|
||||
+----------+----------------------------------+
|
||||
| email | None |
|
||||
| enabled | True |
|
||||
| id | 8e0b71d732db4bfba04943a96230c8c0 |
|
||||
| name | nova |
|
||||
| username | nova |
|
||||
+----------+----------------------------------+
|
||||
|
||||
* Add the ``admin`` role to the ``nova`` user:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ openstack role add --project service --user nova admin
|
||||
+-------+----------------------------------+
|
||||
| Field | Value |
|
||||
+-------+----------------------------------+
|
||||
| id | cd2cb9a39e874ea69e5d4b896eb16128 |
|
||||
| name | admin |
|
||||
+-------+----------------------------------+
|
||||
|
||||
* Create the ``nova`` service entity:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ openstack service create --name nova \
|
||||
--description "OpenStack Compute" compute
|
||||
+-------------+----------------------------------+
|
||||
| Field | Value |
|
||||
+-------------+----------------------------------+
|
||||
| description | OpenStack Compute |
|
||||
| enabled | True |
|
||||
| id | 060d59eac51b4594815603d75a00aba2 |
|
||||
| name | nova |
|
||||
| type | compute |
|
||||
+-------------+----------------------------------+
|
||||
|
||||
#. Create the Compute service API endpoint:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ openstack endpoint create \
|
||||
--publicurl http://controller:8774/v2/%\(tenant_id\)s \
|
||||
--internalurl http://controller:8774/v2/%\(tenant_id\)s \
|
||||
--adminurl http://controller:8774/v2/%\(tenant_id\)s \
|
||||
--region RegionOne \
|
||||
compute
|
||||
+--------------+-----------------------------------------+
|
||||
| Field | Value |
|
||||
+--------------+-----------------------------------------+
|
||||
| adminurl | http://controller:8774/v2/%(tenant_id)s |
|
||||
| id | 4e885d4ad43f4c4fbf2287734bc58d6b |
|
||||
| internalurl | http://controller:8774/v2/%(tenant_id)s |
|
||||
| publicurl | http://controller:8774/v2/%(tenant_id)s |
|
||||
| region | RegionOne |
|
||||
| service_id | 060d59eac51b4594815603d75a00aba2 |
|
||||
| service_name | nova |
|
||||
| service_type | compute |
|
||||
+--------------+-----------------------------------------+
|
||||
|
||||
To install and configure Compute controller components
|
||||
------------------------------------------------------
|
||||
|
||||
.. note::
|
||||
|
||||
Default configuration files vary by distribution. You might need
|
||||
to add these sections and options rather than modifying existing
|
||||
sections and options. Also, an ellipsis (...) in the configuration
|
||||
snippets indicates potential default configuration options that you
|
||||
should retain.
|
||||
|
||||
.. only:: obs
|
||||
|
||||
1. Install the packages:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# zypper install openstack-nova-api openstack-nova-scheduler \
|
||||
openstack-nova-cert openstack-nova-conductor \
|
||||
openstack-nova-consoleauth openstack-nova-novncproxy \
|
||||
python-novaclient iptables
|
||||
|
||||
.. only:: rdo
|
||||
|
||||
1. Install the packages:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# yum install openstack-nova-api openstack-nova-cert \
|
||||
openstack-nova-conductor openstack-nova-console \
|
||||
openstack-nova-novncproxy openstack-nova-scheduler \
|
||||
python-novaclient
|
||||
|
||||
.. only:: ubuntu
|
||||
|
||||
1. Install the packages:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# apt-get install nova-api nova-cert nova-conductor \
|
||||
nova-consoleauth nova-novncproxy nova-scheduler \
|
||||
python-novaclient
|
||||
|
||||
2. Edit the :file:`/etc/nova/nova.conf` file and
|
||||
complete the following actions:
|
||||
|
||||
* Add a ``[database]`` section, and configure database access:
|
||||
|
||||
.. code-block:: ini
|
||||
|
||||
[database]
|
||||
...
|
||||
connection = mysql://nova:NOVA_DBPASS@controller/nova
|
||||
|
||||
Replace ``NOVA_DBPASS`` with the password you chose for
|
||||
the Compute database.
|
||||
|
||||
* In the ``[DEFAULT]`` and ``[oslo_messaging_rabbit]`` sections,
|
||||
configure ``RabbitMQ`` message queue access:
|
||||
|
||||
.. code-block:: ini
|
||||
|
||||
[DEFAULT]
|
||||
...
|
||||
rpc_backend = rabbit
|
||||
|
||||
[oslo_messaging_rabbit]
|
||||
...
|
||||
rabbit_host = controller
|
||||
rabbit_userid = openstack
|
||||
rabbit_password = RABBIT_PASS
|
||||
|
||||
Replace ``RABBIT_PASS`` with the password you chose for the
|
||||
``openstack`` account in ``RabbitMQ``.
|
||||
|
||||
* In the ``[DEFAULT]`` and ``[keystone_authtoken]`` sections,
|
||||
configure Identity service access:
|
||||
|
||||
.. code-block:: ini
|
||||
|
||||
[DEFAULT]
|
||||
...
|
||||
auth_strategy = keystone
|
||||
|
||||
[keystone_authtoken]
|
||||
...
|
||||
auth_uri = http://controller:5000
|
||||
auth_url = http://controller:35357
|
||||
auth_plugin = password
|
||||
project_domain_id = default
|
||||
user_domain_id = default
|
||||
project_name = service
|
||||
username = nova
|
||||
password = NOVA_PASS
|
||||
|
||||
Replace ``NOVA_PASS`` with the password you chose for the
|
||||
``nova`` user in the Identity service.
|
||||
|
||||
.. note::
|
||||
|
||||
Comment out or remove any other options in the
|
||||
``[keystone_authtoken]`` section.
|
||||
|
||||
* In the ``[DEFAULT]`` section, configure the ``my_ip`` option to
|
||||
use the management interface IP address of the controller node:
|
||||
|
||||
.. code-block:: ini
|
||||
|
||||
[DEFAULT]
|
||||
...
|
||||
my_ip = 10.0.0.11
|
||||
|
||||
* In the ``[DEFAULT]`` section, configure the VNC proxy to use
|
||||
the management interface IP address of the controller node:
|
||||
|
||||
.. code-block:: ini
|
||||
|
||||
[DEFAULT]
|
||||
...
|
||||
vncserver_listen = 10.0.0.11
|
||||
vncserver_proxyclient_address = 10.0.0.11
|
||||
|
||||
* In the ``[glance]`` section, configure the location of the
|
||||
Image service:
|
||||
|
||||
.. code-block:: ini
|
||||
|
||||
[glance]
|
||||
...
|
||||
host = controller
|
||||
|
||||
.. only:: obs
|
||||
|
||||
* In the ``[oslo_concurrency]`` section, configure the lock path:
|
||||
|
||||
.. code-block:: ini
|
||||
|
||||
[oslo_concurrency]
|
||||
...
|
||||
lock_path = /var/run/nova
|
||||
|
||||
.. only:: rdo
|
||||
|
||||
* In the ``[oslo_concurrency]`` section, configure the lock path:
|
||||
|
||||
.. code-block:: ini
|
||||
|
||||
[oslo_concurrency]
|
||||
...
|
||||
lock_path = /var/lib/nova/tmp
|
||||
|
||||
.. only:: ubuntu
|
||||
|
||||
* In the ``[oslo_concurrency]`` section, configure the lock path:
|
||||
|
||||
.. code-block:: ini
|
||||
|
||||
[oslo_concurrency]
|
||||
...
|
||||
lock_path = /var/lib/nova/tmp
|
||||
|
||||
|
||||
* (Optional) To assist with troubleshooting, enable verbose
|
||||
logging in the ``[DEFAULT]`` section:
|
||||
|
||||
.. code-block:: ini
|
||||
|
||||
[DEFAULT]
|
||||
...
|
||||
verbose = True
|
||||
|
||||
.. only:: rdo
|
||||
|
||||
3. Populate the Compute database:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# su -s /bin/sh -c "nova-manage db sync" nova
|
||||
|
||||
.. only:: ubuntu
|
||||
|
||||
3. Populate the Compute database:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# su -s /bin/sh -c "nova-manage db sync" nova
|
||||
|
||||
To finalize installation
|
||||
------------------------
|
||||
|
||||
.. only:: obs
|
||||
|
||||
* Start the Compute services and configure them to start
|
||||
when the system boots:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# systemctl enable openstack-nova-api.service \
|
||||
openstack-nova-cert.service openstack-nova-consoleauth.service \
|
||||
openstack-nova-scheduler.service openstack-nova-conductor.service \
|
||||
openstack-nova-novncproxy.service
|
||||
# systemctl start openstack-nova-api.service \
|
||||
openstack-nova-cert.service openstack-nova-consoleauth.service \
|
||||
openstack-nova-scheduler.service openstack-nova-conductor.service \
|
||||
openstack-nova-novncproxy.service
|
||||
|
||||
.. only:: rdo
|
||||
|
||||
* Start the Compute services and configure them to start
|
||||
when the system boots:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# systemctl enable openstack-nova-api.service \
|
||||
openstack-nova-cert.service openstack-nova-consoleauth.service \
|
||||
openstack-nova-scheduler.service openstack-nova-conductor.service \
|
||||
openstack-nova-novncproxy.service
|
||||
# systemctl start openstack-nova-api.service \
|
||||
openstack-nova-cert.service openstack-nova-consoleauth.service \
|
||||
openstack-nova-scheduler.service openstack-nova-conductor.service \
|
||||
openstack-nova-novncproxy.service
|
||||
|
||||
.. only:: ubuntu
|
||||
|
||||
* Restart the Compute services:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# service nova-api restart
|
||||
# service nova-cert restart
|
||||
# service nova-consoleauth restart
|
||||
# service nova-scheduler restart
|
||||
# service nova-conductor restart
|
||||
# service nova-novncproxy restart
|
||||
|
||||
* By default, the Ubuntu packages create an SQLite database.
|
||||
|
||||
Because this configuration uses a SQL database server,
|
||||
you can remove the SQLite database file:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# rm -f /var/lib/nova/nova.sqlite
|
||||
4
doc/install-guide-rst/source/nova-verify.rst
Normal file
4
doc/install-guide-rst/source/nova-verify.rst
Normal file
@ -0,0 +1,4 @@
|
||||
Verify operation
|
||||
~~~~~~~~~~~~~~~~
|
||||
|
||||
.. TODO
|
||||
@ -1,3 +1,17 @@
|
||||
=======================
|
||||
Add the Compute service
|
||||
=======================
|
||||
|
||||
.. TODO: common/section_getstart_nova.rst
|
||||
under migration by admin-guide-cloud (katomo)
|
||||
|
||||
.. include:: nova-controller-install.rst
|
||||
.. include:: nova-compute-install.rst
|
||||
.. include:: nova-verify.rst
|
||||
|
||||
.. toctree::
|
||||
:hidden:
|
||||
|
||||
nova-controller-install.rst
|
||||
nova-compute-install.rst
|
||||
nova-verify.rst
|
||||
|
||||
Loading…
Reference in New Issue
Block a user