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