From 6ec12953bf300c1d2f2bd91432fbbbc18415997b Mon Sep 17 00:00:00 2001
From: Don Domingo <ddomingo@redhat.com>
Date: Thu, 27 Feb 2014 17:05:56 +1000
Subject: [PATCH] Add list of service log files used by dashboard

This patch adds the list of log files used by the dashboard / httpd
services, along with a description of each.

Change-Id: I842ccea9fdb0c6d721f5742c6848d02b277d5c73
Partial-Bug: #1282882
---
 .../ch_dashboardconfigure.xml                 |  1 +
 .../dashboard/section_dashboard-log-files.xml | 48 +++++++++++++++++++
 2 files changed, 49 insertions(+)
 create mode 100644 doc/config-reference/dashboard/section_dashboard-log-files.xml

diff --git a/doc/config-reference/ch_dashboardconfigure.xml b/doc/config-reference/ch_dashboardconfigure.xml
index cd9651891e..b0914f9026 100644
--- a/doc/config-reference/ch_dashboardconfigure.xml
+++ b/doc/config-reference/ch_dashboardconfigure.xml
@@ -9,4 +9,5 @@
     <xi:include href="../common/section_dashboard-configure.xml"/>
     <xi:include href="../common/section_dashboard_customizing.xml"/>
     <xi:include href="dashboard/section_dashboard-sample-configuration-files.xml"/>
+    <xi:include href="dashboard/section_dashboard-log-files.xml"/>
 </chapter>
diff --git a/doc/config-reference/dashboard/section_dashboard-log-files.xml b/doc/config-reference/dashboard/section_dashboard-log-files.xml
new file mode 100644
index 0000000000..46c14b6318
--- /dev/null
+++ b/doc/config-reference/dashboard/section_dashboard-log-files.xml
@@ -0,0 +1,48 @@
+<?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_dashboard-logs">
+    <title>Log files used by the dashboard</title>
+    <para>The dashboard is served to users through the Apache web
+    server (<systemitem>httpd</systemitem>). As a result, logs
+    relating to the dashboard appear in the following files in the
+    <filename>/var/log/httpd</filename> or
+    <filename>/var/log/apache2</filename>
+    directory of where the dashboard is hosted.</para>
+    <table rules="all">
+    <caption>Log files used by the dashboard/httpd</caption>
+    <col width="50%"/>
+    <col width="50%"/>
+        <thead>
+        <tr>
+            <td>
+            Log file
+            </td>
+            <td>
+            Description
+            </td>
+        </tr>
+        </thead>
+        <tbody>
+        <tr>
+            <td>
+            <filename>access_log</filename>
+            </td>
+            <td>
+            This file logs all attempts to access the web server.
+            </td>
+        </tr>
+        <tr>
+            <td>
+            <filename>error_log</filename>
+            </td>
+            <td>
+            This file logs all unsuccessful attempts to access the
+            web server, along with the reason each attempt/request
+            failed.
+            </td>
+        </tr>
+        </tbody>
+    </table>
+    </section>