nova/releasenotes/notes/cells-discover-hosts-06a3079ba687e092.yaml
Andrew Laski 3eb4d1fd1d Add a TODO and add info to a releasenote
This updates the release notes for the new cellsv2 discover_hosts
command to be clear that it should be run at the API level. And adds a
TODO to provide a better error message if that is not done.

Change-Id: I51f113c2c445a9806675a9ee66f883d2b7f4f8f0
2016-08-30 14:16:12 -04:00

29 lines
1.7 KiB
YAML

---
features:
- A new nova-manage command has been added to discover any new hosts that are
added to a cell. If a deployment has migrated to cellsv2 using either the
simple_cell_setup or the map_cell0/map_cell_and_hosts/map_instances combo
then anytime a new host is added to a cell this new
"nova-manage cell_v2 discover_hosts" needs to be run before instances can
be booted on that host. If multiple hosts are added at one time the command
only needs to be run one time to discover all of them. This command should
be run from an API host, or a host that is configured to use the nova_api
database.
Please note that adding a host to a cell and not running this command could
lead to build failures/reschedules if that host is selected by the
scheduler. The discover_hosts command is necessary to route requests to the
host but is not necessary in order for the scheduler to be aware of the
host. It is advised that nova-compute hosts are configured with
"enable_new_services=False" in order to avoid failures before the hosts
have been discovered.
issues:
- If a deployer has updated their deployment to using cellsv2 using either
the simple_cell_setup or the map_cell0/map_cell_and_hosts/map_instances
combo and they add a new host into the cell it may cause build failures
or reschedules until they run the "nova-manage cell_v2 discover_hosts"
command. This is because the scheduler will quickly become aware of the
host but nova-api will not know how to route the request to that host until
it has been "discovered". In order to avoid that it is advised that
new computes are disabled until the discover command has been run.