c9728d9539
This patch adds a new debconf chapter in the Debian docs. It describe generalities about the Debconf OpenStack. It explains how the following is handled: - Database config (using dbconfig-common) - RabbitMQ config - API endpoint registrations - keystone_authtoken config - preseeding Also, a number of screenshots are added. Note that this is a break-down of: https://review.openstack.org/54394/ into smaller patches. backport: havana Change-Id: Ia5d8e5fc3d397f9441ecb50ef4a3458672307bdc
67 lines
2.5 KiB
XML
67 lines
2.5 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<section xml:id="debconf-keystone_authtoken"
|
|
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">
|
|
<title>Services and 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>
|
|
<mediaobject>
|
|
<imageobject>
|
|
<imagedata scale="50"
|
|
fileref="figures/debconf-screenshots/service_keystone_authtoken_server_hostname.png"
|
|
/>
|
|
</imageobject>
|
|
</mediaobject>
|
|
<mediaobject>
|
|
<imageobject>
|
|
<imagedata scale="50"
|
|
fileref="figures/debconf-screenshots/service_keystone_authtoken_admin_tenant_name.png"
|
|
/>
|
|
</imageobject>
|
|
</mediaobject>
|
|
<mediaobject>
|
|
<imageobject>
|
|
<imagedata scale="50"
|
|
fileref="figures/debconf-screenshots/service_keystone_authtoken_tenant_admin_user.png"
|
|
/>
|
|
</imageobject>
|
|
</mediaobject>
|
|
<mediaobject>
|
|
<imageobject>
|
|
<imagedata scale="50"
|
|
fileref="figures/debconf-screenshots/service_keystone_authtoken_admin_password.png"
|
|
/>
|
|
</imageobject>
|
|
</mediaobject>
|
|
<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>
|