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
This commit is contained in:
Karin Levenstein 2014-06-10 15:12:38 -05:00
parent 7094d084cc
commit 3311c7127f
6 changed files with 161 additions and 298 deletions

View File

@ -5,102 +5,10 @@
xml:id="dashboard_manage_flavors">
<?dbhtml stop-chunking?>
<title>Manage flavors</title>
<para>In OpenStack, a flavor defines the compute, memory, and
storage capacity of a virtual server that users can launch. As
an administrative user, you can create, edit, and delete
flavors.</para>
<para>Only administrative users can create and manage
flavors.</para>
<para>A flavor consists of the following parameters:</para>
<table rules="all" width="50%">
<caption>Flavor parameters</caption>
<col width="20%"/>
<col width="80%"/>
<thead>
<tr>
<th>Parameter</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>
<para>Flavor Name</para>
</td>
<td>
<para>The flavor name.</para>
</td>
</tr>
<tr>
<td>
<para>VCPUs</para>
</td>
<td>
<para>Number of virtual CPUs to use.</para>
</td>
</tr>
<tr>
<td>
<para>RAM</para>
</td>
<td>
<para>Amount of RAM to use, in megabytes.</para>
</td>
</tr>
<tr>
<td>
<para>Root Disk</para>
</td>
<td>
<para>Amount of disk space (in gigabytes) to use
for the root (/) partition.</para>
</td>
</tr>
<tr>
<td>
<para>Ephemeral Disk</para>
</td>
<td>
<para>Amount of disk space (in gigabytes) to use
for the ephemeral partition. If unspecified,
the value is 0 by default.</para>
<para>Ephemeral disks offer machine local disk
storage linked to the life cycle of a VM
instance. When a VM is terminated, all data on
the ephemeral disk is lost. Ephemeral disks
are not included in any snapshots.</para>
</td>
</tr>
<tr>
<td>
<para>Swap Disk</para>
</td>
<td>
<para>Amount of swap space (in megabytes) to use.
If unspecified, the default is 0.</para>
</td>
</tr>
<tr>
<td>
<para>ID</para>
</td>
<td>
<para>The flavor ID is generated by OpenStack if the option
selected is <guilabel>auto</guilabel>.</para>
<para>By default, this field is set to <guilabel>auto</guilabel>.</para>
</td>
</tr>
<tr>
<td>
<para>Public</para>
</td>
<td>
<para>Indicates if the flavor is public.</para>
</td>
</tr>
</tbody>
</table>
<para>The default flavors are:</para>
<para>In OpenStack, a flavor defines the compute, memory, and storage
capacity of a virtual server, also known as an instance. As an
administrative user, you can create, edit, and delete flavors..</para>
<para>The following table lists the default flavors.</para>
<informaltable rules="all" width="50%">
<col width="30%"/>
<col width="20%"/>
@ -193,12 +101,12 @@
<procedure>
<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>
<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, click the
<para>On the <guilabel>Admin</guilabel> tab, open the
<guilabel>System Panel</guilabel> and click the
<guilabel>Flavors</guilabel> category.</para>
</step>
<step>
@ -207,8 +115,7 @@
</step>
<step>
<para>In the <guilabel>Create Flavor</guilabel>
window, enter or select the following
values:</para>
window, enter or select the parameters for the flavor.</para>
<informaltable rules="all" width="75%">
<col width="25%"/>
<col width="75%"/>
@ -234,7 +141,7 @@
</para>
</td>
<td>
<para>The flavor ID, generated by OpenStack.</para>
<para>OpenStack generates the flavor ID.</para>
</td>
</tr>
<tr>
@ -318,12 +225,12 @@
<procedure>
<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>
<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, click the
<para>On the <guilabel>Admin</guilabel> tab, open the
<guilabel>System Panel</guilabel> and click the
<guilabel>Flavors</guilabel> category.</para>
</step>
<step>
@ -346,12 +253,12 @@
<procedure>
<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>
<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, click the
<para>On the <guilabel>Admin</guilabel> tab, open the
<guilabel>System Panel</guilabel> and click the
<guilabel>Flavors</guilabel> category.</para>
</step>
<step>

View File

