92 lines
5.6 KiB
XML
92 lines
5.6 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/index.html"
|
|
><citetitle>OpenStack User Guide</citetitle></link>.</para>
|
|
<note>
|
|
<para>Perform these commands on the controller node.</para>
|
|
</note>
|
|
<procedure>
|
|
<step>
|
|
<para>In each client environment script, configure the Block Storage
|
|
client to use API version 2.0:</para>
|
|
<screen><prompt>$</prompt> <userinput>echo "export OS_VOLUME_API_VERSION=2" | tee -a admin-openrc.sh demo-openrc.sh</userinput></screen>
|
|
</step>
|
|
<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@lvm | nova | enabled | up | 2014-10-18T01:30:57.000000 | None |
|
|
+------------------+------------+------+---------+-------+----------------------------+-----------------+</computeroutput></screen>
|
|
</step>
|
|
<step>
|
|
<para>Source the <literal>demo</literal> credentials to perform
|
|
the following steps as a non-administrative project:</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 --name demo-volume1 1</userinput>
|
|
<computeroutput>+---------------------------------------+--------------------------------------+
|
|
| Property | Value |
|
|
+---------------------------------------+--------------------------------------+
|
|
| attachments | [] |
|
|
| availability_zone | nova |
|
|
| bootable | false |
|
|
| consistencygroup_id | None |
|
|
| created_at | 2015-04-21T23:46:08.000000 |
|
|
| description | None |
|
|
| encrypted | False |
|
|
| id | 6c7a3d28-e1ef-42a0-b1f7-8d6ce9218412 |
|
|
| metadata | {} |
|
|
| multiattach | False |
|
|
| name | demo-volume1 |
|
|
| os-vol-tenant-attr:tenant_id | ab8ea576c0574b6092bb99150449b2d3 |
|
|
| os-volume-replication:driver_data | None |
|
|
| os-volume-replication:extended_status | None |
|
|
| replication_status | disabled |
|
|
| size | 1 |
|
|
| snapshot_id | None |
|
|
| source_volid | None |
|
|
| status | creating |
|
|
| user_id | 3a81e6c8103b46709ef8d141308d4c72 |
|
|
| 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 | Name | Size | Volume Type | Bootable | Attached to |
|
|
+--------------------------------------+-----------+--------------+------+-------------+----------+-------------+
|
|
| 6c7a3d28-e1ef-42a0-b1f7-8d6ce9218412 | 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>
|