07dc1fcc37
I improved the cinder chapter of the installation guide as follows: 1) Renamed storage node files, titles, and XML IDs to conform with standards. 2) Rewrote introductory content to increase depth. 3) Clarified requirements for controller and storage nodes. 4) Added steps to configure storage node operating system prior to installing the volume service. 5) Rewrote LVM filter content because the original content was vague and confusing. 6) Added more command output. 7) Added 'cinder list' command to verify section. I eventually want to restructure the architecture and basic environment content to integrate organization and configuration of optional nodes. Adding steps to configure the storage node operating in this chapter temporarily fills a void. Change-Id: Iaa404ee7b3fcbc0a14450cab6ae378f698890d7d Implements: blueprint installation-guide-improvements
80 lines
4.5 KiB
XML
80 lines
4.5 KiB
XML
<?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="cinder-verify">
|
|
<title>Verify operation</title>
|
|
<para>This section describes how to verify operation of the Block Storage
|
|
service by creating a 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>
|
|
<note>
|
|
<para>Perform these commands on the controller node.</para>
|
|
</note>
|
|
<procedure>
|
|
<step>
|
|
<para>Source the <literal>admin</literal> credentials to gain access to
|
|
admin-only CLI commands:</para>
|
|
<screen><prompt>$</prompt> <userinput>source admin-openrc.sh</userinput></screen>
|
|
</step>
|
|
<step>
|
|
<para>List service components to verify successful launch of each
|
|
process:</para>
|
|
<screen><prompt>$</prompt> <userinput>cinder service-list</userinput>
|
|
<computeroutput>+------------------+------------+------+---------+-------+----------------------------+-----------------+
|
|
| Binary | Host | Zone | Status | State | Updated_at | Disabled Reason |
|
|
+------------------+------------+------+---------+-------+----------------------------+-----------------+
|
|
| cinder-scheduler | controller | nova | enabled | up | 2014-10-18T01:30:54.000000 | None |
|
|
| cinder-volume | block1 | nova | enabled | up | 2014-10-18T01:30:57.000000 | None |
|
|
+------------------+------------+------+---------+-------+----------------------------+-----------------+</computeroutput></screen>
|
|
</step>
|
|
<step>
|
|
<para>Source the <literal>demo</literal> tenant credentials to perform
|
|
the following steps as a non-administrative tenant:</para>
|
|
<screen><prompt>$</prompt> <userinput>source demo-openrc.sh</userinput></screen>
|
|
</step>
|
|
<step>
|
|
<para>Create a 1 GB volume:</para>
|
|
<screen><prompt>$</prompt> <userinput>cinder create --display-name demo-volume1 1</userinput>
|
|
<computeroutput>+---------------------+--------------------------------------+
|
|
| Property | Value |
|
|
+---------------------+--------------------------------------+
|
|
| attachments | [] |
|
|
| availability_zone | nova |
|
|
| bootable | false |
|
|
| created_at | 2014-10-14T23:11:50.870239 |
|
|
| display_description | None |
|
|
| display_name | demo-volume1 |
|
|
| encrypted | False |
|
|
| id | 158bea89-07db-4ac2-8115-66c0d6a4bb48 |
|
|
| metadata | {} |
|
|
| size | 1 |
|
|
| snapshot_id | None |
|
|
| source_volid | None |
|
|
| status | creating |
|
|
| volume_type | None |
|
|
+---------------------+--------------------------------------+</computeroutput></screen>
|
|
</step>
|
|
<step>
|
|
<para>Verify creation and availability of the volume:</para>
|
|
<screen><prompt>$</prompt> <userinput>cinder list</userinput>
|
|
<computeroutput>--------------------------------------+-----------+--------------+------+-------------+----------+-------------+
|
|
| ID | Status | Display Name | Size | Volume Type | Bootable | Attached to |
|
|
+--------------------------------------+-----------+--------------+------+-------------+----------+-------------+
|
|
| 158bea89-07db-4ac2-8115-66c0d6a4bb48 | available | demo-volume1 | 1 | None | false | |
|
|
+--------------------------------------+-----------+--------------+------+-------------+----------+-------------+</computeroutput></screen>
|
|
<para>If the status does not indicate <literal>available</literal>,
|
|
check the logs in the <filename>/var/log/cinder</filename> directory
|
|
on the controller and volume nodes for more information.</para>
|
|
<note>
|
|
<para>The
|
|
<link linkend="launch-instance">launch an instance</link>
|
|
chapter includes instructions for attaching this volume to an
|
|
instance.</para>
|
|
</note>
|
|
</step>
|
|
</procedure>
|
|
</section>
|