openstack-manuals/doc/install-guide/source/environment-nosql-database.rst

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

   On SLES:

   # zypper addrepo -f obs://server:database/SLE_12_SP1 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

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.

     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

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

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.

     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