<?xml version="1.0" encoding="UTF-8"?>
<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>Create and 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>
            <step>
                <para>Log in to the dashboard, choose a project, and
                    click <guibutton>Volumes</guibutton>.</para>
            </step>
            <step>
                <para>Click <guibutton>Create Volume</guibutton>.</para>
                <para>In the dialog box 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>Specify a name for the
                                   volume.</para>
                          </td>
                        </tr>
                          <tr>
                          <td>
                            <para>
                              <guilabel>Description</guilabel>
                            </para>
                          </td>
                          <td>
                            <para>Optionally, provide 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
                                   gigabytes.</para>
                      </td>
                      </tr>
                      <tr>
                      <td>
                        <para>
                          <guilabel>Volume Source</guilabel>
                        </para>
                      </td>
                      <td>
                        <para>Select one of the following options:</para>
                        <variablelist>
                          <varlistentry>
                          <term><guilabel>No source, empty volume</guilabel></term>
                            <listitem><para>Creates an empty volume.</para>
                            <note><para>An empty volume does not contain a file
                              system or a partition table.</para></note></listitem>
                          </varlistentry>
                          <varlistentry>
                            <term><guilabel>Snapshot</guilabel></term>
                            <listitem><para>If you choose this option, a new field
                            for <guilabel>Use snapshot as a source</guilabel>
                            displays. You can select the snapshot from the list.
                            </para></listitem>
                          </varlistentry>
                          <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>
                     </tr>
                </tbody>
            </informaltable>
            </step>
            <step>
                <para>Click <guibutton>Create Volume</guibutton>.</para>
            </step>
        </procedure>
                <para>The dashboard shows the volume on the
                <guilabel>Volumes</guilabel> tab.</para>
    </section>
      <section xml:id="attach_volumes_to_instances">
        <title>Attach a volume to an instance</title>
        <para>After you create one or more volumes, you can attach them to
        instances. You can attach a volume to one instance at a time.</para>
        <procedure>
          <step>
            <para>Log in to the dashboard, choose a project, and click
            <guibutton>Volumes</guibutton>.</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> dialog box,
            select an instance.</para>
          </step>
          <step>
            <para>Enter the name of the device from which the volume is
            accessible by the instance.</para>
            <note>
              <para>The actual device name might differ from the volume name
              because of hypervisor settings.</para>
            </note>
          </step>
          <step>
            <para>Click <guibutton>Attach Volume</guibutton>.</para>
            <para>The dashboard shows the instance to which the
            volume is now attached and the device name.</para>
          </step>
        </procedure>
        <para>You can view the status of a volume in the <guilabel>Volumes</guilabel>
        tab of the dashboard. The volume is either Available or In-Use.</para>
        <para>Now you can log in to the instance and mount, format, and use the
        disk.</para>
      </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
            <guibutton>Volumes</guibutton>.</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>
        </procedure>
        <para>A message indicates whether the action was successful.</para>
      </section>
      <section xml:id="create_volume_snapsnots">
        <title>Create a snapshot from a volume</title>
        <procedure>
          <step>
            <para>Log in to the dashboard, choose a project, and click
              <guilabel>Volumes</guilabel>.</para>
            </step>
            <step>
              <para>Select a volume from which to create a snapshot.</para>
            </step>
            <step>
              <para>From the <guilabel>More</guilabel> list, select
              <guilabel>Create Snapshot</guilabel>.</para>
            </step>
            <step>
              <para>In the dialog box 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
              <guilabel>Volume Snapshots</guilabel> tab.</para>
            </step>
        </procedure>
      </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">
        <title>Delete a volume</title>
          <para>When you delete an instance, the data in its attached
          volumes is not destroyed.</para>
          <procedure>
            <step>
              <para>Log in to the dashboard, choose a project, and
              click <guibutton>Volumes</guibutton>.</para>
            </step>
            <step>
              <para>Select the check boxes for the volumes that you
              want to delete.</para>
            </step>
            <step>
              <para>Click <guibutton>Delete Volumes</guibutton> and
              confirm your choice.</para>
              <para>A message indicates whether the action was
              successful.</para>
            </step>
          </procedure>
        </section>
</section>