openstack/openstack-manuals
Code Issues Proposed changes
452ab5d4c0
openstack-manuals/doc/install-guide/source/environment-nosql-database.rst
Matthew Kassawara 5ee72cfa36 [install] Fix various minor problems 
Fix the following minor problems to reduce work after
stable/liberty branching:

1) RDO: Revert Python MySQL library from PyMySQL to MySQL-python
   due to lack of support for the former.
2) RDO: Explicitly install 'ebtables' and 'ipset' packages due
   to dependency problems.
3) General: Change numbered list to bulleted list for lists with
   only one item.
4) General: Restructure horizon content to match other services.
   More duplication of content, but sometimes RST conditionals
   are terrible and distro packages should use the same
   configuration files.
5) General: Restructure NoSQL content to match SQL content.
6) General: Improve clarity of NTP content.

Change-Id: I2620250aa27c7d41b525aa2646ad25e0692140c4
Closes-Bug: #1514760
Closes-Bug: #1514683
Implements: bp installguide-liberty
2015-11-13 07:49:53 -07:00

4.6 KiB
Raw Blame History

NoSQL database

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.

Note

The installation of the NoSQL database server is only necessary when installing the Telemetry service as documented in install_ceilometer.

Install and configure components

obs

  1. Enable the Open Build Service repositories for MongoDB based on your openSUSE or SLES version:

    On openSUSE:

    # zypper addrepo -f obs://server:database/openSUSE_13.2 Database

    On SLES:

    # zypper addrepo -f obs://server:database/SLE_12 Database

    Note

    The packages are signed by GPG key 05905EA8. You should verify the fingerprint of the imported GPG key before using it.

    Key Name:         server:database OBS Project <server:database@build.opensuse.org>
Key Fingerprint:  116EB863 31583E47 E63CDF4D 562111AC 05905EA8
Key Created:      Mon 08 Dec 2014 09:54:12 AM UTC
Key Expires:      Wed 15 Feb 2017 09:54:12 AM UTC

    Install the MongoDB package:

    # zypper install mongodb

rdo

  1. Install the MongoDB packages:

    # yum install mongodb-server mongodb

ubuntu

  1. Install the MongoDB packages:

    # apt-get install mongodb-server mongodb-clients python-pymongo

obs

  1. 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.

      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:

      smallfiles = true

      You can also disable journaling. For more information, see the MongoDB manual.

rdo

  1. Edit the /etc/mongod.conf file and complete the following actions:

    • Configure the bind_ip key to use the management interface IP address of the controller node.

      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:

      smallfiles = true

      You can also disable journaling. For more information, see the MongoDB manual.

ubuntu

  1. 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.

      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:

      smallfiles = true

      You can also disable journaling. For more information, see the MongoDB manual.

Finalize installation

ubuntu

  • If you change the journaling configuration, stop the MongoDB service, remove the initial journal files, and start the service:

    # service mongodb stop
# rm /var/lib/mongodb/journal/prealloc.*
# service mongodb start

rdo

  • Start the MongoDB service and configure it to start when the system boots:

    # systemctl enable mongod.service
# systemctl start mongod.service

obs

  • Start the MongoDB service and configure it to start when the system boots:

    # systemctl enable mongodb.service
# systemctl start mongodb.service