From 1e6012e8105fafd1c5e6ad3bf7a4f860e2a91eb8 Mon Sep 17 00:00:00 2001
From: Summer Long <slong@redhat.com>
Date: Thu, 27 Feb 2014 13:13:25 +1000
Subject: [PATCH] Added sample files for Networking

Added neutron.conf, api-paste.ini, policy.json, rootwrap.conf,
and plug-in agent configuration sample files (referenced files
in neutron project). Placed under new section.

Change-Id: Iddba3b20c720dfdcbd37ce14ab9d1c70a9045dcf
Closes-Bug: #1281348
---
 .../ch_networkingconfigure.xml                |  1 +
 ..._networking-sample-configuration-files.xml | 68 +++++++++++++++++++
 2 files changed, 69 insertions(+)
 create mode 100644 doc/config-reference/networking/section_networking-sample-configuration-files.xml

diff --git a/doc/config-reference/ch_networkingconfigure.xml b/doc/config-reference/ch_networkingconfigure.xml
index 942c2dd4a5..bebdf93ad7 100644
--- a/doc/config-reference/ch_networkingconfigure.xml
+++ b/doc/config-reference/ch_networkingconfigure.xml
@@ -16,4 +16,5 @@
                 Administrator Guide</link></citetitle>.</para>
     <xi:include href="networking/section_networking-options-reference.xml"/>
     <xi:include href="networking/section_networking-log-files.xml"/>
+    <xi:include href="networking/section_networking-sample-configuration-files.xml"/>
 </chapter>
diff --git a/doc/config-reference/networking/section_networking-sample-configuration-files.xml b/doc/config-reference/networking/section_networking-sample-configuration-files.xml
new file mode 100644
index 0000000000..3a6ea601b4
--- /dev/null
+++ b/doc/config-reference/networking/section_networking-sample-configuration-files.xml
@@ -0,0 +1,68 @@
+<?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="block-storage-sample-configuration-files">
+    <title>Networking sample configuration files</title>
+    <para>All the files in this section can be found in <filename class="directory">/etc/neutron/</filename>.</para>
+    <section xml:id="section_neutron.conf">
+        <title>neutron.conf</title>
+        <para>Use the <filename>neutron.conf</filename> file to configure the
+            majority of the OpenStack Networking options.</para>
+        <programlisting language="ini">
+            <xi:include parse="text" href="http://git.openstack.org/cgit/openstack/neutron/plain/etc/neutron.conf"/>
+        </programlisting>
+    </section>
+    <section xml:id="section_neutron-api-paste.ini">
+        <title>api-paste.ini</title>
+        <para>Use the <filename>api-paste.ini</filename> to configure the OpenStack Networking API.</para>
+        <programlisting language="ini">
+            <xi:include parse="text" href="http://git.openstack.org/cgit/openstack/neutron/plain/etc/api-paste.ini"/>
+        </programlisting>
+    </section>
+    <section xml:id="section_neutron-policy.json">
+        <title>policy.json</title>
+        <para>Use the <filename>policy.json</filename> file to define additional access controls
+            that apply to the OpenStack Networking service.</para>
+        <programlisting language="json">
+            <xi:include parse="text" href="http://git.openstack.org/cgit/openstack/neutron/plain/etc/policy.json"/>
+        </programlisting>
+    </section>
+    <section xml:id="section_neutron-rootwrap.conf">
+        <title>rootwrap.conf</title>
+        <para>Use the <filename>rootwrap.conf</filename> file to define configuration values used by the
+            <command>rootwrap</command> script when the OpenStack Networking service must escalate its
+            privileges to those of the root user.</para>
+        <programlisting language="ini">
+            <xi:include parse="text" href="http://git.openstack.org/cgit/openstack/neutron/plain/etc/rootwrap.conf"/>
+        </programlisting>
+    </section>
+    <section xml:id="section_plugin-agent-conf">
+        <title>Configuration files for plug-in agents</title>
+        <para>Each plug-in agent that runs on an OpenStack Networking node,
+            to perform local networking configuration for the node's VMs and
+            networking services, has its own configuration file.</para>
+        <section xml:id="section_neutron-dhcp_agent.ini">
+            <title>dhcp_agent.ini</title>
+            <programlisting language="ini">
+                <xi:include parse="text" href="http://git.openstack.org/cgit/openstack/neutron/plain/etc/dhcp_agent.ini"/>
+            </programlisting>
+        </section>
+        <section xml:id="section_neutron-l3_agent.ini.conf">
+            <title>l3_agent.ini</title>
+            <programlisting language="ini">
+                <xi:include parse="text" href="http://git.openstack.org/cgit/openstack/neutron/plain/etc/l3_agent.ini"/>
+            </programlisting>
+        </section>
+        <section xml:id="section_neutron-lbaas_agent.ini">
+            <title>lbaas_agent.ini</title>
+            <programlisting language="ini">
+                <xi:include parse="text" href="http://git.openstack.org/cgit/openstack/neutron/plain/etc/lbaas_agent.ini"/>
+            </programlisting>
+        </section>
+        <section xml:id="section_neutron-metadata_agent.ini">
+            <title>metadata_agent.ini</title>
+            <programlisting language="ini">
+                <xi:include parse="text" href="http://git.openstack.org/cgit/openstack/neutron/plain/etc/metadata_agent.ini"/>
+            </programlisting>
+        </section>
+    </section>
+</section>