b33f32b714
This adds ceilometer-specific contents of the OpenStack Installation Guide in the ceilometer repo per [1]. A separate change will remove the ceilometer contents from the OpenStack Installation Guide for Newton per [2]. The ceilometer install-guide structure is based on Install Guide Cookiecutter [3]. Also adds tox.ini environment for install-guide and adds openstackdocs-theme to test-requirements.txt. [1] http://specs.openstack.org/openstack/docs-specs/specs/newton/project-specific-installguides.html [2] http://specs.openstack.org/openstack/docs-specs/specs/newton/installguide.html [3] https://review.openstack.org/#/c/314229/ Partially-Implements: blueprint projectspecificinstallguide Change-Id: Iffc5d7243e9eeb74c9dd7b559ef3de7123269293
53 lines
1.4 KiB
ReStructuredText
53 lines
1.4 KiB
ReStructuredText
.. _environment-nosql-database-ubuntu:
|
|
|
|
NoSQL database for Ubuntu
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
The Telemetry service uses a NoSQL database to store information. The database
|
|
typically runs on the controller node. The procedures in this guide use
|
|
MongoDB.
|
|
|
|
Install and configure components
|
|
--------------------------------
|
|
|
|
1. Install the MongoDB packages:
|
|
|
|
.. code-block:: console
|
|
|
|
# apt-get install mongodb-server mongodb-clients python-pymongo
|
|
|
|
2. Edit the ``/etc/mongodb.conf`` file and complete the following
|
|
actions:
|
|
|
|
* Configure the ``bind_ip`` key to use the management interface
|
|
IP address of the controller node.
|
|
|
|
.. code-block:: ini
|
|
|
|
bind_ip = 10.0.0.11
|
|
|
|
* By default, MongoDB creates several 1 GB journal files
|
|
in the ``/var/lib/mongodb/journal`` directory.
|
|
If you want to reduce the size of each journal file to
|
|
128 MB and limit total journal space consumption to 512 MB,
|
|
assert the ``smallfiles`` key:
|
|
|
|
.. code-block:: ini
|
|
|
|
smallfiles = true
|
|
|
|
You can also disable journaling. For more information, see the
|
|
`MongoDB manual <http://docs.mongodb.org/manual/>`__.
|
|
|
|
Finalize installation
|
|
---------------------
|
|
|
|
* If you change the journaling configuration, stop the MongoDB
|
|
service, remove the initial journal files, and start the service:
|
|
|
|
.. code-block:: console
|
|
|
|
# service mongodb stop
|
|
# rm /var/lib/mongodb/journal/prealloc.*
|
|
# service mongodb start
|