openstack-manuals/doc/user-guide/section_dashboard_manage_volumes.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE section [
<!-- Some useful entities borrowed from HTML -->
<!ENTITY ndash  "&#x2013;">
<!ENTITY mdash  "&#x2014;">
<!ENTITY hellip "&#x2026;">
<!ENTITY plusmn "&#xB1;">
]>
<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 a name, an
                    optional description, and the size in GBs for the
                    volume.</para>
            </step>
            <step>
                <para>Click <guibutton>Create Volume</guibutton> 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>Instances &amp; 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>Instances &amp;
                        Volumes</guilabel> category.</para>
            </step>
            <step>
                <para>Select a volume from which to create a snapshot.</para>
            </step>
            <step>
                <para>From the <guilabel>Actions</guilabel> drop-down
                    list, select <guilabel>Create Snapshot</guilabel>.</para>
            </step>
            <step>
                <para>In the window that opens, enter a snapshot name
                    and a description.</para>
            </step>
            <step>
                <para>Confirm your changes.</para>
                <para>The dashboard shows the new volume snapshot in
                    the <guilabel>Images &amp; 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>