openstack-manuals/doc/config-reference/ch_objectstorageconfigure.xml
Gauvain Pocentek 914b80c712 Use sample files from the kilo branch
We import several sample configuration files for the git repositories.
Use the stable/kilo branches now that they exist.

Update the ceilometer sample and import a complete cinder sample (not
provided in the git tree anymore)

Remove the lbaas_agent.ini link. The whole lbaas configuration has
changed and must be updated.

Change-Id: I7c9da1e31aa9c696318bc31d589376f114e2351f
2015-04-29 06:48:47 +02:00

248 lines
13 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<chapter 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="ch_configuring-object-storage">
<title>Object Storage</title>
<para>OpenStack Object Storage uses multiple configuration files
for multiple services and background daemons, and
<command>paste.deploy</command> to manage server
configurations. Default configuration options appear in the
<code>[DEFAULT]</code> section. You can override the default values
by setting values in the other sections.</para>
<xi:include href="../common/section_about-object-storage.xml"/>
<xi:include
href="object-storage/section_object-storage-general-service-conf.xml"/>
<section xml:id="object-server-configuration">
<title>Object server configuration</title>
<para>Find an example object server configuration at
<filename>etc/object-server.conf-sample</filename> in the source code
repository.</para>
<para>The available configuration options are:</para>
<xi:include
href="../common/tables/swift-object-server-DEFAULT.xml"/>
<xi:include
href="../common/tables/swift-object-server-app-object-server.xml"/>
<xi:include
href="../common/tables/swift-object-server-pipeline-main.xml"/>
<xi:include
href="../common/tables/swift-object-server-object-replicator.xml"/>
<xi:include
href="../common/tables/swift-object-server-object-updater.xml"/>
<xi:include
href="../common/tables/swift-object-server-object-auditor.xml"/>
<xi:include
href="../common/tables/swift-object-server-filter-healthcheck.xml"/>
<xi:include
href="../common/tables/swift-object-server-filter-recon.xml"/>
<xi:include
href="../common/tables/swift-object-server-filter-xprofile.xml"/>
<section xml:id="object-server-conf">
<title>Sample object server configuration file</title>
<programlisting language="ini"><xi:include parse="text" href="https://git.openstack.org/cgit/openstack/swift/plain/etc/object-server.conf-sample?h=stable/kilo"/></programlisting>
</section>
</section>
<section xml:id="object-expirer-configuration">
<title>Object expirer configuration</title>
<para>Find an example object expirer configuration at
<filename>etc/object-expirer.conf-sample</filename> in the source code
repository.</para>
<para>The available configuration options are:</para>
<xi:include
href="../common/tables/swift-object-expirer-DEFAULT.xml"/>
<xi:include
href="../common/tables/swift-object-expirer-app-proxy-server.xml"/>
<xi:include
href="../common/tables/swift-object-expirer-filter-cache.xml"/>
<xi:include
href="../common/tables/swift-object-expirer-filter-catch_errors.xml"/>
<xi:include
href="../common/tables/swift-object-expirer-filter-proxy-logging.xml"/>
<xi:include
href="../common/tables/swift-object-expirer-object-expirer.xml"/>
<xi:include
href="../common/tables/swift-object-expirer-pipeline-main.xml"/>
<section xml:id="object-expirer-conf">
<title>Sample object expirer configuration file</title>
<programlisting language="ini"><xi:include parse="text" href="https://git.openstack.org/cgit/openstack/swift/plain/etc/object-expirer.conf-sample?h=stable/kilo"/></programlisting>
</section>
</section>
<section xml:id="container-server-configuration">
<title>Container server configuration</title>
<para>Find an example container server configuration at
<filename>etc/container-server.conf-sample</filename>
in the source code repository.</para>
<para>The available configuration options are:</para>
<xi:include
href="../common/tables/swift-container-server-DEFAULT.xml"/>
<xi:include
href="../common/tables/swift-container-server-app-container-server.xml"/>
<xi:include
href="../common/tables/swift-container-server-pipeline-main.xml"/>
<xi:include
href="../common/tables/swift-container-server-container-replicator.xml"/>
<xi:include
href="../common/tables/swift-container-server-container-updater.xml"/>
<xi:include
href="../common/tables/swift-container-server-container-auditor.xml"/>
<xi:include
href="../common/tables/swift-container-server-container-sync.xml"/>
<xi:include
href="../common/tables/swift-container-server-filter-healthcheck.xml"/>
<xi:include
href="../common/tables/swift-container-server-filter-recon.xml"/>
<xi:include
href="../common/tables/swift-container-server-filter-xprofile.xml"/>
<section xml:id="container-server-conf">
<title>Sample container server configuration file</title>
<programlisting language="ini"><xi:include parse="text" href="https://git.openstack.org/cgit/openstack/swift/plain/etc/container-server.conf-sample?h=stable/kilo"/></programlisting>
</section>
</section>
<section xml:id="container-sync-realms-configuration">
<title>Container sync realms configuration</title>
<para>Find an example container sync realms configuration at
<filename>etc/container-sync-realms.conf-sample</filename>
in the source code repository.</para>
<para>The available configuration options are:</para>
<xi:include
href="../common/tables/swift-container-sync-realms-DEFAULT.xml"/>
<xi:include
href="../common/tables/swift-container-sync-realms-realm1.xml"/>
<xi:include
href="../common/tables/swift-container-sync-realms-realm2.xml"/>
<section xml:id="container-sync-realms-conf">
<title>Sample container sync realms configuration file</title>
<programlisting language="ini"><xi:include parse="text" href="https://git.openstack.org/cgit/openstack/swift/plain/etc/container-sync-realms.conf-sample?h=stable/kilo"/></programlisting>
</section>
</section>
<section xml:id="container-reconciler-configuration">
<title>Container reconciler configuration</title>
<para>Find an example container sync realms configuration at
<filename>etc/container-reconciler.conf-sample</filename>
in the source code repository.</para>
<para>The available configuration options are:</para>
<xi:include
href="../common/tables/swift-container-reconciler-DEFAULT.xml"/>
<xi:include
href="../common/tables/swift-container-reconciler-app-proxy-server.xml"/>
<xi:include
href="../common/tables/swift-container-reconciler-container-reconciler.xml"/>
<xi:include
href="../common/tables/swift-container-reconciler-filter-cache.xml"/>
<xi:include
href="../common/tables/swift-container-reconciler-filter-catch_errors.xml"/>
<xi:include
href="../common/tables/swift-container-reconciler-filter-proxy-logging.xml"/>
<xi:include
href="../common/tables/swift-container-reconciler-pipeline-main.xml"/>
<section xml:id="container-reconciler-conf">
<title>Sample container sync reconciler configuration file</title>
<programlisting language="ini"><xi:include parse="text" href="https://git.openstack.org/cgit/openstack/swift/plain/etc/container-reconciler.conf-sample?h=stable/kilo"/></programlisting>
</section>
</section>
<section xml:id="account-server-configuration">
<title>Account server configuration</title>
<para>Find an example account server configuration at
<filename>etc/account-server.conf-sample</filename> in
the source code repository.</para>
<para>The available configuration options are:</para>
<xi:include
href="../common/tables/swift-account-server-DEFAULT.xml"/>
<xi:include
href="../common/tables/swift-account-server-app-account-server.xml"/>
<xi:include
href="../common/tables/swift-account-server-pipeline-main.xml"/>
<xi:include
href="../common/tables/swift-account-server-account-replicator.xml"/>
<xi:include
href="../common/tables/swift-account-server-account-auditor.xml"/>
<xi:include
href="../common/tables/swift-account-server-account-reaper.xml"/>
<xi:include
href="../common/tables/swift-account-server-filter-healthcheck.xml"/>
<xi:include
href="../common/tables/swift-account-server-filter-recon.xml"/>
<xi:include
href="../common/tables/swift-account-server-filter-xprofile.xml"/>
<section xml:id="account-server-conf">
<title>Sample account server configuration file</title>
<programlisting language="ini"><xi:include parse="text" href="https://git.openstack.org/cgit/openstack/swift/plain/etc/account-server.conf-sample?h=stable/kilo"/></programlisting>
</section>
</section>
<section xml:id="proxy-server-configuration">
<title>Proxy server configuration</title>
<para>Find an example proxy server configuration at
<filename>etc/proxy-server.conf-sample</filename> in
the source code repository.</para>
<para>The available configuration options are:</para>
<xi:include
href="../common/tables/swift-proxy-server-DEFAULT.xml"/>
<xi:include
href="../common/tables/swift-proxy-server-app-proxy-server.xml"/>
<xi:include
href="../common/tables/swift-proxy-server-pipeline-main.xml"/>
<xi:include
href="../common/tables/swift-proxy-server-filter-account-quotas.xml"/>
<xi:include
href="../common/tables/swift-proxy-server-filter-authtoken.xml"/>
<xi:include
href="../common/tables/swift-proxy-server-filter-cache.xml"/>
<xi:include
href="../common/tables/swift-proxy-server-filter-catch_errors.xml"/>
<xi:include
href="../common/tables/swift-proxy-server-filter-container_sync.xml"/>
<xi:include
href="../common/tables/swift-proxy-server-filter-dlo.xml"/>
<xi:include
href="../common/tables/swift-proxy-server-filter-gatekeeper.xml"/>
<xi:include
href="../common/tables/swift-proxy-server-filter-healthcheck.xml"/>
<xi:include
href="../common/tables/swift-proxy-server-filter-keystoneauth.xml"/>
<xi:include
href="../common/tables/swift-proxy-server-filter-list-endpoints.xml"/>
<xi:include
href="../common/tables/swift-proxy-server-filter-proxy-logging.xml"/>
<xi:include
href="../common/tables/swift-proxy-server-filter-tempauth.xml"/>
<xi:include
href="../common/tables/swift-proxy-server-filter-xprofile.xml"/>
<section xml:id="proxy-server-conf">
<title>Sample proxy server configuration file</title>
<programlisting language="ini"><xi:include parse="text" href="https://git.openstack.org/cgit/openstack/swift/plain/etc/proxy-server.conf-sample?h=stable/kilo"/></programlisting>
</section>
</section>
<section xml:id="swift-memcache-configuration">
<title>Proxy server memcache configuration</title>
<para>Find an example memcache configuration for the proxy server at
<filename>etc/memcache.conf-sample</filename>
in the source code repository.</para>
<para>The available configuration options are:</para>
<xi:include
href="../common/tables/swift-memcache-memcache.xml"/>
</section>
<section xml:id="rsyncd-configuration">
<title>Rsyncd configuration</title>
<para>Find an example rsyncd configuration at
<filename>etc/rsyncd.conf-sample</filename>
in the source code repository.</para>
<para>The available configuration options are:</para>
<xi:include
href="../common/tables/swift-rsyncd-account.xml"/>
<xi:include
href="../common/tables/swift-rsyncd-container.xml"/>
<xi:include
href="../common/tables/swift-rsyncd-object.xml"/>
</section>
<!-- section on Object Storage Features -->
<xi:include
href="object-storage/section_object-storage-features.xml"/>
<xi:include href="../common/tables/swift-conf-changes.xml"/>
</chapter>