openstack/nova
Code Issues Proposed changes

Update document related to host aggregate

Browse Source 
The arguments of nova CLI commands related to host aggregate
(I93f44a12b6d5a91b448f6f8d238311d58bf40c01) are fixed.
The host APIs have been deprecated since microversion 2.43.
So remove description related to nova host commands.
And add description about nova hypervisor commands.

Change-Id: Ibf78865844da6f007b610f12430df4866076f00b
Closes-Bug: #1726658
This commit is contained in:
Takashi NATSUME 2017-10-23 22:10:08 +09:00
parent 8fd4f9a029
commit fa43227f6e
2 changed files with 60 additions and 25 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

40
doc/source/admin/configuration/schedulers.rst
View File

@ -986,16 +986,16 @@ aggregate-related commands.
nova aggregate-list nova aggregate-list
Print a list of all aggregates. Print a list of all aggregates.
nova aggregate-create <name> [availability-zone] nova aggregate-create <name> [<availability-zone>]
Create a new aggregate named ``<name>``, and optionally in availability zone Create a new aggregate named ``<name>``, and optionally in availability zone
``[availability-zone]`` if specified. The command returns the ID of the newly ``[<availability-zone>]`` if specified. The command returns the ID of the
created aggregate. Hosts can be made available to multiple host aggregates. newly created aggregate. Hosts can be made available to multiple host
Be careful when adding a host to an additional host aggregate when the host aggregates. Be careful when adding a host to an additional host aggregate
is also in an availability zone. Pay attention when using the :command:`nova when the host is also in an availability zone. Pay attention when using the
aggregate-set-metadata` and :command:`nova aggregate-update` commands to :command:`nova aggregate-set-metadata` and :command:`nova aggregate-update`
avoid user confusion when they boot instances in different availability commands to avoid user confusion when they boot instances in different
zones. An error occurs if you cannot add a particular host to an aggregate availability zones. An error occurs if you cannot add a particular host to
zone for which it is not intended. an aggregate zone for which it is not intended.
nova aggregate-delete <aggregate> nova aggregate-delete <aggregate>
Delete an aggregate with its ``<id>`` or ``<name>``. Delete an aggregate with its ``<id>`` or ``<name>``.
@ -1014,14 +1014,26 @@ nova aggregate-set-metadata <aggregate> <key=value> [<key=value> ...]
Add or update metadata (key-value pairs) associated with the aggregate with Add or update metadata (key-value pairs) associated with the aggregate with
its ``<id>`` or ``<name>``. its ``<id>`` or ``<name>``.
nova aggregate-update <id> <name> [<availability_zone>] nova aggregate-update [--name <name>] [--availability-zone <availability-zone>] <aggregate>
Update the name and availability zone (optional) for the aggregate. Update the name and/or availability zone for the aggregate.
nova host-list nova host-list
List all hosts by service. List all hosts by service. It has been depricated since microversion 2.43.
Use :command:`nova hypervisor-list` instead.
nova host-update --maintenance [enable | disable] nova hypervisor-list [--matching <hostname>] [--marker <marker>] [--limit <limit>]
Put/resume host into/from maintenance. List hypervisors.
nova host-update [--status <enable|disable>] [--maintenance <enable|disable>] <hostname>
Put/resume host into/from maintenance. It has been depricated since
microversion 2.43. To enable or disable a service,
use :command:`nova service-enable` or :command:`nova service-disable` instead.
nova service-enable <id>
Enable the service.
nova service-disable [--reason <reason>] <id>
Disable the service.
.. note:: .. note::

45
doc/source/user/aggregates.rst
View File

@ -82,7 +82,7 @@ The OSAPI Admin API is extended to support the following operations:
* Aggregates * Aggregates
* list aggregates: returns a list of all the host-aggregates (optionally filtered by availability zone) * list aggregates: returns a list of all the host-aggregates
* create aggregate: creates an aggregate, takes a friendly name, etc. returns an id * create aggregate: creates an aggregate, takes a friendly name, etc. returns an id
* show aggregate: shows the details of an aggregate (id, name, availability_zone, hosts and metadata) * show aggregate: shows the details of an aggregate (id, name, availability_zone, hosts and metadata)
* update aggregate: updates the name and availability zone of an aggregate * update aggregate: updates the name and availability zone of an aggregate
@ -90,12 +90,27 @@ The OSAPI Admin API is extended to support the following operations:
* delete aggregate: deletes an aggregate, it fails if the aggregate is not empty * delete aggregate: deletes an aggregate, it fails if the aggregate is not empty
* add host: adds a host to the aggregate * add host: adds a host to the aggregate
* remove host: removes a host from the aggregate * remove host: removes a host from the aggregate
* Hosts * Hosts
* list all hosts by service
* It has been depricated since microversion 2.43. Use `list hypervisors` instead.
* start host maintenance (or evacuate-host): disallow a host to serve API requests and migrate instances to other hosts of the aggregate * start host maintenance (or evacuate-host): disallow a host to serve API requests and migrate instances to other hosts of the aggregate
* It has been depricated since microversion 2.43. Use `disable service` instead.
* stop host maintenance: (or rebalance-host): put the host back into operational mode, migrating instances back onto that host * stop host maintenance: (or rebalance-host): put the host back into operational mode, migrating instances back onto that host
* It has been depricated since microversion 2.43. Use `enable service` instead.
* Hypervisors
* list hypervisors: list hypervisors with hypervisor hostname
* Compute services
* enable service
* disable service
Using the Nova CLI Using the Nova CLI
------------------ ------------------
@ -107,13 +122,21 @@ Usage
:: ::
* aggregate-list Print a list of all aggregates. * aggregate-list Print a list of all aggregates.
* aggregate-create <name> <availability_zone> Create a new aggregate with the specified details. * aggregate-create <name> [<availability_zone>] Create a new aggregate with the specified details.
* aggregate-delete <id> Delete the aggregate by its id. * aggregate-delete <aggregate> Delete the aggregate by its ID or name.
* aggregate-details <id> Show details of the specified aggregate. * aggregate-show <aggregate> Show details of the aggregate specified by its ID or name.
* aggregate-add-host <id> <host> Add the host to the specified aggregate. * aggregate-add-host <aggregate> <host> Add the host to the aggregate specified by its ID or name.
* aggregate-remove-host <id> <host> Remove the specified host from the specified aggregate. * aggregate-remove-host <aggregate> <host> Remove the specified host from the aggregate specified by its ID or name.
* aggregate-set-metadata <id> <key=value> [<key=value> ...] Update the metadata associated with the aggregate. * aggregate-set-metadata <aggregate> <key=value> [<key=value> ...]
* aggregate-update <id> <name> [<availability_zone>] Update the aggregate's name and optionally availability zone. Update the metadata associated with the aggregate specified by its ID or name.
* aggregate-update [--name <name>] [--availability-zone <availability-zone>] <aggregate>
Update the aggregate's name or availability zone.
* host-list List all hosts by service * host-list List all hosts by service.
* host-update --maintenance [enable | disable] Put/resume host into/from maintenance. * hypervisor-list [--matching <hostname>] [--marker <marker>] [--limit <limit>]
List hypervisors.
* host-update [--status <enable|disable>] [--maintenance <enable|disable>] <hostname>
Put/resume host into/from maintenance.
* service-enable <id> Enable the service.
* service-disable [--reason <reason>] <id> Disable the service.