openstack/openstack-manuals
Code Issues Proposed changes

Install guide: add a cinder-verify section

Browse Source 
Describe how the Block Storage service can be tested after installation
(volume creation).

Closes-Bug: #1308370
Change-Id: If9d589c2afcdce13f33d53a27c18526ff3f6b90e
This commit is contained in:
Gauvain Pocentek 2014-04-17 14:05:47 +02:00
parent 2ef9797a58
commit 6cae4bcd6c
2 changed files with 55 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
doc/install-guide/ch_cinder.xml
View File

@ -15,6 +15,7 @@
<xi:include href="../common/section_getstart_block-storage.xml"/>
<xi:include href="section_cinder-controller.xml"/>
<xi:include href="section_cinder-node.xml"/>
<xi:include href="section_cinder-verify.xml"/>
<section xml:id="section_cinder_next_steps">
<title>Next steps</title>
<para>Your OpenStack environment now includes Block Storage. You can

54
doc/install-guide/section_cinder-verify.xml Normal file
View File

@ -0,0 +1,54 @@
<?xml version="1.0" encoding="UTF-8"?>
<section xml:id="cinder-verify" 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">
<title>Verify the Block Storage installation</title>
<para>To verify that the Block Storage is installed and configured properly,
create a new volume.</para>
<para>For more information about how to manage volumes, see the <link
xlink:href="http://docs.openstack.org/user-guide/content/index.html"
><citetitle>OpenStack User Guide</citetitle></link>.</para>
<procedure>
<step>
<para>Source the <filename>demo-openrc.sh</filename> file:</para>
<screen><prompt>$</prompt> <userinput>source demo-openrc.sh</userinput></screen>
</step>
<step>
<para>Use the <command>cinder create</command> command to create a new volume:</para>
<screen><prompt>$</prompt> <userinput>cinder create --display-name myVolume 1</userinput>
<computeroutput>+---------------------+--------------------------------------+
| Property | Value |
+---------------------+--------------------------------------+
| attachments | [] |
| availability_zone | nova |
| bootable | false |
| created_at | 2014-04-17T10:28:19.615050 |
| display_description | None |
| display_name | myVolume |
| encrypted | False |
| id | 5e691b7b-12e3-40b6-b714-7f17550db5d1 |
| metadata | {} |
| size | 1 |
| snapshot_id | None |
| source_volid | None |
| status | creating |
| volume_type | None |
+---------------------+--------------------------------------+</computeroutput></screen>
</step>
<step>
<para>Make sure that the volume has been correctly created with the
<command>cinder list</command> command:</para>
<screen><prompt>$</prompt> <userinput>cinder list</userinput>
<computeroutput>--------------------------------------+-----------+--------------+------+-------------+----------+-------------+
| ID | Status | Display Name | Size | Volume Type | Bootable | Attached to |
+--------------------------------------+-----------+--------------+------+-------------+----------+-------------+
| 5e691b7b-12e3-40b6-b714-7f17550db5d1 | available | myVolume | 1 | None | false | |
+--------------------------------------+-----------+--------------+------+-------------+----------+-------------+</computeroutput></screen>
<para>If the status value is not <literal>available</literal>, the volume
creation failed. Check the log files in the
<filename>/var/log/cinder/</filename> directory on the controller and
volume nodes to get information about the failure.</para>
</step>
</procedure>
</section>