Comment related to device name in attach volumes

Comment in "Attach Volumes to instances" ("Manage volumes" section), in
order to inform that device name may not match the one proposed by the user.
This limitation is related to hypervisor settings.
The documentation of this issue was recommended by John Griffith in
https://review.openstack.org/#/c/60257/

backport: havana
Related-Bug: #1217874

Change-Id: Ifa65ec6eecca23e85786b0fd79ae3b8ef8ebd537
This commit is contained in:
Veronica Musso 2013-12-19 14:33:35 -03:00 committed by Diane Fleming
parent 66d40fb23b
commit 76a040cb59

View File

@ -23,9 +23,8 @@
<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>
<para>Log in to the dashboard, choose a project, and
click the <guibutton>Volumes</guibutton>
category.</para>
</step>
<step>
@ -45,7 +44,6 @@
</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
@ -53,15 +51,13 @@
<procedure>
<!--<title>To attach volumes to instances</title>-->
<step>
<para>Log in to the dashboard, choose a
project, and click the
<guibutton>Volumes</guibutton>
<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>
click <guibutton>Edit Attachments</guibutton>.</para>
</step>
<step>
<para>In the <guilabel>Manage Volume
@ -69,16 +65,20 @@
instance.</para>
</step>
<step>
<para>Enter a device name under which the volume
should be accessible on the virtual machine.
</para>
<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 has been attached and
the volume's device name. You can attach a volume
to one instance at a time.</para>
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
@ -87,8 +87,8 @@
available or In-Use.</para>
</step>
<step>
<para>Now you can log in to the instance, mount the
disk, format it, and use it.</para>
<para>Now you can log in to the instance and mount,
format, and use the disk.</para>
</step>
</procedure>
</section>
@ -96,9 +96,8 @@
<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>
<para>Log in to the dashboard, choose a project, and
click the <guibutton>Volumes</guibutton>
category.</para>
</step>
<step>
@ -119,18 +118,16 @@
<title>Create volume snapshots</title>
<procedure>
<step>
<para>Log in to the dashboard, choose a
project, and click the <guilabel>Instances &amp;
<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>
<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>
list, select <guilabel>Create Snapshot</guilabel>.</para>
</step>
<step>
<para>In the window that opens, enter a snapshot name
@ -150,9 +147,8 @@
volumes is not destroyed.</para>
<procedure>
<step>
<para>Log in to the dashboard, choose a
project, and click the
<guibutton>Volumes</guibutton>
<para>Log in to the dashboard, choose a project, and
click the <guibutton>Volumes</guibutton>
category.</para>
</step>
<step>