openstack/nova
Code Issues Proposed changes

Merge "Edits for Cells V2 step-by-step examples"

Browse Source
This commit is contained in:
Jenkins 2017-02-09 00:41:43 +00:00 committed by Gerrit Code Review
commit 9e87c48336
1 changed files with 24 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
doc/source/cells.rst
View File

@ -362,8 +362,8 @@ database yet. This will set up a single cell Nova deployment.
3. Run the ``map_cell0`` command to create and map cell0:: 3. Run the ``map_cell0`` command to create and map cell0::
nova-manage cell_v2 map_cell0 --database_connection <database connection nova-manage cell_v2 map_cell0 \
url> --database_connection <database connection url>
The database connection url is generated based on the The database connection url is generated based on the
``[database]/connection`` setting in the Nova configuration file if not ``[database]/connection`` setting in the Nova configuration file if not
@ -376,16 +376,17 @@ database yet. This will set up a single cell Nova deployment.
5. Run the ``create_cell`` command to create the single cell which will contain 5. Run the ``create_cell`` command to create the single cell which will contain
your compute hosts:: your compute hosts::
nova-manage cell_v2 create_cell --name <name> --transport-url nova-manage cell_v2 create_cell --name <name> \
<transport url for message queue> --database_connection <database --transport-url <transport url for message queue> \
connection url> --database_connection <database connection url>
The transport url is taken from the ``[DEFAULT]/transport_url`` setting in The transport url is taken from the ``[DEFAULT]/transport_url`` setting in
the Nova configuration file if not specified on the command line. The the Nova configuration file if not specified on the command line. The
database url is taken from the ``[database]/connection`` setting in the Nova database url is taken from the ``[database]/connection`` setting in the Nova
configuration file if not specified on the command line. configuration file if not specified on the command line.
6. Configure and start your compute hosts. 6. Configure and start your compute hosts. Before step 7, make sure you have
compute hosts in the database by running ``nova hypervisor-list``.
7. Run the ``discover_hosts`` command to map compute hosts to the single cell:: 7. Run the ``discover_hosts`` command to map compute hosts to the single cell::
@ -395,7 +396,13 @@ database yet. This will set up a single cell Nova deployment.
created in step 5 and map them to the cell. You can also configure a created in step 5 and map them to the cell. You can also configure a
periodic task to have Nova discover new hosts automatically by setting periodic task to have Nova discover new hosts automatically by setting
the ``[scheduler]/discover_hosts_in_cells_interval`` to a time interval in the ``[scheduler]/discover_hosts_in_cells_interval`` to a time interval in
seconds. seconds. The periodic task is run by the nova-scheduler service, so you must
be sure to configure it on all of your nova-scheduler hosts.
.. note:: Remember: In the future, whenever you add new compute hosts, you
will need to run the ``discover_hosts`` command after starting them
to map them to the cell if you did not configure the automatic host
discovery in step 7.
Upgrade (minimal) Upgrade (minimal)
~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~
@ -418,20 +425,22 @@ database. This will set up a single cell Nova deployment.
map the single cell, and map existing compute hosts and instances to the map the single cell, and map existing compute hosts and instances to the
single cell:: single cell::
nova-manage cell_v2 simple_cell_setup --transport-url <transport url for nova-manage cell_v2 simple_cell_setup \
message queue> --transport-url <transport url for message queue>
The transport url is taken from the ``[DEFAULT]/transport_url`` setting in The transport url is taken from the ``[DEFAULT]/transport_url`` setting in
the Nova configuration file if not specified on the command line. The the Nova configuration file if not specified on the command line. The
database connection url will be generated based on the database connection url will be generated based on the
``[database]/connection`` setting in the Nova configuration file. ``[database]/connection`` setting in the Nova configuration file.
3. Remember: In the future, whenever you add new compute hosts, you will need .. note:: Remember: In the future, whenever you add new compute hosts, you
to run the ``discover_hosts`` command after starting them, to map them to will need to run the ``discover_hosts`` command after starting them
the cell. You can also configure a periodic task to have Nova discover new to map them to the cell. You can also configure a periodic task to
hosts automatically by setting the have Nova discover new hosts automatically by setting the
``[scheduler]/discover_hosts_in_cells_interval`` to a time interval in ``[scheduler]/discover_hosts_in_cells_interval`` to a time interval
seconds. in seconds. The periodic task is run by the nova-scheduler service,
so you must be sure to configure it on all of your nova-scheduler
hosts.
References References
~~~~~~~~~~ ~~~~~~~~~~