openstack-manuals/doc/install-guide/section_glance-install.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>Installing the Image Service</title>
  <para>The Image service acts as a registry for virtual disk images. Users can add new images
  or take a snapshot (copy) of an existing server for immediate storage. Snapshots can be
  used as back up or as templates for new servers. Registered images can be stored in the
  Object Storage service, as well as in other locations (for example, in simple file
  systems or external web servers).</para>
  <note>
    <para>Steps in this procedure assume you have the appropriate environment
      variables set to specify your credentials, as described in
      <xref linkend="keystone-verify"/>.</para>
  </note>
  <procedure>
    <title>Install the Image Service</title>
    <step><para>Install the Image Service on the controller node.</para>
      <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install glance</userinput></screen>
      <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install openstack-glance</userinput></screen>
      <screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install openstack-glance python-glanceclient</userinput></screen></step>

    <step os="debian"><para>Answer to the <systemitem class="library">debconf</systemitem> prompts to setup the
    database, register the Image service into the Identity service
    catalogue (API endpoint), configure the <code>keystone_authtoken</code>,
    and the RabbitMQ credentials. You will also have to select the type
    of caching as per the screenshot below:
        <mediaobject>
          <imageobject>
            <imagedata scale="50" fileref="figures/debconf-screenshots/glance-common_pipeline_flavor.png"/>
          </imageobject>
        </mediaobject>
    </para></step>
    <step os="rhel;centos;fedora;opensuse;sles;ubuntu"><para>The Image
        Service stores information about images in a database.  This
        guide uses the MySQL database that is used by other OpenStack
        services.</para>
        <para>Specify the location of the database in the
        configuration files. The Image Service provides two OpenStack
        services: <literal>glance-api</literal> and
        <literal>glance-registry</literal>. They each have separate
        configuration files, so you must configure both files
        throughout this section.  Replace
      <literal><replaceable>GLANCE_DBPASS</replaceable></literal> with an
      Image Service database password of your choosing.</para>
      <screen os="rhel;centos;fedora;opensuse;sles"><prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-api.conf \
   DEFAULT sql_connection mysql://glance:<replaceable>GLANCE_DBPASS</replaceable>@<replaceable>controller</replaceable>/glance</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/glance/glance-registry.conf \
   DEFAULT sql_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 change the <literal>[DEFAULT]</literal> section.</para>
      <programlisting os="ubuntu;debian" language="ini">
...
[DEFAULT]
...
# SQLAlchemy connection string for the reference implementation
# registry server. Any valid SQLAlchemy connection string is fine.
# See: http://www.sqlalchemy.org/docs/05/reference/sqlalchemy/connections.html#sqlalchemy.create_engine
sql_connection = mysql://glance:GLANCE_DBPASS@localhost/glance
...
      </programlisting>
</step>

    <step os="rhel;centos;fedora;opensuse;sles">
      <para>Use the <command>openstack-db</command> command to create the
      database and tables for the Image Service, as well as a database user
      called <literal>glance</literal> to connect to the database.</para>
      <screen><prompt>#</prompt> <userinput>openstack-db --init --service glance --password <replaceable>GLANCE_DBPASS</replaceable></userinput></screen></step>

    <step os="ubuntu">
    <para>The Ubuntu packages create an sqlite database by
        default. Delete the <filename>glance.sqlite</filename> file created in
        the <filename>/var/lib/glance/</filename> directory so it is not used by mistake.</para>
      <para>First, we need to create a database user called <literal>glance</literal>, by logging in
      as root using the password we set earlier.</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">
      <para>We now create the database tables for the Image service.</para>
      <screen><prompt>#</prompt> <userinput>glance-manage db_sync</userinput></screen>
    </step>

    <step os="rhel;centos;fedora;opensuse;sles;ubuntu"><para>Create a user called <literal>glance</literal> that the Image
      Service can use to authenticate with the Identity Service. Choose a
      password for the <literal>glance</literal> user and specify an email
      address for the account. 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;opensuse;sles;ubuntu"><para>Add the credentials to the Image Service's configuration files.</para>

      <screen os="centos;rhel;fedora;opensuse;sles"><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 \
   admin_user glance</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_password <replaceable>GLANCE_PASS</replaceable></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 admin_user glance</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_password <replaceable>GLANCE_PASS</replaceable></userinput></screen>
      <para os="ubuntu">Edit <filename>/etc/glance/glance-api.conf</filename> and <filename>/etc/glance/glance-registry.conf</filename>
 and change the <literal>[keystone_authtoken]</literal> section.</para>
      <programlisting os="ubuntu" language="ini">
...
[keystone_authtoken]
auth_host = controller
auth_port = 35357
auth_protocol = http
admin_tenant_name = service
admin_user = glance
admin_password = GLANCE_PASS
...
      </programlisting>
      <para>
        <note><para>If you have troubles connecting to the database, try using the IP address instead of the
          host name in the credentials.</para></note>
      </para>
</step>
<step os="rhel;centos;fedora;opensuse;sles;ubuntu">
      <para>You also have to add the credentials to the files
  <filename>/etc/glance/glance-api-paste.ini</filename> and
  <filename>/etc/glance/glance-registry-paste.ini</filename>.</para>
  <para os="centos">On CentOS, these files are not created correctly by
  the package installation. Copy the files to the correct location:</para>
<screen os="centos">
<prompt>#</prompt> <userinput>cp /usr/share/glance/glance-api-dist-paste.ini /etc/glance/glance-api-paste.ini</userinput>
<prompt>#</prompt> <userinput>cp /usr/share/glance/glance-registry-dist-paste.ini /etc/glance/glance-registry-paste.ini</userinput>
</screen>

  <para>Open each file
  in a text editor and locate the section <literal>[filter:authtoken]</literal>.
  Make sure the following options are set:</para>
  <programlisting language="ini">[filter:authtoken]
paste.filter_factory=keystoneclient.middleware.auth_token:filter_factory
auth_host=controller
admin_user=glance
admin_tenant_name=service
admin_password=<replaceable>GLANCE_PASS</replaceable></programlisting>
</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
      specify the endpoint using the <command>keystone</command> command.</para>
      <screen><prompt>#</prompt> <userinput>keystone service-create --name=glance --type=image \
  --description="Glance Image Service"</userinput></screen></step>
    <step os="rhel;centos;fedora;opensuse;sles;ubuntu"><para>Note the service's <literal>id</literal> property returned in the previous step and use it when
      creating the endpoint.</para>
      <screen><prompt>#</prompt> <userinput>keystone endpoint-create \
  --service-id=<replaceable>the_service_id_above</replaceable> \
  --publicurl=http://<replaceable>controller</replaceable>:9292 \
  --internalurl=http://<replaceable>controller</replaceable>:9292 \
  --adminurl=http://<replaceable>controller</replaceable>:9292</userinput></screen></step>

    <step os="ubuntu">
      <para>We now restart the glance 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 <literal>glance-api</literal> and
      <literal>glance-registry</literal> 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>