openstack/openstack-manuals
Code Issues Proposed changes

Merge "Updates to the 'Create and manage volumes' section"

Browse Source
This commit is contained in:
Jenkins 2014-05-07 22:04:14 +00:00 committed by Gerrit Code Review
commit d32e63e8ad
1 changed files with 160 additions and 110 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

164
doc/user-guide/section_dashboard_manage_volumes.xml
View File

@ -3,7 +3,7 @@
xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
xml:id="dashboard_manage_volumes"> xml:id="dashboard_manage_volumes">
<title>Manage volumes</title> <title>Create and manage volumes</title>
<?dbhtml stop-chunking?> <?dbhtml stop-chunking?>
<para>Volumes are block storage devices that you attach to <para>Volumes are block storage devices that you attach to
instances to enable persistent storage. You can attach a instances to enable persistent storage. You can attach a
@ -14,7 +14,6 @@
<section xml:id="dashboard_create_volumes"> <section xml:id="dashboard_create_volumes">
<title>Create a volume</title> <title>Create a volume</title>
<procedure> <procedure>
<!-- <title>To create or delete a volume</title> -->
<step> <step>
<para>Log in to the dashboard, choose a project, and <para>Log in to the dashboard, choose a project, and
click <guibutton>Volumes</guibutton>.</para> click <guibutton>Volumes</guibutton>.</para>
@ -45,8 +44,8 @@
</para> </para>
</td> </td>
<td> <td>
<para>Optionally, provide a brief <para>Optionally, provide a brief description for the
description for the volume.</para> volume.</para>
</td> </td>
</tr> </tr>
<tr> <tr>
@ -77,30 +76,52 @@
</para> </para>
</td> </td>
<td> <td>
<para>Select one of the following <para>Select one of the following options:</para>
options:</para> <variablelist>
<itemizedlist> <varlistentry>
<listitem> <term><guilabel>No source, empty volume</guilabel></term>
<para><guilabel>No source, empty <listitem><para>Creates an empty volume.</para>
volume</guilabel>: creates an empty <note><para>An empty volume does not contain a file
volume.</para><para>Note: An empty volume does not contain a file system or a system or a partition table.</para></note></listitem>
partition table.</para> </varlistentry>
</listitem> <varlistentry>
<listitem> <term><guilabel>Snapshot</guilabel></term>
<para> <listitem><para>If you choose this option, a new field
<guilabel>Image</guilabel>: creates for <guilabel>Use snapshot as a source</guilabel>
a volume from an image. Select the displays. You can select the snapshot from the list.
image from the list.</para> </para></listitem>
</listitem> </varlistentry>
</itemizedlist> <varlistentry>
<term><guilabel>Image</guilabel></term>
<listitem><para>If you choose this option, a new field
for <guilabel>Use image as a source</guilabel>
displays. You can select the image from the list.</para>
<para>Select the <guilabel>Availability Zone</guilabel>
from the list. By default, this value is set to the
availability zone given by the cloud provider
(for example, <literal>us-west</literal> or
<literal>apac-south</literal>). For some cases, it
could be <literal>nova</literal>.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Volume</guilabel></term>
<listitem><para>If you choose this option, a new field
for <guilabel>Use volume as a source</guilabel>
displays. You can select the volume from the list.
</para></listitem>
</varlistentry>
</variablelist>
<note><para>Options to use a snapshot or a volume as the
source for a volume are displayed only if there are
existing snapshots or volumes.</para>
</note>
</td> </td>
</tr> </tr>
</tbody> </tbody>
</informaltable> </informaltable>
</step> </step>
<step> <step>
<para>Click <guibutton>Create <para>Click <guibutton>Create Volume</guibutton>.</para>
Volume</guibutton>.</para>
</step> </step>
</procedure> </procedure>
<para>The dashboard shows the volume on the <para>The dashboard shows the volume on the
@ -108,31 +129,27 @@
</section> </section>
<section xml:id="attach_volumes_to_instances"> <section xml:id="attach_volumes_to_instances">
<title>Attach a volume to an instance</title> <title>Attach a volume to an instance</title>
<para>After you create one or more volumes, you can attach <para>After you create one or more volumes, you can attach them to
them to instances. You can attach a volume to one instance instances. You can attach a volume to one instance at a time.</para>
at a time.</para>
<procedure> <procedure>
<!--<title>To attach volumes to instances</title>-->
<step> <step>
<para>Log in to the dashboard, choose a project, and <para>Log in to the dashboard, choose a project, and click
click <guibutton>Volumes</guibutton>.</para> <guibutton>Volumes</guibutton>.</para>
</step> </step>
<step> <step>
<para>Select the volume to add to an instance and <para>Select the volume to add to an instance and click
click <guibutton>Edit Attachments</guibutton>.</para> <guibutton>Edit Attachments</guibutton>.</para>
</step> </step>
<step> <step>
<para>In the Manage Volume <para>In the <guilabel>Manage Volume Attachments</guilabel> dialog box,
Attachments dialog box, select an select an instance.</para>
instance.</para>
</step> </step>
<step> <step>
<para>Enter the name of the device from which the <para>Enter the name of the device from which the volume is
volume is accessible by the instance.</para> accessible by the instance.</para>
<note> <note>
<para>The actual device name might differ from the <para>The actual device name might differ from the volume name
volume name because of hypervisor because of hypervisor settings.</para>
settings.</para>
</note> </note>
</step> </step>
<step> <step>
@ -141,37 +158,34 @@
volume is now attached and the device name.</para> volume is now attached and the device name.</para>
</step> </step>
</procedure> </procedure>
<para>You can view the status of a volume in the <para>You can view the status of a volume in the <guilabel>Volumes</guilabel>
<guilabel>Volumes</guilabel> tab of the dashboard. The tab of the dashboard. The volume is either Available or In-Use.</para>
volume is either Available or In-Use.</para> <para>Now you can log in to the instance and mount, format, and use the
<para>Now you can log in to the instance and mount, disk.</para>
format, and use the disk.</para>
</section> </section>
<section xml:id="dashboard_detach_volume"> <section xml:id="dashboard_detach_volume">
<title>Detach a volume from an instance</title> <title>Detach a volume from an instance</title>
<procedure> <procedure>
<step> <step>
<para>Log in to the dashboard, choose a project, and <para>Log in to the dashboard, choose a project, and click
click <guibutton>Volumes</guibutton>.</para> <guibutton>Volumes</guibutton>.</para>
</step> </step>
<step> <step>
<para>Select the volume and click <guibutton>Edit <para>Select the volume and click <guibutton>Edit Attachments</guibutton>.</para>
Attachments</guibutton>.</para>
</step> </step>
<step> <step>
<para>Click <guibutton>Detach Volume</guibutton> and <para>Click <guibutton>Detach Volume</guibutton> and confirm your
confirm your changes.</para> changes.</para>
</step> </step>
</procedure> </procedure>
<para>A message indicates whether the action was <para>A message indicates whether the action was successful.</para>
successful.</para>
</section> </section>
<section xml:id="create_volume_snapsnots"> <section xml:id="create_volume_snapsnots">
<title>Create a snapshot from a volume</title> <title>Create a snapshot from a volume</title>
<procedure> <procedure>
<step> <step>
<para>Log in to the dashboard, choose a project, and <para>Log in to the dashboard, choose a project, and click
click <guilabel>Volumes</guilabel>.</para> <guilabel>Volumes</guilabel>.</para>
</step> </step>
<step> <step>
<para>Select a volume from which to create a snapshot.</para> <para>Select a volume from which to create a snapshot.</para>
@ -181,17 +195,53 @@
<guilabel>Create Snapshot</guilabel>.</para> <guilabel>Create Snapshot</guilabel>.</para>
</step> </step>
<step> <step>
<para>In the dialog box that opens, enter a snapshot <para>In the dialog box that opens, enter a snapshot name and a
name and a brief description.</para> brief description.</para>
</step> </step>
<step> <step>
<para>Confirm your changes.</para> <para>Confirm your changes.</para>
<para>The dashboard shows the new volume snapshot in <para>The dashboard shows the new volume snapshot in
<guilabel>Images &amp; <guilabel>Volume Snapshots</guilabel> tab.</para>
Snapshots</guilabel>.</para>
</step> </step>
</procedure> </procedure>
</section> </section>
<section xml:id="dashboard_edit_volume">
<title>Edit a volume</title>
<procedure>
<step>
<para>Log in to the dashboard, choose a project, and click
<guibutton>Volumes</guibutton>.</para>
</step>
<step>
<para>From the <guilabel>CURRENT PROJECT</guilabel> on the
<guilabel>Project</guilabel> tab, select the appropriate
project.</para>
</step>
<step>
<para>On the <guilabel>Project</guilabel> tab, click
<guilabel>Volumes</guilabel>.</para>
</step>
<step>
<para>Select the image that you want to edit.</para>
</step>
<step>
<para>In the <guilabel>Actions</guilabel> column, click
<guilabel>Edit Volume</guilabel>.</para>
</step>
<step>
<para>In the <guilabel>Edit Volume</guilabel> dialog box, update the
name and description of the image.</para>
</step>
<step>
<para>Click <guibutton>Edit Volume</guibutton>.</para>
</step>
</procedure>
<note>
<para>You can extend a volume by using the <guilabel>Extend Volume</guilabel>
option available in the <guibutton>More</guibutton> dropdown list
and entering the new value for volume size.</para>
</note>
</section>
<section xml:id="dashboard_delete_volume"> <section xml:id="dashboard_delete_volume">
<title>Delete a volume</title> <title>Delete a volume</title>
<para>When you delete an instance, the data in its attached <para>When you delete an instance, the data in its attached