openstack-manuals/doc/user-guide-admin/section_dashboard_admin_manage_host_aggregates.xml
Christian Berendt bbec5aa4d2 Unified the syntax of the XML root element (user-guide-admin)
The XML root element of Docbook XML files should match the following
format:

<ELEMENT 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="THE_XML_ID_OF_THE_ELEMENT">

Change-Id: If8d27898af12af2edc2d2d13557ec2365a241656
2014-07-09 21:25:59 +02:00

112 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>