From 040173c264d4e15a4cee58685fb2f9e257a3d4a0 Mon Sep 17 00:00:00 2001
From: Don Domingo <ddomingo@redhat.com>
Date: Thu, 27 Feb 2014 14:35:49 +1000
Subject: [PATCH] Add list of service log files used by neutron

This patch adds the list of log files used by Networking services.
It also includes the name of each service/interface that
corresponds to each log file.

Change-Id: Ic928ce6f66b14e0ee2f56f1a62f742f49d924a5c
Partial-Bug: #1282882
---
 .../ch_networkingconfigure.xml                |  1 +
 .../section_networking-log-files.xml          | 88 +++++++++++++++++++
 2 files changed, 89 insertions(+)
 create mode 100644 doc/config-reference/networking/section_networking-log-files.xml

diff --git a/doc/config-reference/ch_networkingconfigure.xml b/doc/config-reference/ch_networkingconfigure.xml
index d5d209e7f2..942c2dd4a5 100644
--- a/doc/config-reference/ch_networkingconfigure.xml
+++ b/doc/config-reference/ch_networkingconfigure.xml
@@ -15,4 +15,5 @@
                 xlink:href="http://docs.openstack.org/admin-guide-cloud/content/">Cloud
                 Administrator Guide</link></citetitle>.</para>
     <xi:include href="networking/section_networking-options-reference.xml"/>
+    <xi:include href="networking/section_networking-log-files.xml"/>
 </chapter>
diff --git a/doc/config-reference/networking/section_networking-log-files.xml b/doc/config-reference/networking/section_networking-log-files.xml
new file mode 100644
index 0000000000..da4c268329
--- /dev/null
+++ b/doc/config-reference/networking/section_networking-log-files.xml
@@ -0,0 +1,88 @@
+<?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="section_neutron-logs">
+    <title>Log files used by Networking</title>
+    <para>The corresponding log file of each Networking service is
+    stored in the <filename>/var/log/neutron/</filename> directory of
+    the host on which each service runs.</para>
+    <table rules="all">
+    <caption>Log files used by Networking services</caption>
+    <col width="50%"/>
+    <col width="50%"/>
+        <thead>
+        <tr>
+            <td>
+            Log file
+            </td>
+            <td>
+            Service/interface
+            </td>
+        </tr>
+        </thead>
+        <tbody>
+        <tr>
+            <td>
+            <filename>dhcp-agent.log</filename>
+            </td>
+            <td>
+            <systemitem class="service">neutron-dhcp-agent</systemitem>
+            </td>
+        </tr>
+        <tr>
+            <td>
+            <filename>l3-agent.log</filename>
+            </td>
+            <td>
+            <systemitem class="service">neutron-l3-agent</systemitem>
+            </td>
+        </tr>
+        <tr>
+            <td>
+            <filename>lbaas-agent.log</filename>
+            </td>
+            <td>
+            <systemitem class="service">neutron-lbaas-agent</systemitem>
+            <footnote xml:id="fn_log-lbaas-agent">
+            <para>The
+            <systemitem class="service">neutron-lbaas-agent</systemitem>
+            service only runs when Load Balancer as a Service is
+            enabled.</para></footnote>
+            </td>
+        </tr>
+        <tr>
+            <td>
+            <filename>linuxbridge-agent.log</filename>
+            </td>
+            <td>
+            <systemitem class="service">neutron-linuxbridge-agent</systemitem>
+            </td>
+        </tr>
+        <tr>
+            <td>
+            <filename>metadata-agent.log</filename>
+            </td>
+            <td>
+            <systemitem class="service">neutron-metadata-agent</systemitem>
+            </td>
+        </tr>
+        <tr>
+            <td>
+            <filename>openvswitch-agent.log</filename>
+            </td>
+            <td>
+            <systemitem class="service">neutron-openvswitch-agent</systemitem>
+            </td>
+        </tr>
+        <tr>
+            <td>
+            <filename>server.log</filename>
+            </td>
+            <td>
+            <systemitem class="service">neutron-server</systemitem>
+            </td>
+        </tr>
+        </tbody>
+    </table>
+    </section>