Overview

This charm deploys MongoDB in three configurations:

Single node
Replica set
Sharded clusters

Usage

Review the configurable options

The MongoDB charm allows for certain values to be configurable via a config.yaml file. The options provided are extensive, you should review the options.

Specificlly the following options are important:

replicaset
ie: myreplicaset
Each replicaset has a unique name to distinguish it’s members from other replicasets available in the network.
The default value of myset should be fine for most single cluster scenarios.
web_admin_ui
MongoDB comes with a basic but very informative web user interface that provides health
and status information on the database node as well as the cluster.
The default value of yes will start the Admin web UI on port 28017.
replicaset_master
If this node is going to be joining an existing replicaset, you can specify a member of that cluster
( preferably the master node ) so we can join the existing replicaset.
The value should be in the form of host[:port]
ie: hostname ( will connect to hostname on the default port of 27017 )
ie: hostname:port ( will connect to hostname on port number )

Most of the options in config.yaml have been modeled after the default configuration file for mongodb (normally in /etc/mongodb.conf) and should be familiar to most mongodb admins. Each option in this charm have a brief description of what it does.

Usage

Single Node

Deploy the first MongoDB instance

juju deploy mongodb
juju expose mongodb

Replica Sets

Deploy the first MongoDB instance

juju deploy mongodb
juju expose mongodb

Your deployment should look similar to this ( juju status ):

environment: amazon
machines:
  "0":
    agent-state: started
    agent-version: 1.16.5
    dns-name: ec2-184-73-7-172.compute-1.amazonaws.com
    instance-id: i-cb55cceb
    instance-state: running
    series: precise
    hardware: arch=amd64 cpu-cores=1 cpu-power=100 mem=1740M root-disk=8192M
  "1":
    agent-state: pending
    dns-name: ec2-54-196-181-161.compute-1.amazonaws.com
    instance-id: i-974bd2b7
    instance-state: pending
    series: precise
    hardware: arch=amd64 cpu-cores=1 cpu-power=100 mem=1740M root-disk=8192M
services:
  mongodb:
    charm: cs:precise/mongodb-20
    exposed: false
    relations:
      replica-set:
      - mongodb
    units:
      mongodb/0:
        agent-state: pending
        machine: "1"
        public-address: ec2-54-196-181-161.compute-1.amazonaws.com

