2fc55d1f80
Updated the procedure in the 'Manage volumes' section of the dashboard chapter of the End User guide. Partial-Bug: #1279133 Change-Id: Ifaf279bbc965fdd8bff6d2a55ffe824fdc6e2d0f
237 lines
9.4 KiB
XML
237 lines
9.4 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE section [
|
|
<!-- Some useful entities borrowed from HTML -->
|
|
<!ENTITY ndash "–">
|
|
<!ENTITY mdash "—">
|
|
<!ENTITY hellip "…">
|
|
<!ENTITY plusmn "±">
|
|
]>
|
|
<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_volumes">
|
|
<title>Manage volumes</title>
|
|
<?dbhtml stop-chunking?>
|
|
<para>Volumes are block storage devices that you attach to
|
|
instances to enable persistent storage. You can attach a
|
|
volume to a running instance or detach a volume and attach it
|
|
to another instance at any time. You can also create a
|
|
snapshot from or delete a volume. Only administrative users
|
|
can create volume types.</para>
|
|
<section xml:id="dashboard_create_volumes">
|
|
<title>Create a volume</title>
|
|
<procedure>
|
|
<!-- <title>To create or delete a volume</title> -->
|
|
<step>
|
|
<para>Log in to the dashboard, choose a project, and
|
|
click the <guibutton>Volumes</guibutton>
|
|
category.</para>
|
|
</step>
|
|
<step>
|
|
<para>Click <guibutton>Create Volume</guibutton>.</para>
|
|
<para>In the window that opens, enter or select the following values.</para>
|
|
<informaltable rules="all" width="75%">
|
|
<col width="30%"/>
|
|
<col width="70%"/>
|
|
<tbody>
|
|
<tr>
|
|
<td>
|
|
<para>
|
|
<guilabel>Volume Name</guilabel>
|
|
</para>
|
|
</td>
|
|
<td>
|
|
<para>A name to identify the volume.</para>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<para>
|
|
<guilabel>Description</guilabel>
|
|
</para>
|
|
</td>
|
|
<td>
|
|
<para>A brief description for the volume.</para>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<para>
|
|
<guilabel>Type</guilabel>
|
|
</para>
|
|
</td>
|
|
<td>
|
|
<para>Leave this field blank.</para>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<para>
|
|
<guilabel>Size (GB)</guilabel>
|
|
</para>
|
|
</td>
|
|
<td>
|
|
<para>The size of the volume in GB.</para>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<para>
|
|
<guilabel>Volume Source</guilabel>
|
|
</para>
|
|
</td>
|
|
<td>
|
|
<para>Options are:</para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para><guilabel>No source, empty volume</guilabel>
|
|
- Choose this option to create an empty volume.</para>
|
|
<note>
|
|
<para>An empty volume does not contain either a file
|
|
system or a partition table.</para>
|
|
</note>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
<guilabel>Image</guilabel> - Choose this option
|
|
to create a volume from an image. Select the image
|
|
from the dropdown list.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</informaltable>
|
|
</step>
|
|
<step>
|
|
<para>Click the <guibutton>Create Volume</guibutton> button to
|
|
confirm your changes.</para>
|
|
</step>
|
|
<step>
|
|
<para>The dashboard shows the volume in the <guilabel>Volumes</guilabel>
|
|
category.</para>
|
|
</step>
|
|
</procedure>
|
|
</section>
|
|
<section xml:id="attach_volumes_to_instances">
|
|
<title>Attach volumes to instances</title>
|
|
<para>After you create one or more volumes, you can attach
|
|
them to instances.</para>
|
|
<procedure>
|
|
<!--<title>To attach volumes to instances</title>-->
|
|
<step>
|
|
<para>Log in to the dashboard, choose a project, and
|
|
click the <guibutton>Volumes</guibutton>
|
|
category.</para>
|
|
</step>
|
|
<step>
|
|
<para>Select the volume to add to an instance and
|
|
click <guibutton>Edit Attachments</guibutton>.</para>
|
|
</step>
|
|
<step>
|
|
<para>In the <guilabel>Manage Volume
|
|
Attachments</guilabel> window, select an
|
|
instance.</para>
|
|
</step>
|
|
<step>
|
|
<para>Enter the name of the device from where the
|
|
volume should be accessible on the virtual
|
|
machine.</para>
|
|
<note>
|
|
<para>The actual device name might differ due to
|
|
hypervisor settings.</para>
|
|
</note>
|
|
</step>
|
|
<step>
|
|
<para>Click <guibutton>Attach Volume</guibutton> to
|
|
confirm your changes. The dashboard shows the
|
|
instance to which the volume is now attached and
|
|
the device name. You can attach a volume to one
|
|
instance at a time.</para>
|
|
</step>
|
|
<step>
|
|
<para>View the status of a volume in the
|
|
<guilabel>Volumes</guilabel> category of the dashboard.
|
|
The volume is either available or In-Use.</para>
|
|
</step>
|
|
<step>
|
|
<para>Now you can log in to the instance and mount,
|
|
format, and use the disk.</para>
|
|
</step>
|
|
</procedure>
|
|
</section>
|
|
<section xml:id="dashboard_detach_volume">
|
|
<title>Detach a volume from an instance</title>
|
|
<procedure>
|
|
<step>
|
|
<para>Log in to the dashboard, choose a project, and
|
|
click the <guibutton>Volumes</guibutton>
|
|
category.</para>
|
|
</step>
|
|
<step>
|
|
<para>Select the volume and click <guibutton>Edit
|
|
Attachments</guibutton>.</para>
|
|
</step>
|
|
<step>
|
|
<para>Click <guibutton>Detach Volume</guibutton> and
|
|
confirm your changes.</para>
|
|
</step>
|
|
<step>
|
|
<para>A message indicates whether the action was
|
|
successful.</para>
|
|
</step>
|
|
</procedure>
|
|
</section>
|
|
<section xml:id="create_volume_snapsnots">
|
|
<title>Create volume snapshots</title>
|
|
<procedure>
|
|
<step>
|
|
<para>Log in to the dashboard, choose a project, and
|
|
click the <guilabel>Volumes</guilabel> category.</para>
|
|
</step>
|
|
<step>
|
|
<para>Select a volume from which to create a snapshot.</para>
|
|
</step>
|
|
<step>
|
|
<para>From the <guilabel>More</guilabel> drop-down
|
|
list, select <guilabel>Create Snapshot</guilabel>.</para>
|
|
</step>
|
|
<step>
|
|
<para>In the window that opens, enter a snapshot name
|
|
and a brief description.</para>
|
|
</step>
|
|
<step>
|
|
<para>Confirm your changes.</para>
|
|
<para>The dashboard shows the new volume snapshot in
|
|
the <guilabel>Images & Snapshots</guilabel>
|
|
category.</para>
|
|
</step>
|
|
</procedure>
|
|
</section>
|
|
<section xml:id="dashboard_delete_volume">
|
|
<title>Delete volumes</title>
|
|
<para>When you delete an instance, the data of its attached
|
|
volumes is not destroyed.</para>
|
|
<procedure>
|
|
<step>
|
|
<para>Log in to the dashboard, choose a project, and
|
|
click the <guibutton>Volumes</guibutton>
|
|
category.</para>
|
|
</step>
|
|
<step>
|
|
<para>Activate the check boxes in front of the volumes
|
|
that you want to delete.</para>
|
|
</step>
|
|
<step>
|
|
<para>Click <guibutton>Delete Volumes</guibutton> and
|
|
confirm your choice in the pop-up that
|
|
appears.</para>
|
|
</step>
|
|
<step>
|
|
<para>A message indicates whether the action was
|
|
successful.</para>
|
|
</step>
|
|
</procedure>
|
|
</section>
|
|
</section>
|