@ -11,151 +11,100 @@
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>
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>
drop-down list at the top of the page.</para>
</step>
<step>
<para>On the <guilabel>Admin</guilabel> tab, click the
<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> 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>
<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>Log in to the dashboard.</para>
<para>Choose the <guilabel>admin</guilabel> project from the
<guilabel>CURRENT PROJECT</guilabel> drop-down list.</para>
drop-down list at the top of the page.</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
<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>
<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>
</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>

View File

@ -26,11 +26,11 @@
<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>
drop-down list at the top of the page.</para>
</step>
<step>
<para>On the <guilabel>Admin</guilabel> tab, click the
<para>On the <guilabel>Admin</guilabel> tab, open the
<guilabel>System Panel</guilabel> and click the
<guilabel>Images</guilabel> category. The images that you
can administer for cloud users appear on this page.</para>
</step>
@ -92,8 +92,10 @@
</step>
<step>
<para>Click <guibutton>Create Image</guibutton>.</para>
<para>The image is queued to be uploaded. It might take some
time before the status changes from queued to active.</para>
<para>The image is queued to be uploaded. It might take
several minutes before the status changes from
<literal>Queued</literal> to
<literal>Active</literal>.</para>
</step>
</procedure>
</section>
@ -103,11 +105,11 @@
<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>
drop-down list at the top of the page.</para>
</step>
<step>
<para>On the <guilabel>Admin</guilabel> tab, click the
<para>On the <guilabel>Admin</guilabel> tab, open the
<guilabel>System Panel</guilabel> and click the
<guilabel>Images</guilabel> category.</para>
</step>
<step>
@ -116,11 +118,11 @@
</step>
<step>
<para>In the <guilabel>Update Image</guilabel> window, you can
change the name for the image. Select the
<guilabel>Public</guilabel> check box to make the image
public. Clear this check box to make the image private. You
cannot change the kernel ID, RAM disk ID, or architecture
attributes for an image.</para>
change the image name.</para>
<para>Select the <guilabel>Public</guilabel> check box to make
the image public. Clear this check box to make the image
private. You cannot change the kernel ID, RAM disk ID, or
architecture attributes for an image.</para>
</step>
<step>
<para>Click <guibutton>Update Image</guibutton>.</para>
@ -133,11 +135,11 @@
<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>
drop-down list at the top of the page.</para>
</step>
<step>
<para>On the <guilabel>Admin</guilabel> tab, click the
<para>On the <guilabel>Admin</guilabel> tab, open the
<guilabel>System Panel</guilabel> and click the
<guilabel>Images</guilabel> category.</para>
</step>
<step>

View File

@ -25,8 +25,7 @@
<step>
<para>Log in to the dashboard and choose the
<guilabel>admin</guilabel> project from the
<guilabel>CURRENT PROJECT</guilabel> drop-down
list.</para>
drop-down list at the top of the page.</para>
</step>
<step>
<para>On the <guilabel>Admin</guilabel> tab, click the
@ -64,8 +63,7 @@
<step>
<para>Log in to the dashboard and choose the
<guilabel>admin</guilabel> project from the
<guilabel>CURRENT PROJECT</guilabel> drop-down
list.</para>
drop-down list at the top of the page.</para>
</step>
<step>
<para>On the <guilabel>Admin</guilabel> tab, click the

View File

