Install MongoDB on CentOS

Package Options

The 10gen repository contains four packages:

mongo-10gen

This package contains MongoDB tools from latest stablerelease. Install this package on all production MongoDB hosts and optionally on other systems from which you may need to administer MongoDB systems.

mongo-10gen-server

This package contains the mongod and mongosdaemons from the latest stable release and associated configuration and init scripts.

mongo18-10gen

This package contains MongoDB tools from previous release. Install this package on all production MongoDB hosts and optionally on other systems from which you may need to administer MongoDB systems.

mongo18-10gen-server

This package contains the mongod and mongosdaemons from previous stable release and associated configuration and init scripts.

The MongoDB tools included in the mongo-10gen packages are:

mongo
mongodump

mongorestore

mongoexport

mongoimport

mongostat

mongotop

bsondump

Installing MongoDB

Configure Package Management System (YUM)

Create a /etc/yum.repos.d/10gen.repo file to hold information about your repository. If you are running a 64-bit system (recommended,) place the following configuration in/etc/yum.repos.d/10gen.repo file:

[10gen]
name=10gen Repository
baseurl=http://downloads-distro.mongodb.org/repo/redhat/os/x86_64
gpgcheck=0
enabled=1

Installing Packages

Issue the following command (as root or with sudo) to install the latest stable version of MongoDB and the associated tools:

yum install mongo-10gen mongo-10gen-server

When this command completes, you have successfully installed MongoDB! Continue for configuration and start-up suggestions.

chkconfig --levels 235 mongod on

Configure MongoDB

These packages configure MongoDB using the /etc/mongod.conf file in conjunction with the control script. You can find the init script at /etc/rc.d/init.d/mongod.

This MongoDB instance will store its data files in the/var/lib/mongo and its log files in /var/log/mongo, and run using the mongod user account.

Note

If you change the user that runs the MongoDB process, you will need to modify the access control rights to the /var/lib/mongo and/var/log/mongo directories.

Control MongoDB

Start MongoDB

Start the mongod process by issuing the following command (as root, or with sudo):

service mongod start

You can verify that the mongod process has started successfully by checking the contents of the log file at/var/log/mongo/mongod.log.

You may optionally, ensure that MongoDB will start following a system reboot, by issuing the following command (with root privileges:)

chkconfig mongod on

Stop MongoDB

Stop the mongod process by issuing the following command (as root, or with sudo):

service mongod stop

Restart MongoDB

You can restart the mongod process by issuing the following command (as root, or with sudo):

service mongod restart

Follow the state of this process by watching the output in the/var/log/mongo/mongod.log file to watch for errors or important messages from the server.

Control mongos

As of the current release, there are no control scripts for mongos. mongos is only used in sharding deployments and typically do not run on the same systems where mongod runs. You can use the mongodbscript referenced above to derive your own mongos control script.

Using MongoDB

Among the tools included in the mongo-10gen package, is themongo shell. You can connect to your MongoDB instance by issuing the following command at the system prompt:

mongo

This will connect to the database running on the localhost interface by default. At the mongo prompt, issue the following two commands to insert a record in the “test” collection of the (default) “test” database and then retrieve that document.

> db.test.save( { a: 1 } )
> db.test.find()

--EOF--