Skip to content

Commit

Permalink
Add additional instructions for cinder install
Browse files Browse the repository at this point in the history
the volume creation was not documented for cinder install

this patch adds it.

Backport: stable/havana

Change-Id: I70e2c2a537ce35225fbf4210b05be06052431246
  • Loading branch information
fifieldt committed Oct 18, 2013
1 parent 59710f4 commit 62ec40a
Show file tree
Hide file tree
Showing 2 changed files with 15 additions and 10 deletions.
12 changes: 6 additions & 6 deletions doc/install-guide/section_cinder-controller.xml
Expand Up @@ -97,9 +97,9 @@ admin_password=<replaceable>CINDER_PASS</replaceable>
the endpoint.</para>
<screen><prompt>#</prompt> <userinput>keystone endpoint-create \
--service-id=<replaceable>the_service_id_above</replaceable> \
--publicurl=http://<replaceable>controlller</replaceable>:8776/v1/%\(tenant_id\)s \
--internalurl=http://<replaceable>controlller</replaceable>:8776/v1/%\(tenant_id\)s \
--adminurl=http://<replaceable>controlller</replaceable>:8776/v1/%\(tenant_id\)s</userinput></screen>
--publicurl=http://<replaceable>controller</replaceable>:8776/v1/%\(tenant_id\)s \
--internalurl=http://<replaceable>controller</replaceable>:8776/v1/%\(tenant_id\)s \
--adminurl=http://<replaceable>controller</replaceable>:8776/v1/%\(tenant_id\)s</userinput></screen>
</step>
<step><para>Also register a service and endpoint for version 2 of the
Block Storage Service API.</para>
Expand All @@ -109,9 +109,9 @@ admin_password=<replaceable>CINDER_PASS</replaceable>
the endpoint.</para>
<screen><prompt>#</prompt> <userinput>keystone endpoint-create \
--service-id=<replaceable>the_service_id_above</replaceable> \
--publicurl=http://<replaceable>controlller</replaceable>:8776/v2/%\(tenant_id\)s \
--internalurl=http://<replaceable>controlller</replaceable>:8776/v2/%\(tenant_id\)s \
--adminurl=http://<replaceable>controlller</replaceable>:8776/v2/%\(tenant_id\)s</userinput></screen>
--publicurl=http://<replaceable>controller</replaceable>:8776/v2/%\(tenant_id\)s \
--internalurl=http://<replaceable>controller</replaceable>:8776/v2/%\(tenant_id\)s \
--adminurl=http://<replaceable>controller</replaceable>:8776/v2/%\(tenant_id\)s</userinput></screen>
</step>

<step os="ubuntu;debian">
Expand Down
13 changes: 9 additions & 4 deletions doc/install-guide/section_cinder-node.xml
Expand Up @@ -28,8 +28,7 @@

<step><para>After you configure the operating system, install the appropriate
packages for the block storage service.</para>
<!-- FIXME: Double check list of packages for ubuntu -->
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install cinder-volume</userinput></screen>
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install cinder-volume lvm2</userinput></screen>
<screen os="centos;rhel;fedora"><prompt>#</prompt> <userinput>yum install openstack-cinder openstack-utils openstack-selinux</userinput></screen>
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install openstack-cinder-volume</userinput></screen>
</step>
Expand Down Expand Up @@ -84,6 +83,13 @@ rabbit_port = 5672
DEFAULT rabbit_port 5672</userinput></screen>
</step>

<step>
<para>Now, create the LVM Physical Volume and Logical Volume.
This guide assumes a second disk <literal>/dev/sdb</literal> that
will be used for this purpose.</para>
<screen><prompt>#</prompt> <userinput>pvgreate /dev/sdb</userinput>
<prompt>#</prompt> <userinput>vgcreate cinder-volumes /dev/sdb</userinput></screen>
</step>

<step>
<para>Add a filter entry to the devices section
Expand All @@ -96,15 +102,14 @@ rabbit_port = 5672
"<literal>a</literal>" for accept, or an "<literal>r</literal>" for reject.
Physical volumes that are needed on the Cinder host begin with
"<literal>a</literal>". The array must end with
"<literal>r/.*/</literal>"</para>
"<literal>r/.*/</literal>" to reject any device not listed.</para>
<programlisting>devices {
...
filter = [ "a/sda1/", "a/sdb1/", "r/.*/"]
...
}</programlisting>
</step>


<step os="ubuntu;debian">
<para>We now restart the cinder service with its new settings.</para>
<screen><prompt>#</prompt> <userinput>service cinder-volume restart</userinput>
Expand Down

0 comments on commit 62ec40a

Please sign in to comment.