openstack-manuals/doc/install-guide/section_debconf-keystone_authtoken.xml
Christian Berendt a2d662d600 Unified the syntax of the XML root element (install-guide)
The XML root element of Docbook XML files should match the following
format:

<ELEMENT 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="THE_XML_ID_OF_THE_ELEMENT">

Change-Id: I1e0804e2c5021bd78b77483f3156c5b069453555
2014-07-09 22:19:31 +02:00

68 lines
2.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="debconf-keystone_authtoken">
<title>Services and the [keystone_authtoken]</title>
<para>Because most OpenStack services must access the Identity
Service, you must configure the IP address of the
<code>keystone</code> server to be able to access it. You must
also configure the <code>admin_tenant_name</code>,
<code>admin_user</code>, and <code>admin_password</code> options
for each service to work.</para>
<para>Generally, this section looks like this:</para>
<programlisting language="ini">[keystone_authtoken]
auth_host = 127.0.0.1
auth_port = 35357
auth_protocol = http
admin_tenant_name = %SERVICE_TENANT_NAME%
admin_user = %SERVICE_USER%
admin_password = %SERVICE_PASSWORD%</programlisting>
<para>The debconf system helps users configure the
<code>auth_host</code>, <code>admin_tenant_name</code>,
<code>admin_user</code> and <code>admin_password</code>
options.</para>
<para>The following screens show an example Image Service
configuration:</para>
<informalfigure>
<mediaobject>
<imageobject>
<imagedata scale="50" fileref="figures/debconf-screenshots/service_keystone_authtoken_server_hostname.png"/>
</imageobject>
</mediaobject>
</informalfigure>
<informalfigure>
<mediaobject>
<imageobject>
<imagedata scale="50" fileref="figures/debconf-screenshots/service_keystone_authtoken_admin_tenant_name.png"/>
</imageobject>
</mediaobject>
</informalfigure>
<informalfigure>
<mediaobject>
<imageobject>
<imagedata scale="50" fileref="figures/debconf-screenshots/service_keystone_authtoken_tenant_admin_user.png"/>
</imageobject>
</mediaobject>
</informalfigure>
<informalfigure>
<mediaobject>
<imageobject>
<imagedata scale="50" fileref="figures/debconf-screenshots/service_keystone_authtoken_admin_password.png"/>
</imageobject>
</mediaobject>
</informalfigure>
<para>This information is stored in the configuration file for each
service. For example:</para>
<programlisting os="ubuntu;debian" language="ini">/etc/ceilometer/ceilometer.conf
/etc/nova/api-paste.ini
/etc/glance/glance-api-paste.ini
/etc/glance/glance-registry.ini
/etc/cinder/cinder.conf
/etc/neutron/neutron.conf</programlisting>
<para>The Debian OpenStack packages offer automation for this, so
OpenStack users do not have to manually edit the configuration
files.</para>
</section>