openstack
/
openstack-manuals
Code Issues Proposed changes

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
This commit is contained in:
Stephen Gordon 2014-01-18 14:17:33 -05:00
parent 01c6e7f82e
commit 3f6acb07c2
1 changed files with 34 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
doc/install-guide/section_ceilometer-install.xml
View File

@ -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