[openstack-dev] [nova] Bug in documentation for host aggregates and availability zones?

2015-03-18 Thread Chris Friesen


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()

__
OpenStack Development Mailing List (not for usage questions)
Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Re: [openstack-dev] [nova] Bug in documentation for host aggregates and availability zones?

2015-03-18 Thread Steve Gordon
- Original Message -
 From: Chris Friesen chris.frie...@windriver.com
 To: openstack-dev@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

__
OpenStack Development Mailing List (not for usage questions)
Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Re: [openstack-dev] [nova] Bug in documentation for host aggregates and availability zones?

2015-03-18 Thread Chris Friesen

On 03/18/2015 09:35 AM, Steve Gordon wrote:

- Original Message -

From: Chris Friesen chris.frie...@windriver.com
I think I've found some bugs around host aggregates in the documentation,
curious what people think.



Agree on both counts, can you file a bug against openstack-manuals and I will 
pick it up?


Done.

https://bugs.launchpad.net/openstack-manuals/+bug/1433673

Chris

__
OpenStack Development Mailing List (not for usage questions)
Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev