openstack/nova
Code Issues Proposed changes

Merge "Fix "Host Aggregate" section of the Nova Developer Guide."

Browse Source
This commit is contained in:
Jenkins
2015-02-25 14:36:38 +00:00
committed by Gerrit Code Review
parent 6c5d5add86 d2fb9598b9
commit 07d3c0d6d1
1 changed files with 6 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
doc/source/devref/aggregates.rst
View File

@@ -16,19 +16,19 @@
License for the specific language governing permissions and limitations License for the specific language governing permissions and limitations
under the License. under the License.
General Host Aggregates Host Aggregates
======================= ===============
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. 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.
Xen Pool Host Aggregates Xen Pool Host Aggregates
======================== ------------------------
Originally all aggregates were Xen resource pools, now an aggregate can be set up as a resource pool by giving the aggregate the correct key-value pair. Originally all aggregates were Xen resource pools, now an aggregate can be set up as a resource pool by giving the aggregate the correct key-value pair.
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. 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.
Design Design
====== ------
The OSAPI Admin API is extended to support the following operations: The OSAPI Admin API is extended to support the following operations:
@@ -49,12 +49,12 @@ The OSAPI Admin API is extended to support the following operations:
* 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
Using the Nova CLI Using the Nova CLI
================== ------------------
Using the nova command you can create, delete and manage aggregates. The following section outlines the list of available commands. Using the nova command you can create, delete and manage aggregates. The following section outlines the list of available commands.
Usage Usage
----- ~~~~~
:: ::