From 59f6423549c6a54adb8ac49e814bb07d11d394a7 Mon Sep 17 00:00:00 2001 From: melanie witt Date: Wed, 8 Feb 2017 18:57:15 +0000 Subject: [PATCH] Edits for Cells V2 step-by-step examples This addresses comments from the original patch set to add more detail to the steps. Change-Id: Ibebef30b499dc9b4c6ce8d43f4d8faf9eb93f809 --- doc/source/cells.rst | 39 ++++++++++++++++++++++++--------------- 1 file changed, 24 insertions(+), 15 deletions(-) diff --git a/doc/source/cells.rst b/doc/source/cells.rst index 10d4c32a9a0f..6ad06bb6690d 100644 --- a/doc/source/cells.rst +++ b/doc/source/cells.rst @@ -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:: - nova-manage cell_v2 map_cell0 --database_connection + nova-manage cell_v2 map_cell0 \ + --database_connection The database connection url is generated based on the ``[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 your compute hosts:: - nova-manage cell_v2 create_cell --name --transport-url - --database_connection + nova-manage cell_v2 create_cell --name \ + --transport-url \ + --database_connection The transport url is taken from the ``[DEFAULT]/transport_url`` setting in the Nova configuration file if not specified on the command line. The database url is taken from the ``[database]/connection`` setting in the Nova 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:: @@ -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 periodic task to have Nova discover new hosts automatically by setting 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) ~~~~~~~~~~~~~~~~~ @@ -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 single cell:: - nova-manage cell_v2 simple_cell_setup --transport-url + nova-manage cell_v2 simple_cell_setup \ + --transport-url The transport url is taken from the ``[DEFAULT]/transport_url`` setting in the Nova configuration file if not specified on the command line. The database connection url will be generated based on the ``[database]/connection`` setting in the Nova configuration file. -3. 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. You can also configure a periodic task to have Nova discover new - hosts automatically by setting the - ``[scheduler]/discover_hosts_in_cells_interval`` to a time interval in - seconds. +.. 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. You can also configure a periodic task to + have Nova discover new hosts automatically by setting the + ``[scheduler]/discover_hosts_in_cells_interval`` to a time interval + 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 ~~~~~~~~~~