openstack-manuals/doc/user-guide-admin/section_dashboard_admin_manage_host_aggregates.xml
Karin Levenstein 3311c7127f Admin guide updates
More changes to match the Admin Guide with the Icehouse GUI.
Also cleaning up some wording and other editing stuff.
Relatively small changes to smallish files, for the most part.

...and some niceness fixes that I thought I'd gotten earlier.

Added Diane's fixes

Change-Id: I867cb38629803be1993a318e933416e2bca3e87c
2014-06-17 14:09:39 -05:00

111 lines
4.7 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<section xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
xml:id="dashboard_manage_host_aggregates">
<?dbhtml stop-chunking?>
<title>Create and manage host aggregates</title>
<para>Host aggregates enable administrative users to assign
key-value pairs to groups of machines.</para>
<para>Each node can have multiple aggregates and each aggregate can
have multiple key-value pairs. You can assign the same key-value
pair to multiple aggregates.</para>
<para>The scheduler uses this information to make scheduling
decisions. For information, see <link xlink:href="http://docs.openstack.org/trunk/config-reference/content/section_compute-scheduler.html"><citetitle>Scheduling</citetitle></link>.</para>
<procedure>
<title>To create a host aggregate</title>
<step>
<para>Log in to the dashboard.</para>
<para>Choose the <guilabel>admin</guilabel> project from the
drop-down list at the top of the page.</para>
</step>
<step>
<para>On the <guilabel>Admin</guilabel> tab, open the
<guilabel>System Panel</guilabel> and click the
<guilabel>Host Aggregates</guilabel> category.</para>
</step>
<step>
<para>Click <guibutton>Create Host Aggregate</guibutton>.</para>
</step>
<step>
<para>In the <guilabel>Create Host Aggregate</guilabel> dialog
box, enter or select the following values on the
<guilabel>Host Aggregate Info</guilabel> tab:</para>
<itemizedlist>
<listitem>
<para><guilabel>Name</guilabel>: The host aggregate
name.</para>
</listitem>
<listitem>
<para><guilabel>Availability Zone</guilabel>: The cloud
provider defines the default availability zone, such as
<literal>us-west</literal>,
<literal>apac-south</literal>, or
<literal>nova</literal>. You can target the host
aggregate, as follows:</para>
<itemizedlist>
<listitem>
<para>When the host aggregate is exposed as an
availability zone, select the availability zone when
you launch an instance.</para>
</listitem>
<listitem>
<para>When the host aggregate is not exposed as an
availability zone, select a flavor and its extra specs
to target the host aggregate.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</step>
<step>
<para>Assign hosts to the aggregate on the <guilabel>Host within
Aggregate</guilabel> tab.</para>
<para>To assign a host to the aggregate, click
<guilabel>+</guilabel> for the host. The host moves from the
<guilabel>All available hosts</guilabel> list to the
<guilabel>Selected hosts</guilabel> list.</para>
</step>
</procedure>
<para>You can add one host to one or more aggregates. To add a host
to an existing aggregate, edit the aggregate.</para>
<procedure>
<title>To manage host and aggregates</title>
<step>
<para>Choose the <guilabel>admin</guilabel> project from the
drop-down list at the top of the page.</para>
</step>
<step>
<para>On the <guilabel>Admin</guilabel> tab, open the
<guilabel>System Panel</guilabel> and click the <guilabel>
Host Aggregates</guilabel> category.</para>
<itemizedlist>
<listitem>
<para>To edit host aggregates, select the host aggregate that
you want to edit. Click <guibutton>Edit Host
Aggregate</guibutton>.</para>
<para>In the <guilabel>Edit Host Aggregate</guilabel> dialog
box, you can change the name and availability zone for the
aggregate.</para>
</listitem>
<listitem>
<para>To manage hosts, locate the host aggregate that you want
to edit in the table. Click <guibutton>More</guibutton>
and select <guilabel>Manage Hosts</guilabel>.</para>
<para>In the <guilabel>Add/Remove Hosts to
Aggregate</guilabel> dialog box, click
<guilabel>+</guilabel> to assign a host to the
aggregate. Click <guilabel>-</guilabel> to remove a host
that is assigned to an aggregate.</para>
</listitem>
<listitem>
<para>To delete host aggregates, locate the host aggregate that
you want to edit in the table. Click
<guibutton>More</guibutton> and select <guilabel>Delete
Host Aggregate</guilabel>.</para>
</listitem>
</itemizedlist>
</step>
</procedure>
</section>