openstack-manuals/doc/install-guide/ap_configuration_files.xml

<?xml version="1.0" encoding="UTF-8"?>
<appendix xml:id="conf-files" 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>Configuration File Examples</title>
    <section xml:id="keystone-conf-file">
        <title>keystone.conf</title>
        <para>The configuration file for the Identity Service is
                <filename class="directory"
                >/etc/keystone/keystone.conf</filename>.</para>
        <para>After you install the Identity Service, modify this file
            to use SQL for endpoint data and to replace the ADMIN key
            with the one created that was created during the
            installation.</para>

        <literallayout class="monospaced"><xi:include parse="text" href="../common/samples/keystone.conf"/></literallayout>
    </section>
    <section xml:id="keystone-paste-file">
        <title>keystone-paste.ini</title>
        <para>The Identity Service middleware pipeline configuration file is
        <filename
        class="directory">/etc/keystone/keystone-paste.ini</filename>.</para>
        <para>You should not need to modify this file.</para>

        <literallayout class="monospaced"><xi:include parse="text" href="samples/keystone-paste.ini"/></literallayout>
    </section>
    <section xml:id="glance-registry-conf-file">
        <title>glance-registry.conf</title>
        <para>The Image Service registry configuration file is
                <filename>/etc/glance/glance-registry.conf</filename>.</para>
        <para>This file stores metadata for images.</para>
        <para>After you install the Image Service, modify this
            configuration file.</para>

        <literallayout class="monospaced"><xi:include parse="text" href="samples/glance-registry.conf"/></literallayout>
    </section>
    <section xml:id="glance-registry-paste-file">
        <title>glance-registry-paste.ini</title>
        <para>The Image Service API middleware pipeline configuration
            file is <filename>/etc/glance/glance-registry-paste.ini</filename>.</para>
        <para>After you install the Image Service, modify this
            configuration file.</para>

        <literallayout class="monospaced"><xi:include parse="text" href="samples/glance-registry-paste.ini"/></literallayout>
    </section>

    <section xml:id="glance-api-conf-file">
        <title>glance-api.conf</title>
        <para>The configuration file for the Image API is <filename>/etc/glance/glance-api.conf</filename>.</para>
        <para>After you install the Image Service API, update this
            file as shown in the following example.</para>
        <literallayout class="monospaced"><xi:include parse="text" href="samples/glance-api.conf"/></literallayout>
    </section>

    <section xml:id="glance-api-paste-file">
        <title>glance-api-paste.ini</title>
        <para>The Image Service API middleware pipeline configuration
            file is <filename>/etc/glance/glance-api-paste.ini</filename>.</para>
        <para>You should not need to modify this file.</para>

        <literallayout class="monospaced"><xi:include parse="text" href="samples/glance-api-paste.ini"/></literallayout>
    </section>

    <section xml:id="glance-scrubber-conf-file">
        <title>glance-scrubber.conf</title>
        <para>An additional configuration file for the Image Service
            is <filename class="directory"
                >/etc/glance/glance-scrubber.conf</filename>.</para>
        <para>The scrubber is a utility that cleans up images that
            have been deleted.</para>
        <literallayout class="monospaced"><xi:include parse="text" href="samples/glance-scrubber.conf"/></literallayout>
    </section>

    <section xml:id="nova-conf-file">
        <title>nova.conf</title>
        <para>The Compute configuration file is <filename
                class="directory">/etc/nova/nova.conf</filename>.</para>
        <para>For a list of configuration options for this file, see
            the List of Tables on this page: <link
                xlink:href="http://docs.openstack.org/trunk/config-reference/content/"
                    ><citetitle>OpenStack Configuration Reference</citetitle></link>.</para>
        <para>This guide assumes that the IP address of the machine
            that runs the Identity Service is
                <literal>192.168.206.130</literal>. If the IP address
            of the machine on your setup is different, change the
            following configuration options:<itemizedlist>
                <listitem>
                    <para><literal>service_host</literal></para>
                </listitem>
                <listitem>
                    <para><literal>auth_host</literal></para>
                </listitem>
                <listitem>
                    <para><literal>auth_uri</literal></para>
                </listitem>
            </itemizedlist></para>

        <literallayout os="ubuntu;opensuse" class="monospaced"><xi:include parse="text" href="../common/samples/nova.conf"/></literallayout>
        <literallayout os="rhel;centos;fedora" class="monospaced"><xi:include parse="text" href="../common/samples/nova.conf-yum"/></literallayout>
    </section>
    <section xml:id="api-paste-ini-file">
        <title>api-paste.ini</title>
        <para>The middleware configuration file used by the EC2 API
            and OpenStack Compute API is <filename class="directory"
                >/etc/nova/api-paste.ini</filename>.</para>
        <para>You should not need to edit it.</para>
        <literallayout class="monospaced">  <xi:include parse="text" href="samples/api-paste.ini"/></literallayout>
    </section>
    <section xml:id="novarc-file">
        <title>Credentials (openrc)</title>
        <para>This file contains the credentials used by Compute,
            Image, and Identity services. You can optionally store
            this file in<filename class="directory">
                /home/openrc</filename>.</para>
        <para>Do not source this file in the environment from where
            you issue commands.</para>
        <para>Run "env | grep OS_" or "env | grep NOVA_" to view what
            is being used in your environment.</para>
        <literallayout class="monospaced"><xi:include parse="text" href="samples/openrc.txt"/></literallayout>
    </section>
    <section xml:id="cinder-conf">
        <title>cinder.conf</title>
        <literallayout><xi:include parse="text" href="../common/samples/cinder.conf"/></literallayout>
    </section>
    <section xml:id="local-settings-py-file">
        <title>Dashboard configuration</title>
        <para>This file contains the database and configuration
            settings for the OpenStack Dashboard.</para>
        <literallayout class="monospaced"><xi:include parse="text" href="../common/samples/local_settings.py"/></literallayout>
    </section>
    <section xml:id="swift-conf">
        <title>etc/swift/swift.conf</title>
        <para>This file contains the settings to randomize the hash
            for the ring for Object Storage, code-named swift.</para>
        <literallayout class="monospaced"><xi:include parse="text" href="samples/swift.conf.txt"/></literallayout>
    </section>
    <section xml:id="network-interfaces-conf">
        <title>etc/network/interfaces.conf</title>
        <para>These instructions are for using the FlatDHCP networking
            mode with a single network interface.</para>
        <literallayout class="monospaced"><xi:include parse="text" href="samples/network-interfaces.conf.txt"/></literallayout>
    </section>
    <section xml:id="swift-proxy-conf">
        <title>etc/swift/proxy-server.conf</title>
        <para>This file contains the settings for the Object Storage
            proxy server, which contains the Identity service
            settings.</para>
        <literallayout class="monospaced"><xi:include parse="text" href="samples/proxy-server.conf.txt"/></literallayout>
    </section>
    <section xml:id="account-server-conf">
        <title>etc/swift/account-server.conf</title>
        <literallayout class="monospaced"><xi:include parse="text" href="samples/account-server.conf.txt"/></literallayout>
    </section>
    <section xml:id="account-server-conf-1">
        <title>etc/swift/account-server/1.conf</title>
        <literallayout class="monospaced"><xi:include parse="text" href="samples/account-server-1.conf.txt"/></literallayout>
    </section>
    <section xml:id="container-server-conf">
        <title>etc/swift/container-server.conf</title>
        <literallayout class="monospaced"><xi:include parse="text" href="samples/container-server.conf.txt"/></literallayout>
    </section>
    <section xml:id="container-server-conf-1">
        <title>etc/swift/container-server/1.conf</title>
        <literallayout class="monospaced"><xi:include parse="text" href="samples/container-server-1.conf.txt"/></literallayout>
    </section>
    <section xml:id="object-server-conf">
        <title>etc/swift/object-server.conf</title>
        <literallayout class="monospaced"><xi:include parse="text" href="samples/object-server.conf.txt"/></literallayout>
    </section>
    <section xml:id="object-server-conf-1">
        <title>etc/swift/object-server/1.conf</title>
        <literallayout class="monospaced"><xi:include parse="text" href="samples/object-server-1.conf.txt"/></literallayout>
    </section>
</appendix>