openstack-manuals/doc/user-guide-admin/section_dashboard_admin_manage_host_aggregates.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
          <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>