8f7d1bd81a
This begins the install guide chapter for neutron, and cleans up some sections from the guide that will not be used even as references. * hypervisor_selection - not relevant for the adventure where the choice is done prior, and makes some difficult value judgement statemtnts * scripted ubuntu install - not the purpose of this guide and old content that isn't helpful for the rewrite * image-troubleshooting - empty section, belongs in cloud-admin-guide anyway * vnc-console - already in image_install * identity_config_keystone - already better done in individual sections * install nova-volume - very dated content, already in cinder install * basic install files - no longer needed for reference Change-Id: I1979eeba091c7118db7cc30ad7c66f30345fe49d
134 lines
6.9 KiB
XML
134 lines
6.9 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="basic-install_controller-cinder">
|
|
<title>OpenStack Block Storage</title>
|
|
<para>While OpenStack Block Storage contains many different storage drivers, the
|
|
most basic configuration uses LVM and iSCSI. This
|
|
guide illustrates how to use one disk
|
|
(<literal>/dev/sdb</literal>) in an LVM Volume Group
|
|
called <literal>cinder-volumes</literal>. When a user requests
|
|
a block storage volume, a Logical Volume is created from this
|
|
Volume Group and then mounted on the user's instance by way of
|
|
iSCSI. <orderedlist>
|
|
<listitem>
|
|
<para>Install the OpenStack Block Storage packages:
|
|
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install cinder-api cinder-scheduler cinder-volume iscsitarget \
|
|
open-iscsi iscsitarget-dkms python-cinderclient \
|
|
linux-headers-`uname -r`</userinput></screen>
|
|
<screen os="centos;rhel;fedora"><prompt>#</prompt> <userinput>yum install openstack-cinder openstack-cinder-doc \
|
|
iscsi-initiator-utils scsi-target-utils</userinput></screen>
|
|
<screen os="opensuse"><prompt>#</prompt> <userinput>zypper install openstack-cinder-api openstack-cinder-scheduler \
|
|
openstack-cinder-volume open-iscsi iscsitarget</userinput></screen>
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Configure & start the iSCSI services: <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>sed -i 's/false/true/g' /etc/default/iscsitarget</userinput>
|
|
<prompt>#</prompt> <userinput>service iscsitarget start</userinput>
|
|
<prompt>#</prompt> <userinput>service open-iscsi start</userinput></screen>
|
|
<screen os="centos;rhel;fedora"><prompt>#</prompt> <userinput>service tgtd start</userinput>
|
|
<prompt>#</prompt> <userinput>service iscsi start</userinput>
|
|
<prompt>#</prompt> <userinput>chkconfig tgtd on</userinput>
|
|
<prompt>#</prompt> <userinput>chkconfig iscsi on</userinput></screen>
|
|
<screen os="opensuse"><prompt>#</prompt> <userinput>systemctl start iscsitarget.service iscsid.service</userinput>
|
|
<prompt>#</prompt> <userinput>systemctl enable iscsitarget.service iscsid.service</userinput></screen>
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Configure OpenStack Block Storage:</para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Edit <filename>/etc/cinder/cinder.conf</filename>:
|
|
<programlisting os="ubuntu;debian" language="ini">[DEFAULT]
|
|
sql_connection = mysql://cinder:password@localhost/cinder
|
|
rabbit_password = password
|
|
|
|
[keystone_authtoken]
|
|
admin_tenant_name = service
|
|
admin_user = cinder
|
|
admin_password = password
|
|
service_protocol = http
|
|
service_host = localhost
|
|
service_port = 5000
|
|
auth_host = localhost
|
|
auth_port = 35357
|
|
auth_protocol = http</programlisting><programlisting os="centos;rhel;fedora" language="ini">[DEFAULT]
|
|
rpc_backend = cinder.openstack.common.rpc.impl_qpid
|
|
sql_connection = mysql://cinder:password@localhost/cinder
|
|
qpid_user = guest
|
|
qpid_password = quest
|
|
|
|
[keystone_authtoken]
|
|
admin_tenant_name = service
|
|
admin_user = cinder
|
|
admin_password = password
|
|
service_protocol = http
|
|
service_host = localhost
|
|
service_port = 5000
|
|
auth_host = localhost
|
|
auth_port = 35357
|
|
auth_protocol = http</programlisting>
|
|
<programlisting os="opensuse" language="ini">[DEFAULT]
|
|
sql_connection = mysql://cinder:password@localhost/cinder
|
|
rabbit_password = password
|
|
|
|
[keystone_authtoken]
|
|
admin_tenant_name = service
|
|
admin_user = cinder
|
|
admin_password = password
|
|
service_protocol = http
|
|
service_host = localhost
|
|
service_port = 5000
|
|
auth_host = localhost
|
|
auth_port = 35357
|
|
auth_protocol = http</programlisting>
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Edit <filename>/etc/cinder/api-paste.ini</filename> in the
|
|
<literal>filter_authtoken</literal> section so it does not contain
|
|
any of the variables defined in the
|
|
<literal>keystone_authtoken</literal> section of
|
|
<filename>cinder.conf</filename>:
|
|
<programlisting language="ini">[filter:authtoken]
|
|
paste.filter_factory = keystoneclient.middleware.auth_token:filter_factory
|
|
# This section should not contain any other config options</programlisting>
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Create the LVM Physical Volume and
|
|
Logical Volume:
|
|
<screen><prompt>#</prompt> <userinput>pvcreate /dev/sdb</userinput>
|
|
<prompt>#</prompt> <userinput>vgcreate cinder-volumes /dev/sdb</userinput></screen>
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Create the OpenStack Block Storage tables in the database:
|
|
<screen><prompt>#</prompt> <userinput>cinder-manage db sync</userinput></screen>
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Restart the services: <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service cinder-api restart</userinput>
|
|
<prompt>#</prompt> <userinput>service cinder-scheduler restart</userinput>
|
|
<prompt>#</prompt> <userinput>service cinder-volume restart</userinput></screen>
|
|
<screen os="centos;rhel;fedora"><prompt>#</prompt> <userinput>service openstack-cinder-api restart</userinput>
|
|
<prompt>#</prompt> <userinput>service openstack-cinder-scheduler restart</userinput>
|
|
<prompt>#</prompt> <userinput>service openstack-cinder-volume restart</userinput>
|
|
<prompt>#</prompt> <userinput>chkconfig openstack-cinder-api on</userinput>
|
|
<prompt>#</prompt> <userinput>chkconfig openstack-cinder-scheduler on</userinput>
|
|
<prompt>#</prompt> <userinput>chkconfig openstack-cinder-volume on</userinput></screen>
|
|
<screen os="opensuse"><prompt>#</prompt> <userinput>systemctl restart openstack-cinder-api</userinput>
|
|
<prompt>#</prompt> <userinput>systemctl restart openstack-cinder-scheduler.service</userinput>
|
|
<prompt>#</prompt> <userinput>systemctl restart openstack-cinder-volume.service</userinput>
|
|
<prompt>#</prompt> <userinput>systemctl enable openstack-cinder-api.service</userinput>
|
|
<prompt>#</prompt> <userinput>systemctl enable openstack-cinder-scheduler.service</userinput>
|
|
<prompt>#</prompt> <userinput>systemctl enable openstack-cinder-volume.service</userinput></screen></para>
|
|
|
|
</listitem>
|
|
</itemizedlist>
|
|
</listitem>
|
|
</orderedlist>
|
|
</para>
|
|
</section>
|