openstack/openstack-manuals
Code Issues Proposed changes
b9e1b71e6c
openstack-manuals/doc/user-guide/source/dashboard_manage_volumes.rst
Andreas Jaeger 28d95bfc66 End User Guide: Remove user_only and orphan 
With the split of the User Guides, there's no need anymore to have
orphan and user_only flags, remove them from the user-guide
directory.

Only files that keep :orphan: are
doc/user-guide/source/hot-guide/hot_advanced_topics.rst and
hot_existing_templates.rst since these files are not currently included.

Change-Id: I1ac0356d69d8668785f8b1947e8b061731aca747
2015-05-13 18:09:16 +00:00

4.6 KiB
Raw Blame History

Create and manage volumes

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.

Create a volume

  1. Log in to the dashboard, choose a project, and click Volumes.

  2. Click Create Volume.

    In the dialog box that opens, enter or select the following values.

    Volume Name: Specify a name for the volume.

    Description: Optionally, provide a brief description for the volume.

    Type: Leave this field blank.

    Size (GB): The size of the volume in gigabytes.

    Volume Source: 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.
    • Availability Zone: 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.

  3. 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.

  1. Log in to the dashboard, choose a project, and click Volumes.

  2. Select the volume to add to an instance and click Edit Attachments.

  3. In the Manage Volume Attachments dialog box, select an instance.

  4. Enter the name of the device from which the volume is accessible by the instance.

  5. 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.

Detach a volume from an instance

  1. Log in to the dashboard, choose a project, and click Volumes.
  2. Select the volume and click Edit Attachments.
  3. Click Detach Volume and confirm your changes.

A message indicates whether the action was successful.

Create a snapshot from a volume

  1. Log in to the dashboard, choose a project, and click Volumes.

  2. Select a volume from which to create a snapshot.

  3. From the More list, select Create Snapshot.

  4. In the dialog box that opens, enter a snapshot name and a brief description.

  5. Confirm your changes.

    The dashboard shows the new volume snapshot in Volume Snapshots tab.

Edit a volume

  1. Log in to the dashboard, choose a project, and click Volumes.
  2. From the CURRENT PROJECT on the Project tab, select the appropriate project.
  3. On the Project tab, click Volumes.
  4. Select the image that you want to edit.
  5. In the Actions column, click Edit Volume.
  6. In the Edit Volume dialog box, update the name and description of the image.
  7. Click Edit Volume.

Delete a volume

When you delete an instance, the data in its attached volumes is not destroyed.

  1. Log in to the dashboard, choose a project, and click Volumes.

  2. Select the check boxes for the volumes that you want to delete.

  3. Click Delete Volumes and confirm your choice.

    A message indicates whether the action was successful.