@ -9,38 +9,47 @@
<procedure>
<step>
<para>Log in to the OpenStack dashboard and choose the
<guilabel>admin</guilabel> project from the
<guilabel>CURRENT PROJECT</guilabel> drop-down list.</para>
<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, click the
<guilabel>System Info</guilabel> category.</para>
</step>
<step>
<para>Click the:<itemizedlist>
<listitem>
<para><guilabel>Services</guilabel> tab to view services information.</para>
<para>The page displays the internal name and the public OpenStack name for the service,
the host where the service runs, and whether the service is or is not enabled.</para>
</listitem>
<listitem>
<para><guilabel>Compute Services</guilabel> tab to view services specific to the Compute
Service. Both host and zone are listed for each service, as well as its activation
status.</para>
</listitem>
</itemizedlist></para>
<para>View the following information on these tabs:<itemizedlist>
<listitem>
<para><guilabel>Services</guilabel>: Displays the internal
name and the public OpenStack name for each service, the
host on which the service runs, and whether or not the
service is enabled.</para>
</listitem>
<listitem>
<para><guilabel>Compute Services</guilabel>: Displays
information specific to the Compute Service. Both host
and zone are listed for each service, as well as its
activation status.</para>
</listitem>
<listitem>
<para><guilabel>Network Agents</guilabel>: Displays the
network agents active within the cluster, such as L3 and
DHCP agents, and the status of each agent.</para>
</listitem>
<listitem>
<para><guilabel>Default Quotas</guilabel>: Displays the
quotas that have been configured for the cluster.</para>
</listitem>
<listitem>
<para><guilabel>Availability Zones</guilabel>: Displays
the availability zones that have been configured for the
cluster. It is only available when multiple availability
zones have been defined.</para>
</listitem>
<listitem>
<para><guilabel>Host Aggregates</guilabel>: Displays the
host aggregates that have been defined for the cluster.
It is only available when multiple host aggregates have
been defined.</para>
</listitem>
</itemizedlist></para>
</step>
</procedure>
<note><para>The <guilabel>System Info</guilabel> window also offers status information for the following: <itemizedlist>
<listitem>
<para><guilabel>Availability Zones</guilabel></para>
</listitem>
<listitem>
<para><guilabel>Host Aggregates</guilabel></para>
</listitem>
<listitem>
<para><guilabel>Network Agents</guilabel></para>
</listitem>
</itemizedlist>
</para></note>
</section>

View File

@ -23,12 +23,12 @@
<step>
<para>Log in to the dashboard and choose the
<guilabel>admin</guilabel> project from the
<guilabel>CURRENT PROJECT</guilabel> drop-down
list.</para>
drop-down list at the top of the page.</para>
</step>
<step>
<para>On the <guilabel>Admin</guilabel> tab, click the
<guilabel>Volumes</guilabel> category.</para>
<para>On the <guilabel>Admin</guilabel> tab, open the
<guibutton>System Panel</guibutton> and click
the <guilabel>Volumes</guilabel> category.</para>
</step>
<step>
<para>Click <guibutton>Create Volume
@ -39,6 +39,8 @@
<step>
<para>Click <guibutton>Create Volume Type</guibutton>
to confirm your changes.</para>
<para>A message indicates whether the action
succeeded.</para>
</step>
</procedure>
</section>
@ -50,12 +52,12 @@
<step>
<para>Log in to the dashboard and choose the
<guilabel>admin</guilabel> project from the
<guilabel>CURRENT PROJECT</guilabel> drop-down
list.</para>
drop-down list at the top of the page.</para>
</step>
<step>
<para>On the <guilabel>Admin</guilabel> tab, click the
<guilabel>Volumes</guilabel> category.</para>
<para>On the <guilabel>Admin</guilabel> tab, open the
<guibutton>System Panel</guibutton> and click
the <guilabel>Volumes</guilabel> category.</para>
</step>
<step>
<para>Select the volume type or types that you want to
@ -70,8 +72,6 @@
Types</guilabel> window, click
<guibutton>Delete Volume Types</guibutton> to
confirm the action.</para>
</step>
<step>
<para>A message indicates whether the action
succeeded.</para>
</step>
@ -85,12 +85,12 @@
<step>
<para>Log in to the dashboard and choose the
<guilabel>admin</guilabel> project from the
<guilabel>CURRENT PROJECT</guilabel> drop-down
list.</para>
drop-down list at the top of the page.</para>
</step>
<step>
<para>On the <guilabel>Admin</guilabel> tab, click the
<guilabel>Volumes</guilabel> category.</para>
<para>On the <guilabel>Admin</guilabel> tab, open the
<guibutton>System Panel</guibutton> and click
the <guilabel>Volumes</guilabel> category.</para>
</step>
<step>
<para>Select the volume or volumes that you want to
@ -105,8 +105,6 @@
Volumes</guilabel> window, click
<guibutton>Delete Volumes</guibutton> to
confirm the action.</para>
</step>
<step>
<para>A message indicates whether the action
succeeded.</para>
</step>