From 3f6acb07c292cdfeea31f02872d35ee8b65fc8c8 Mon Sep 17 00:00:00 2001
From: Stephen Gordon <sgordon@redhat.com>
Date: Sat, 18 Jan 2014 14:17:33 -0500
Subject: [PATCH] Add a note highlighting MongoDB disk requirements

Added a note to highlight the disk requirements of MongoDB
when database journaling is enabled (default). Provided
instructions for switching to smaller files and a link
to instructions for disabling journaling entirely.

Change-Id: Ie7410018ce664cddd66309df8d1b1bb17abdfcbb
Closes-Bug: #1253214
---
 .../section_ceilometer-install.xml            | 34 +++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/doc/install-guide/section_ceilometer-install.xml b/doc/install-guide/section_ceilometer-install.xml
index c57a303eb2..f1eac1b34e 100644
--- a/doc/install-guide/section_ceilometer-install.xml
+++ b/doc/install-guide/section_ceilometer-install.xml
@@ -33,6 +33,40 @@
       <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install mongodb-server mongodb</userinput></screen>
       <screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install mongodb</userinput></screen>
       <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install mongodb</userinput></screen>
+      <note>
+        <para>
+          By default MongoDB is configured to create several 1 GB files
+          in the <filename>/var/lib/mongodb/journal/</filename> directory
+          to support database journaling.
+        </para>
+        <para>
+          If you need to minimize the space allocated to support database
+          journaling then set the <option>smallfiles</option> configuration
+          key to <literal>true</literal> in the <filename>/etc/mongodb.conf</filename>
+          configuration file. This will reduce the size of each journaling file
+          to 512 MB.
+        </para>
+        <para os="ubuntu;debian">
+          As the files are created the first time the MongoDB service starts
+          you must stop the service and remove the files for this change to
+          take effect:
+        </para>
+        <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service mongodb stop</userinput>
+<prompt>#</prompt> <userinput>rm /var/lib/mongodb/journal/j._0</userinput>
+<prompt>#</prompt> <userinput>rm /var/lib/mongodb/journal/prealloc.1</userinput>
+<prompt>#</prompt> <userinput>rm /var/lib/mongodb/journal/prealloc,2</userinput>
+<prompt>#</prompt> <userinput>service mongodb start</userinput></screen>
+        <para>
+          For more information on the <option>smallfiles</option>
+          configuration key refer to the MongoDB documentation at
+          <link xlink:href="http://docs.mongodb.org/manual/reference/configuration-options/#smallfiles"/>.
+        </para>
+        <para>
+          For instructions detailing the steps to disable database journaling
+          entirely refer to
+          <link xlink:href="http://docs.mongodb.org/manual/tutorial/manage-journaling/"/>.
+        </para>
+      </note>
     </step>
     <step os="ubuntu;debian;sles;opensuse">
       <para>Configure MongoDB to make it listen on the controller public IP