From 6b5a39c8b03afe44efcafe9d1a15dce5b49e48d6 Mon Sep 17 00:00:00 2001 From: Deepti Navale Date: Tue, 29 Apr 2014 09:06:07 +1000 Subject: [PATCH] Updates to the 'Create and manage volumes' section Updated to reflect the following changes: - Updated to 'Create a volume' procedure to include * New volumes sources (snapshots and volumes can now be used as sources). * Using image as source displays new 'availibility zone' field. - New procedure to edit a volume. - Note about new option to extend volumes. - Minor updates like 'Images & Snapshots' to 'Volume Snapshots'. Partial-Bug: #1307860 Change-Id: I00b937e462898c3a5f8086b90e33c568b8770561 --- .../section_dashboard_manage_volumes.xml | 272 +++++++++++------- 1 file changed, 161 insertions(+), 111 deletions(-) diff --git a/doc/user-guide/section_dashboard_manage_volumes.xml b/doc/user-guide/section_dashboard_manage_volumes.xml index 86fec590ff..ec9bdbb56d 100644 --- a/doc/user-guide/section_dashboard_manage_volumes.xml +++ b/doc/user-guide/section_dashboard_manage_volumes.xml @@ -10,7 +10,7 @@ xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="dashboard_manage_volumes"> - Manage volumes + Create and manage volumes Volumes are block storage devices that you attach to instances to enable persistent storage. You can attach a @@ -21,7 +21,6 @@
Create a volume - Log in to the dashboard, choose a project, and click Volumes. @@ -52,8 +51,8 @@ - Optionally, provide a brief - description for the volume. + Optionally, provide a brief description for the + volume. @@ -84,140 +83,191 @@ - Select one of the following - options: - - - No source, empty - volume: creates an empty - volume.Note: An empty volume does not contain a file system or a - partition table. - - - - Image: creates - a volume from an image. Select the - image from the list. - - + Select one of the following options: + + + No source, empty volume + Creates an empty volume. + An empty volume does not contain a file + system or a partition table. + + + Snapshot + If you choose this option, a new field + for Use snapshot as a source + displays. You can select the snapshot from the list. + + + + Image + If you choose this option, a new field + for Use image as a source + displays. You can select the image from the list. + Select the Availability Zone + from the list. By default, this value is set to the + availability zone given by the cloud provider + (for example, us-west or + apac-south). For some cases, it + could be nova. + + + Volume + If you choose this option, a new field + for Use volume as a source + displays. You can select the volume from the list. + + + + Options to use a snapshot or a volume as the + source for a volume are displayed only if there are + existing snapshots or volumes. + - Click Create - Volume. + Click Create Volume. The dashboard shows the volume on the Volumes tab.
-
+
Attach a volume to an instance - After you create one or more volumes, you can attach - them to instances. You can attach a volume to one instance - at a time. + After you create one or more volumes, you can attach them to + instances. You can attach a volume to one instance at a time. - - - Log in to the dashboard, choose a project, and - click Volumes. - - - Select the volume to add to an instance and - click Edit Attachments. - - - In the Manage Volume - Attachments dialog box, select an - instance. - - - Enter the name of the device from which the - volume is accessible by the instance. - - The actual device name might differ from the - volume name because of hypervisor - settings. - - - - Click Attach Volume. - The dashboard shows the instance to which the - volume is now attached and the device name. - + + Log in to the dashboard, choose a project, and click + Volumes. + + + Select the volume to add to an instance and click + Edit Attachments. + + + In the Manage Volume Attachments dialog box, + select an instance. + + + Enter the name of the device from which the volume is + accessible by the instance. + + The actual device name might differ from the volume name + because of hypervisor settings. + + + + Click Attach Volume. + The dashboard shows the instance to which the + volume is now attached and the device name. + - You can view the status of a volume in the - Volumes tab of the dashboard. The - volume is either Available or In-Use. - Now you can log in to the instance and mount, - format, and use the disk. -
-
+ You can view the status of a volume in the Volumes + tab of the dashboard. The volume is either Available or In-Use. + Now you can log in to the instance and mount, format, and use the + disk. +
+
Detach a volume from an instance - - Log in to the dashboard, choose a project, and - click Volumes. - - - Select the volume and click Edit - Attachments. - - - Click Detach Volume and - confirm your changes. - - - A message indicates whether the action was - successful. -
-
+ + Log in to the dashboard, choose a project, and click + Volumes. + + + Select the volume and click Edit Attachments. + + + Click Detach Volume and confirm your + changes. + + + A message indicates whether the action was successful. +
+
Create a snapshot from a volume - - Log in to the dashboard, choose a project, and - click Volumes. + + Log in to the dashboard, choose a project, and click + Volumes. - Select a volume from which to create a snapshot. + Select a volume from which to create a snapshot. - From the More list, select - Create Snapshot. + From the More list, select + Create Snapshot. - In the dialog box that opens, enter a snapshot - name and a brief description. + In the dialog box that opens, enter a snapshot name and a + brief description. - Confirm your changes. - The dashboard shows the new volume snapshot in - Images & - Snapshots. + Confirm your changes. + The dashboard shows the new volume snapshot in + Volume Snapshots tab. -
-
- Delete a volume - When you delete an instance, the data in its attached - volumes is not destroyed. +
+
+ Edit a volume - - Log in to the dashboard, choose a project, and - click Volumes. - - - Select the check boxes for the volumes that you - want to delete. - - - Click Delete Volumes and - confirm your choice. - A message indicates whether the action was - successful. - + + Log in to the dashboard, choose a project, and click + Volumes. + + + From the CURRENT PROJECT on the + Project tab, select the appropriate + project. + + + On the Project tab, click + Volumes. + + + Select the image that you want to edit. + + + In the Actions column, click + Edit Volume. + + + In the Edit Volume dialog box, update the + name and description of the image. + + + Click Edit Volume. + -
-
+ + You can extend a volume by using the Extend Volume + option available in the More dropdown list + and entering the new value for volume size. + + +
+ Delete a volume + When you delete an instance, the data in its attached + volumes is not destroyed. + + + Log in to the dashboard, choose a project, and + click Volumes. + + + Select the check boxes for the volumes that you + want to delete. + + + Click Delete Volumes and + confirm your choice. + A message indicates whether the action was + successful. + + +
+ \ No newline at end of file