From 7ec8f661dd3908836516508fd51fd5f281f9c16b Mon Sep 17 00:00:00 2001 From: annegentle Date: Mon, 30 Apr 2012 12:45:10 -0500 Subject: [PATCH] Removes RST documentation and moves it to openstack-manuals Avoiding redundant information and confusion. Change-Id: Iab1913ff359699db977b74554bad6088fab6ab2f --- doc/source/api_ext/ext_aggregates.rst | 123 -------------------------- doc/source/index.rst | 32 ++----- 2 files changed, 6 insertions(+), 149 deletions(-) delete mode 100644 doc/source/api_ext/ext_aggregates.rst diff --git a/doc/source/api_ext/ext_aggregates.rst b/doc/source/api_ext/ext_aggregates.rst deleted file mode 100644 index fd3ed47fc..000000000 --- a/doc/source/api_ext/ext_aggregates.rst +++ /dev/null @@ -1,123 +0,0 @@ -The Host Aggregates Extension -================================================================= -About this Extension --------------------- -This extension introduces the concept of aggregates 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). - -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. - -To find more about it, please read http://wiki.openstack.org/host-aggregates or quick-search for 'aggregates' on the Nova developer guide. - -Pre-requisites depend on the kind of hypervisor support you are going to use. As for XenServer/XCP, the same requirements for resource pools apply. - -To obtain current information the extensions available to you, issue an EXTENSION query on the OpenStack system where it is installed, such as http://example.com/v1.1/tenant/extensions. - -Extension Overview -~~~~~~~~~~~~~~~~~~ - -Name - Host Aggregates - -Namespace - http://docs.openstack.org/compute/ext/aggregates/api/v1.1 - -Alias - OS-AGGREGATES - -Contact - Armando Migliaccio - -Status - Released - -Extension Version - v1.0 (2012-02-28) - -Dependencies - Compute API 1.1 - -Doc Link (PDF) - http:// - -Doc Link (WADL) - http:// - -Short Description - This extension enables the use of hypervisor resource pools in Nova. - -Sample Query Responses -~~~~~~~~~~~~~~~~~~~~~~ - -As shown below, responses to an EXTENSION query in XML or JSON provide basic information about the extension. - -Extension Query Response: XML:: - - Admin-only aggregate administration - -Extension Query Response: JSON:: - - {"extension": {"updated": "2012-01-12T00:00:00+00:00", "name": "Aggregates", "links": [], "namespace": "http://docs.openstack.org/compute/ext/aggregates/api/v1.1", "alias": "os-aggregates", "description": "Admin-only aggregate administration"}} - -Document Change History -~~~~~~~~~~~~~~~~~~~~~~~ - -============= ===================================== -Revision Date Summary of Changes -2012-02-28 Initial draft -2012-03-30 Reformat of content -============= ===================================== - - -Summary of Changes ------------------- -This extension to the OpenStack Compute API allows the creation and management of host aggregates (i.e. pools of compute nodes). - -This support is provided by the addition of new actions. - -New Actions -~~~~~~~~~~~ -When a new aggregate has been created, actions can be executed using: - - POST /v1.1//os-aggregates//action - -Valid actions are: - -set_metadata -add_host -remove_host - -Normal response Code: 200 - -For example, to set metadata for an aggregate the following xml must be submitted: - -{"set_metadata": {"metadata": {"foo_key": "foo_value"}}} - -For example, to add a host to an aggregate, the following xml must be submitted: - -{"add_host": {"host": ""}} - -For example, to remove a host from an aggregate, the following xml must be submitted: - -{"remove_host": {"host": ""}} - -Error Response Code(s) conflict (409), badRequest (400), itemNotFound (404) - -New Faults -~~~~~~~~~~ -None - -New Headers -~~~~~~~~~~~ -None - -New Resources -~~~~~~~~~~~~~ -None - -New States -~~~~~~~~~~ -None - -Changes to the Cloud Servers Specification -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -None diff --git a/doc/source/index.rst b/doc/source/index.rst index faaf1338e..c8befb415 100644 --- a/doc/source/index.rst +++ b/doc/source/index.rst @@ -1,5 +1,5 @@ .. - Copyright 2010-2011 United States Government as represented by the + Copyright 2010-2012 United States Government as represented by the Administrator of the National Aeronautics and Space Administration. All Rights Reserved. @@ -15,10 +15,11 @@ License for the specific language governing permissions and limitations under the License. -Welcome to Nova's documentation! -================================ +Welcome to Nova's developer documentation! +========================================== -Nova is a cloud computing fabric controller, the main part of an IaaS system. +Nova is the project name for OpenStack Compute, a cloud computing fabric +controller, the main part of an IaaS system. Individuals and organizations can use Nova to host and manage their own cloud computing systems. Nova originated as a project out of NASA Ames Research Laboratory. @@ -35,43 +36,22 @@ This documentation is generated by the Sphinx toolkit and lives in the source tree. Additional draft and project documentation on Nova and other components of OpenStack can be found on the `OpenStack wiki`_. Cloud administrators, refer to `docs.openstack.org`_. -Also see the :doc:`community` page for other ways to interact with the community. - .. _`OpenStack wiki`: http://wiki.openstack.org .. _`docs.openstack.org`: http://docs.openstack.org -Key Concepts -============ -.. toctree:: - :maxdepth: 1 - - cloud101 - nova.concepts - service.architecture - object.model - runnova/index - -.. swift.concepts -.. swift.object.model - Developer Docs ============== .. toctree:: :maxdepth: 1 - quickstart devref/index - community API Extensions ============== -.. toctree:: - :maxdepth: 1 - - api_ext/index +Go to http://api.openstack.org for information about Compute API extensions. Outstanding Documentation Tasks ===============================