In addition, the MongoDB web interface should also be accessible via the services’
public-address and port 28017 ( ie: http://ec2-50-17-73-255.compute-1.amazonaws.com:28017 ).

(Optional) Change the replicaset name

juju set mongodb replicaset=<new_replicaset_name>

Add one more nodes to your replicaset

juju add-unit mongodb

Add multiple nodes to your replicaset

juju add-unit mongodb -n5

We now have a working MongoDB replica-set.

Sharding (Scale Out Usage)

According the the MongoDB documentation found on their website, one way of deploying a Shard Cluster is as follows:

deploy config servers
deploy a mongo shell (mongos)
deploy shards
connect the config servers to the mongo shell
add the shards to the mongo shell

Using Juju we can deploy a sharded cluster using the following commands:

Prepare a configuration file similar to the following:

shard1:
  replicaset: shard1
shard2:
  replicaset: shard2
shard3:
  replicaset: shard3
configsvr:
  replicaset: configsvr

We'll save this one as ~/mongodb-shard.yaml.

Bootstrap the environment

juju bootstrap

Config Servers ( we'll deploy 3 of them )

juju deploy mongodb configsvr --config ~/mongodb-shard.yaml -n3

Mongo Shell ( We just deploy one for now )

juju deploy mongodb mongos

Shards ( We'll deploy three replica-sets )

juju deploy mongodb shard1 --config ~/mongodb-shard.yaml -n3
juju deploy mongodb shard2 --config ~/mongodb-shard.yaml -n3
juju deploy mongodb shard3 --config ~/mongodb-shard.yaml -n3

Connect the Config Servers to the Mongo shell (mongos)

juju add-relation mongos:mongos-cfg configsvr:configsvr

Connect each Shard to the Mongo shell (mongos)

juju add-relation mongos:mongos shard1:database
juju add-relation mongos:mongos shard2:database
juju add-relation mongos:mongos shard3:database

With the above commands, we should now have a three replica-set sharded cluster running.
Using the default configuration, here are some details of our sharded cluster:

mongos is running on port 27021
configsvr is running on port 27019
the shards are running on the default mongodb port of 27017
The web admin is turned on by default and accessible with your browser on port 28017 on each of the shards.

To verify that your sharded cluster is running, connect to the mongo shell and run sh.status():

mongo --host <mongos_host>:<mongos_port>
run sh.status()
You should see your the hosts for your shards in the status output.

Use the storage subordinate to store mongodb data on a permanent OpenStack or Amazon EBS volume

The storage subordinate and block-storage-broker service can automatically handle attaching the volume and mounting it to the unit before MongoDB is setup to use it.

For example if you've created the volumes vol-id-00001 and vol-id-00002 and want to attach them to your 2 mongo units, with your OpenStack or AWS credentials in a credential.yaml file:

juju deploy block-storage-broker --config credentials.yaml
juju deploy storage
juju add-relation block-storage-broker storage
juju set storage provider=block-storage-broker
juju set volume_map="{mongodb/0: vol-id-00001, mongodb/1: vol-id-00002}"
juju add-relation storage mongodb

Use a permanent Openstack volume to store mongodb data. (DEPRECATED)

Note: Although these steps will still work they are now deprecated, you should use the storage subordinate above instead.

To deploy mongodb using permanent volume on Openstack, the permanent volume should be attached to the mongodb unit just after the deployment, then the configuration should be updated like follows.

juju set mongodb volume-dev-regexp="/dev/vdc" volume-map='{"mongodb/0": "vol-id-00000000000000"}' volume-ephemeral-storage=false

Backups

Backups can be enabled via config. Note that destroying the service cannot
currently remove the backup cron job so it will continue to run. There is a
setting for the number of backups to keep, however, to prevent from filling
disk space.

To fetch the backups scp the files down from the path in the config.

Known Limitations and Issues

If your master/slave/replicaset deployment is not updating correctly, check the log files at /var/log/mongodb/mongodb.log to see if there is an obvious reason ( port not open etc.).
Ensure that TCP port 27017 is accessible from all of the nodes in the deployment.
If you are trying to access your MongoDB instance from outside your deployment, ensure that the service has been exposed ( juju expose mongodb )
Make sure that the mongod process is running ( ps -ef | grep mongo ).
Try restarting the database ( restart mongodb )
If all else fails, remove the data directory on the slave ( rm -fr /var/log/mongodb/data/* ) and restart the mongodb-slave daemon ( restart mongodb ).

Contact Information

MongoDB Contact Information

Configuration

config_server_dbpath

(string)

                            The path where the config server data files will be kept.

/mnt/var/lib/mongodb/configsvr

volume-dev-regexp

(string)

                            Deprecated, use the storage subordinate. Block device for attached volumes as seen by the VM, will be "scanned" for an unused device when "volume-map" is valid for the unit.

/dev/vd[b-z]

backup_directory

(string)

                            Where can the backups be found.

/home/ubuntu/backups

nocursors

(boolean)

                            Diagnostic/debugging option

backups_enabled

(boolean)

                            Enable daily backups to disk.

noprealloc

(boolean)

                            Disable data file preallocation

oplogSize

(string)

                            Custom size for replication operation log

default

bind_ip

(string)

                            IP address that mongodb should listen for connections.

all

mms-interval

(string)

                            Ping interval for Mongo monitoring server ( in number of seconds )

disabled

port

(int)

                            Default MongoDB port

27017

dbpath

(string)

                            The path where the data files will be kept.

/var/lib/mongodb

verbose

(boolean)

                            Verbose logging output

replicaset

(string)

                            Name of the replica set

myset

backup_copies_kept

(int)

                            Number of backups to keep. Keeps one week's worth by default.

nssize

(string)

                            Specify .ns file size for new databases

default

mongos_logpath

(string)

                            The path where to send log data from the mongo router.

/mnt/var/log/mongodb/mongos.log

logpath

(string)

                            The path where to send log data.

/var/log/mongodb/mongodb.log

volume-ephemeral-storage

(boolean)

                            Deprecated, use the storage subordinate. If false, a configure-error state will be raised if
   volume-map[$JUJU_UNIT_NAME] is not set (see "volume-map"
   below) - see "volume-map" below.
If true, service units won't try to use "volume-map" (and
   related variables) to mount and use external (EBS) volumes,
   thus storage lifetime will equal VM, thus ephemeral.
   YOU'VE BEEN WARNED.

True

source

(string)

                            Optional configuration to support use of additional sources such as:
  - ppa:myteam/ppa
  - cloud:precise-proposed/icehouse
  - http://my.archive.com/ubuntu main
The last option should be used in conjunction with the key configuration option.

None

master

(string)

                            Who is the master DB. If not "self", put the Master DB here as "host:port"

self

objcheck

(boolean)

                            Inspect all client data for validity on receipt (useful for developing drivers)

config_server_port

(int)

                            Port number to use for the config-server

27019

volume-map

(string)

                            Deprecated, use the storage subordinate. YAML map as e.g. "{ mongodb/0: vol-0000010, mongodb/1: vol-0000016 }". Service units will raise a "configure-error" condition if no volume-map value is set for it - it expects a human to set it properly to resolve it.

opIdMem

(string)

                            Size limit for in-memory storage of op ids

default

notablescan

(boolean)

                            Turns off table scans.  Any query that would do a table scan fails

mongos_port

(int)

                            Port number to use for the mongo router

27021

logrotate-frequency

(string)

                            How often should the logs be rotated. Use values from logrotate.

daily

journal

(boolean)

                            Enable journaling, http://www.mongodb.org/display/DOCS/Journaling

True

quota

(boolean)

                            Enable db quota management

auth

(boolean)

                            Turn on/off security

extra_config_options

(string)

                            Extra options ( comma separated ) to be included ( at the end ) in the mongodb.conf file.

none

logrotate-rotate

(int)

                            Number of log files to keep.

arbiter

(string)

                            Enable arbiter mode. Possible values are 'disabled' for no arbiter, 'enable' to become an arbiter or 'host:port' to declare another host as an arbiter.  replicaset_master must be set for this option to work.

disabled

key

(string)

                            Key ID to import to the apt keyring to support use with arbitary source configuration from outside of Launchpad archives or PPA's.

mms-name

(string)

                            Server name for Mongo monitoring server

disabled

logrotate-maxsize

(string)

                            Maximum log size before rotating.

500M

nohints

(boolean)

                            Ignore query hints

web_admin_ui

(boolean)

                            Replica Set Admin UI (accessible via default_port + 1000)

True

replicaset_master

(string)

                            Replica Set master (optional). Possible values are 'auto' for automatic detection based on install time or 'host:port' to connect to 'host' on 'port' and register as a member.

auto

mms-token

(string)

                            Accout token for Mongo monitoring server

disabled

autoresync

(boolean)

                            Automatically resync if slave data is stale

diaglog

(int)

                            Set oplogging level where n is 0=off (default), 1=W, 2=R, 3=both, 7=W+some reads

logappend

(boolean)

                            Append log entries to existing log file

True

cpu

(boolean)

                            Enables periodic logging of CPU utilization and I/O wait

config_server_logpath

(string)

                            The path where to send config server log data.

/mnt/var/log/mongodb/configsvr.log

noscripting

(boolean)

                            Turns off server-side scripting.  This will result in greatly limited functionality

extra_daemon_options

(string)

                            Extra options ( exactly as you would type them in the command line ) to be added via the command line to the mongodb daemon

none

Popular searches

mongodb #3

Tags

Overview

Usage

Review the configurable options

Usage

Single Node

Replica Sets

(Optional) Change the replicaset name

Add one more nodes to your replicaset

Add multiple nodes to your replicaset

Sharding (Scale Out Usage)

Prepare a configuration file similar to the following:

Bootstrap the environment

Config Servers ( we'll deploy 3 of them )

Mongo Shell ( We just deploy one for now )

Shards ( We'll deploy three replica-sets )

Connect the Config Servers to the Mongo shell (mongos)

Connect each Shard to the Mongo shell (mongos)

Use the storage subordinate to store mongodb data on a permanent OpenStack or Amazon EBS volume

Use a permanent Openstack volume to store mongodb data. (DEPRECATED)

Backups

Known Limitations and Issues

Contact Information

MongoDB Contact Information

Configuration