[openstack-dev] [nova] Bug in documentation for host aggregates and availability zones?
Steve Gordon
sgordon at redhat.com
Wed Mar 18 15:35:56 UTC 2015
----- Original Message -----
> From: "Chris Friesen" <chris.friesen at windriver.com>
> To: openstack-dev at lists.openstack.org
>
> Hi,
>
> I think I've found some bugs around host aggregates in the documentation,
> curious what people think.
>
> The docs at
> "http://docs.openstack.org/trunk/config-reference/content/section_compute-scheduler.html#host-aggregates"
> contain this:
>
>
> nova aggregate-create <name> <availability-zone>
>
> Create a new aggregate named <name> in availability zone
> <availability-zone>. Returns the ID of the newly created aggregate. Hosts can
> be
> made available to multiple availability zones, but administrators should be
> careful when adding the host to a different host aggregate within the same
> availability zone and pay attention when using the aggregate-set-metadata and
> aggregate-update commands to avoid user confusion when they boot instances in
> different availability zones. An error occurs if you cannot add a particular
> host to an aggregate zone for which it is not intended.
>
>
>
> I'm pretty sure that there are multiple errors in there:
>
> 1) This command creates a new aggregate that is *exposed as* an availability
> zone. It doesn't create a new aggregate within an availability zone. [1]
> Because of that the idea of a "different host aggregate within the same
> availability zone" doesn't make any sense.
>
> 2) Hosts can be part of multiple host aggregates, they cannot be part of
> multiple availability zones. [2]
>
>
> Chris
>
>
>
>
> References:
> [1]
> http://blog.russellbryant.net/2013/05/21/availability-zones-and-host-aggregates-in-openstack-compute-nova/
>
> [2] See the check in nova.compute.api.AggregateAPI._check_az_for_host()
Agree on both counts, can you file a bug against openstack-manuals and I will pick it up?
Thanks,
Steve
More information about the OpenStack-dev
mailing list