openstack/openstack-manuals
Code Issues Proposed changes

Included new section 'Create and manage host aggregates'

Browse Source 
New section to the Admin User guide to 'Create and manage host aggregates'
in the dashboard chapter.
Partial-Bug: #1304821

Change-Id: If2aa8cedaf7a3510123328b11406c9cb60e3fccf
This commit is contained in:
Deepti Navale 2014-04-10 12:11:39 +10:00
parent 14899c0c25
commit 9da6bf5b4d
2 changed files with 163 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
doc/user-guide-admin/ch_dashboard.xml
View File

@ -35,5 +35,7 @@
<?hard-pagebreak?>
<xi:include href="section_dashboard_admin_manage_resources.xml"/>
<?hard-pagebreak?>
<xi:include href="section_dashboard_admin_manage_host_aggregates.xml"/>
<?hard-pagebreak?>
<xi:include href="section_dashboard_admin_manage_stacks.xml"/>
</chapter>

161
doc/user-guide-admin/section_dashboard_admin_manage_host_aggregates.xml Normal file
View File

@ -0,0 +1,161 @@
<?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
<guilabel>CURRENT PROJECT</guilabel> drop-down list.</para>
</step>
<step>
<para>On the <guilabel>Admin</guilabel> tab, 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> window,
enter or select the following values:</para>
<informaltable rules="all" width="85%">
<col width="25%"/>
<col width="75%"/>
<thead>
<tr>
<th colspan="2" align="center">
<guilabel>Host Aggregate Info</guilabel> tab</th>
</tr>
</thead>
<tbody>
<tr>
<td><para><guilabel>Name</guilabel></para>
</td>
<td><para>The host aggregate name.</para>
</td>
</tr>
<tr>
<td><para><guilabel>Availability Zone</guilabel></para>
</td>
<td><para>The cloud provider defines the default
availability zone, such as <literal>us-west</literal>,
<literal>apac-south</literal>, or
<literal>nova</literal>.</para>
<note>
<para>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>
</note>
</td>
</tr>
</tbody>
</informaltable>
<informaltable rules="all" width="85%">
<col width="25%"/>
<col width="75%"/>
<thead>
<tr>
<th colspan="2" align="center">
<guilabel>Host within Aggregate</guilabel> tab</th>
</tr>
</thead>
<tbody>
<tr>
<td><para><guilabel>Selected hosts</guilabel></para>
</td>
<td><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>
<note>
<para>You can add one host to one or more aggregates.
To add a host later, edit the aggregate.</para>
</note>
</td>
</tr>
</tbody>
</informaltable>
</step>
</procedure>
<procedure>
<title>To manage host and aggregates</title>
<step>
<para>Log in to the dashboard.</para>
<para>Choose the <guilabel>admin</guilabel> project from the
<guilabel>CURRENT PROJECT</guilabel> drop-down list.</para>
</step>
<step>
<para>On the <guilabel>Admin</guilabel> tab, click the
<guilabel> Host Aggregates</guilabel> category.</para>
</step>
<step>
<para>To edit host aggregates:</para>
<substeps>
<step>
<para>Select the host aggregate that you want to edit. Click
<guibutton>Edit Host Aggregate</guibutton>.</para>
</step>
<step>
<para>In the <guilabel>Edit Host Aggregate</guilabel>
window, you can change the name and availability zone for
the aggregate.</para>
</step>
</substeps>
</step>
<step>
<para>To manage hosts:</para>
<substeps>
<step>
<para>Select the host aggregate that you want to edit. Click
<guibutton>More</guibutton>.</para>
</step>
<step>
<para>In the <guilabel>Add/Remove Hosts to
Aggregate</guilabel> window, click
<guilabel>+</guilabel> to assign a host to the
aggregate.</para>
<para>Click <guilabel>-</guilabel> to remove a host that is
assigned to an aggregate.</para>
</step>
</substeps>
</step>
<step>
<para>To delete host aggregates:</para>
<substeps>
<step>
<para>Select the host aggregate that you want to edit. Click
<guibutton>More</guibutton>.</para>
</step>
<step>
<para>Click the <guilabel>Delete Host Aggregate</guilabel>
option.</para>
</step>
</substeps>
</step>
</procedure>
</section>