9e863fc2f3
I made the following changes to update content for the RDO Icehouse release packages: 1) Changed RDO repository package from rdo-release-icehouse-2.noarch.rpm to rdo-release-icehouse-3.noarch.rpm. 2) Added "python-glanceclient" to list of packages to install for glance. 3) Added "auth_protocol = http" and "auth_port = 35357" to glance-api.conf and glance-registry.conf. 4) Changed "rpc_backend = nova.openstack.common.rpc.impl_qpid" to "rpc_backend = qpid" in nova.conf on all nodes. 5) Removed "python-novaclient" from list of packages to install for neutron on the network node. 6) Added "python-neutronclient" to list of packages to install for neutron controller node. Change-Id: I7f2456d5b3ece249abb774b0524fac7639d04ecb Closes-Bug: #1312921
237 lines
13 KiB
XML
237 lines
13 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<section xml:id="glance-install" xmlns="http://docbook.org/ns/docbook"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
xmlns:xlink="http://www.w3.org/1999/xlink"
|
|
xmlns:svg="http://www.w3.org/2000/svg"
|
|
xmlns:html="http://www.w3.org/1999/xhtml" version="5.0">
|
|
<title>Install the Image Service</title>
|
|
<para>The OpenStack Image Service acts as a registry for virtual disk
|
|
images. Users can add new images or take a snapshot of an image from an
|
|
existing server for immediate storage. Use snapshots for back up
|
|
and as templates to launch new servers. You can store registered
|
|
images in Object Storage or in other locations. For example, you
|
|
can store images in simple file systems or external web
|
|
servers.</para>
|
|
<note>
|
|
<para>This procedure assumes you set the appropriate environment
|
|
variables to your credentials as described in <xref
|
|
linkend="keystone-verify"/>.</para>
|
|
</note>
|
|
<procedure>
|
|
<step>
|
|
<para>Install the Image Service on the controller node:</para>
|
|
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install glance python-glanceclient</userinput></screen>
|
|
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install openstack-glance python-glanceclient</userinput></screen>
|
|
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install openstack-glance python-glanceclient</userinput></screen>
|
|
</step>
|
|
|
|
<step os="debian">
|
|
<para>Respond to prompts for <link
|
|
linkend="debconf-dbconfig-common">database
|
|
management</link>, <link linkend="debconf-keystone_authtoken"
|
|
><literal>[keystone_authtoken]</literal> settings</link>,
|
|
<link linkend="debconf-rabbitqm">RabbitMQ credentials</link>
|
|
and <link linkend="debconf-api-endpoints">API endpoint</link>
|
|
registration. You must also select the caching type:</para>
|
|
<mediaobject>
|
|
<imageobject>
|
|
<imagedata scale="50"
|
|
fileref="figures/debconf-screenshots/glance-common_pipeline_flavor.png"
|
|
/>
|
|
</imageobject>
|
|
</mediaobject>
|
|
</step>
|
|
<step>
|
|
<para>The Image Service stores information about images in a
|
|
database. The examples in this guide use the MySQL database
|
|
that is used by other OpenStack services.</para>
|
|
<para>Configure the location of the database. The Image Service
|
|
provides the <systemitem class="service"
|
|
>glance-api</systemitem> and <systemitem class="service"
|
|
>glance-registry</systemitem> services, each with its own
|
|
configuration file. You must update both configuration files
|
|
throughout this section. Replace
|
|
<replaceable>GLANCE_DBPASS</replaceable> with your Image
|
|
Service database password.</para>
|
|
<screen os="rhel;centos;fedora;opensuse;sles"><prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-api.conf database \
|
|
connection mysql://glance:<replaceable>GLANCE_DBPASS</replaceable>@<replaceable>controller</replaceable>/glance</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-registry.conf database \
|
|
connection mysql://glance:<replaceable>GLANCE_DBPASS</replaceable>@<replaceable>controller</replaceable>/glance</userinput></screen>
|
|
<para os="ubuntu;debian">Edit
|
|
<filename>/etc/glance/glance-api.conf</filename> and
|
|
<filename>/etc/glance/glance-registry.conf</filename> and
|
|
edit the <literal>[database]</literal> section of each
|
|
file:</para>
|
|
<programlisting os="ubuntu;debian" language="ini">...
|
|
[database]
|
|
connection = mysql://glance:GLANCE_DBPASS@<replaceable>controller</replaceable>/glance</programlisting>
|
|
</step>
|
|
|
|
|
|
<step os="fedora;rhel;centos">
|
|
<para>Configure the Image Service to use the message broker:</para>
|
|
<screen><prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-api.conf DEFAULT \
|
|
rpc_backend qpid</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-api.conf DEFAULT \
|
|
qpid_hostname <replaceable>controller</replaceable></userinput></screen>
|
|
</step>
|
|
<step os="ubuntu">
|
|
<para>Configure the Image Service to use the message broker:</para>
|
|
<substeps>
|
|
<step>
|
|
<para>Edit the <filename>/etc/glance/glance-api.conf</filename>
|
|
file and add the following keys to the
|
|
<literal>[DEFAULT]</literal> section:</para>
|
|
<para>Replace <replaceable>RABBIT_PASS</replaceable> with the
|
|
password you chose for the <literal>guest</literal> account in
|
|
<application>RabbitMQ</application>.</para>
|
|
<programlisting language="ini">[DEFAULT]
|
|
...
|
|
rpc_backend = rabbit
|
|
rabbit_host = <replaceable>controller</replaceable>
|
|
rabbit_password = <replaceable>RABBIT_PASS</replaceable></programlisting>
|
|
</step>
|
|
</substeps>
|
|
</step>
|
|
<step os="opensuse;sles">
|
|
<para>Configure the Image Service to use the message broker:</para>
|
|
<para>Replace <replaceable>RABBIT_PASS</replaceable> with the password
|
|
you chose for the <literal>guest</literal> account in
|
|
<application>RabbitMQ</application>.</para>
|
|
<screen><prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-api.conf DEFAULT \
|
|
rpc_backend rabbit</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-api.conf DEFAULT \
|
|
rabbit_host <replaceable>controller</replaceable></userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-api.conf DEFAULT \
|
|
rabbit_password <replaceable>RABBIT_PASS</replaceable></userinput></screen>
|
|
</step>
|
|
|
|
<step os="ubuntu">
|
|
<para>By default, the Ubuntu packages create an SQLite database.
|
|
Delete the <filename>glance.sqlite</filename> file created in
|
|
the <filename>/var/lib/glance/</filename> directory so that it
|
|
does not get used by mistake:</para>
|
|
<screen><prompt>#</prompt> <userinput>rm /var/lib/glance/glance.sqlite</userinput></screen>
|
|
</step>
|
|
<step os="ubuntu;rhel;centos;fedora;opensuse;sles">
|
|
<para>Use the password you created to log in as root and create
|
|
a <literal>glance</literal> database user:</para>
|
|
<screen><prompt>$</prompt> <userinput>mysql -u root -p</userinput>
|
|
<prompt>mysql></prompt> <userinput>CREATE DATABASE glance;</userinput>
|
|
<prompt>mysql></prompt> <userinput>GRANT ALL PRIVILEGES ON glance.* TO 'glance'@'localhost' \
|
|
IDENTIFIED BY '<replaceable>GLANCE_DBPASS</replaceable>';</userinput>
|
|
<prompt>mysql></prompt> <userinput>GRANT ALL PRIVILEGES ON glance.* TO 'glance'@'%' \
|
|
IDENTIFIED BY '<replaceable>GLANCE_DBPASS</replaceable>';</userinput></screen>
|
|
</step>
|
|
<step os="ubuntu;rhel;centos;fedora">
|
|
<para>Create the database tables for the Image Service:</para>
|
|
<screen><prompt>#</prompt> <userinput>su -s /bin/sh -c "glance-manage db_sync" glance</userinput></screen>
|
|
</step>
|
|
<step os="rhel;centos;fedora;opensuse;sles;ubuntu">
|
|
<para>Create a <literal>glance</literal> user that the Image
|
|
Service can use to authenticate with the Identity service.
|
|
Choose a password and specify an email address for the
|
|
<literal>glance</literal> user. Use the
|
|
<literal>service</literal> tenant and give the user the
|
|
<literal>admin</literal> role:</para>
|
|
<screen><prompt>$</prompt> <userinput>keystone user-create --name=glance --pass=<replaceable>GLANCE_PASS</replaceable> \
|
|
--email=<replaceable>glance@example.com</replaceable></userinput>
|
|
<prompt>$</prompt> <userinput>keystone user-role-add --user=glance --tenant=service --role=admin</userinput></screen>
|
|
</step>
|
|
<step os="rhel;centos;fedora;sles;opensuse;ubuntu">
|
|
<para>Configure the Image Service to use the Identity
|
|
Service for authentication.</para>
|
|
<para os="rhel;centos;fedora;sles;opensuse">Run the following commands
|
|
and replace <replaceable>GLANCE_PASS</replaceable> with the password
|
|
you chose for the <literal>glance</literal> user in the Identity
|
|
Service:</para>
|
|
<screen os="rhel;centos;fedora;sles;opensuse"><prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-api.conf keystone_authtoken \
|
|
auth_uri http://<replaceable>controller</replaceable>:5000</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-api.conf keystone_authtoken \
|
|
auth_host <replaceable>controller</replaceable></userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-api.conf keystone_authtoken \
|
|
auth_port 35357</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-api.conf keystone_authtoken \
|
|
auth_protocol http</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-api.conf keystone_authtoken \
|
|
admin_tenant_name service</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-api.conf keystone_authtoken \
|
|
admin_user glance</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-api.conf keystone_authtoken \
|
|
admin_password <replaceable>GLANCE_PASS</replaceable></userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-api.conf paste_deploy \
|
|
flavor keystone</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-registry.conf keystone_authtoken \
|
|
auth_uri http://<replaceable>controller</replaceable>:5000</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-registry.conf keystone_authtoken \
|
|
auth_host <replaceable>controller</replaceable></userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-registry.conf keystone_authtoken \
|
|
auth_port 35357</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-registry.conf keystone_authtoken \
|
|
auth_protocol http</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-registry.conf keystone_authtoken \
|
|
admin_tenant_name service</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-registry.conf keystone_authtoken \
|
|
admin_user glance</userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-registry.conf keystone_authtoken \
|
|
admin_password <replaceable>GLANCE_PASS</replaceable></userinput>
|
|
<prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-registry.conf paste_deploy \
|
|
flavor keystone</userinput></screen>
|
|
<para os="ubuntu">Edit the
|
|
<filename>/etc/glance/glance-api.conf</filename> and
|
|
<filename>/etc/glance/glance-registry.conf</filename> files. Replace
|
|
<replaceable>GLANCE_PASS</replaceable> with the password you chose
|
|
for the <literal>glance</literal> user in the Identity service.</para>
|
|
<substeps os="ubuntu">
|
|
<step>
|
|
<para>Add or modify the following keys under the
|
|
<literal>[keystone_authtoken]</literal> section:</para>
|
|
<programlisting language="ini">[keystone_authtoken]
|
|
auth_uri = http://<replaceable>controller</replaceable>:5000
|
|
auth_host = <replaceable>controller</replaceable>
|
|
auth_port = 35357
|
|
auth_protocol = http
|
|
admin_tenant_name = service
|
|
admin_user = glance
|
|
admin_password = <replaceable>GLANCE_PASS</replaceable></programlisting>
|
|
</step>
|
|
<step>
|
|
<para>Modify the following key under the
|
|
<literal>[paste_deploy]</literal> section:</para>
|
|
<programlisting language="ini">[paste_deploy]
|
|
...
|
|
flavor = keystone</programlisting>
|
|
</step>
|
|
</substeps>
|
|
</step>
|
|
<step os="rhel;centos;fedora;opensuse;sles;ubuntu">
|
|
<para>Register the Image Service with the Identity service so
|
|
that other OpenStack services can locate it. Register the
|
|
service and create the endpoint:</para>
|
|
<screen><prompt>$</prompt> <userinput>keystone service-create --name=glance --type=image \
|
|
--description="OpenStack Image Service"</userinput>
|
|
<prompt>$</prompt> <userinput>keystone endpoint-create \
|
|
--service-id=$(keystone service-list | awk '/ image / {print $2}') \
|
|
--publicurl=http://<replaceable>controller</replaceable>:9292 \
|
|
--internalurl=http://<replaceable>controller</replaceable>:9292 \
|
|
--adminurl=http://<replaceable>controller</replaceable>:9292</userinput></screen>
|
|
</step>
|
|
<step os="ubuntu;debian">
|
|
<para>Restart the <systemitem class="service">glance</systemitem>
|
|
service with its new settings:</para>
|
|
<screen><prompt>#</prompt> <userinput>service glance-registry restart</userinput>
|
|
<prompt>#</prompt> <userinput>service glance-api restart</userinput></screen>
|
|
</step>
|
|
<step os="rhel;fedora;centos;opensuse;sles">
|
|
<para>Start the <systemitem class="service"
|
|
>glance-api</systemitem> and <systemitem class="service"
|
|
>glance-registry</systemitem> services and configure them to
|
|
start when the system boots:</para>
|
|
<screen os="rhel;fedora;centos;opensuse;sles"><prompt>#</prompt> <userinput>service openstack-glance-api start</userinput>
|
|
<prompt>#</prompt> <userinput>service openstack-glance-registry start</userinput>
|
|
<prompt>#</prompt> <userinput>chkconfig openstack-glance-api on</userinput>
|
|
<prompt>#</prompt> <userinput>chkconfig openstack-glance-registry on</userinput></screen>
|
|
</step>
|
|
</procedure>
|
|
</section>
|