~ubuntu-branches/ubuntu/quantal/nova/quantal-proposed

« back to all changes in this revision

Viewing changes to doc/source/devref/aggregates.rst

  • Committer: Package Import Robot
  • Author(s): Chuck Short
  • Date: 2012-08-16 14:04:11 UTC
  • mto: This revision was merged to the branch mainline in revision 84.
  • Revision ID: package-import@ubuntu.com-20120816140411-0mr4n241wmk30t9l
Tags: upstream-2012.2~f3
ImportĀ upstreamĀ versionĀ 2012.2~f3

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
..
2
2
      Copyright 2012 OpenStack, LLC
3
3
      Copyright 2012 Citrix Systems, Inc.
 
4
      Copyright 2012, The Cloudscaling Group, Inc.
4
5
      All Rights Reserved.
5
6
 
6
7
      Licensed under the Apache License, Version 2.0 (the "License"); you may
15
16
      License for the specific language governing permissions and limitations
16
17
      under the License.
17
18
 
18
 
Host Aggregates
19
 
===============
20
 
 
21
 
This extension introduces the concept of aggregate into Nova. Host aggregates are different from zones and availability zones: while the former allows the partition of Nova deployments into logical groups for load balancing and instance distribution, the latter are for providing some form of physical isolation and redundancy from other availability zones (e.g. by using separate power supply and network gears). Availability zones do not necessarily mean geographic distribution whereas zones usually do. Host aggregates can be regarded as a mechanism to further partitioning an availability zone, i.e. into multiple groups of hosts that share common resources like storage and network. This enables a finer level of granularity in which to structure an entire OpenStack deployment. Aggregates allows higher availability of a single guest instance within an availability zone, it enables advanced VM placement strategies, and more importantly it enables hosts' zero-downtime upgrades (for example, via VM live migration across members of the aggregate, thus causing no disruption to guest instances).
22
 
 
23
 
You can use this extension when you have multiple Compute nodes installed (only XenServer/XCP via xenapi driver is currently supported), and you want to leverage the capabilities of the underlying hypervisor resource pools. For example, you want to enable VM live migration (i.e. VM migration within the pool) or enable host maintenance with zero-downtime for guest instances. Please, note that VM migration across pools (i.e. storage migration) is not yet supported in XenServer/XCP, but will be added when available. Bear in mind that the two migration techniques are not mutually exclusive and can be used in combination for a higher level of flexibility in your cloud management.
 
19
General Host Aggregates
 
20
===============
 
21
 
 
22
Host aggregates can be regarded as a mechanism to further partition an availability zone; while availability zones are visible to users, host aggregates are only visible to administrators.  Host aggregates started out as a way to use Xen hypervisor resource pools, but has been generalized to provide a mechanism to allow administrators to assign key-value pairs to groups of machines.  Each node can have multiple aggregates, each aggregate can have multiple key-value pairs, and the same key-value pair can be assigned to multiple aggregate.  This information can be used in the scheduler to enable advanced scheduling, to set up xen hypervisor resources pools or to define logical groups for migration.
 
23
 
 
24
Xen Pool Host Aggregates
 
25
===============
 
26
Originally all aggregates were Xen resource pools, now a aggregate can be set up as a resource pool by giving the aggregate the correct key-value pair.
 
27
 
 
28
You can use aggregates for XenServer resource pools when you have multiple compute nodes installed (only XenServer/XCP via xenapi driver is currently supported), and you want to leverage the capabilities of the underlying hypervisor resource pools. For example, you want to enable VM live migration (i.e. VM migration within the pool) or enable host maintenance with zero-downtime for guest instances. Please, note that VM migration across pools (i.e. storage migration) is not yet supported in XenServer/XCP, but will be added when available. Bear in mind that the two migration techniques are not mutually exclusive and can be used in combination for a higher level of flexibility in your cloud management.
24
29
 
25
30
Design
26
31
=======
27
32
 
28
 
The OSAPI Admin API will be extended to support the following operations:
 
33
The OSAPI Admin API is extended to support the following operations:
29
34
 
30
35
    * Aggregates
31
36
 
36
41
      * set metadata: sets the metadata on an aggregate to the values supplied
37
42
      * delete aggregate: deletes an aggregate, it fails if the aggregate is not empty
38
43
      * add host: adds a host to the aggregate
39
 
      * remove host: removes a host from the aggregate, it fails if the host is not disabled or
 
44
      * remove host: removes a host from the aggregate
40
45
 
41
46
    * Hosts
42
47
 
62
67
  * aggregate-set-metadata   <id> <key=value> [<key=value> ...]       Update the metadata associated with the aggregate.
63
68
  * aggregate-update         <id> <name> [<availability_zone>]        Update the aggregate's name and optionally availablity zone.
64
69
 
 
70
  * host-list                                                         List all hosts by service
65
71
  * host-update              --maintenance [enable | disable]         Put/resume host into/from maintenance.