This evening I tried to connect to my MongoDB instance using the command line mongo tool and got the following error message: Error: couldn't connect to server 127.0.0.1} (anon):1137
. It turns out that the server wasn't running due to an improper shutdown at some point in the past. Here's what you need to do to fix it.
Note: my instructions are specific to Ubuntu 10.04 (& probably other versions of Ubuntu).
Why Won't MongoDB Start?
One of the lame things about MongoDB is that it doesn't handle a crash on it's own very well. If the database crashes or otherwise doesn't shut down properly, then the next time you try to start it, you'll get a nice error saying that there is an old lockfile and that you probably need to remove it and run mongod --repair. However, on my laptop running Ubuntu 10.04, I ran into a few confusing things that I'd like to share, hopefully to save someone else out there some time.
Symptoms
- Try to connect (type
mongo
on the command line). You should get a connect failed error. - Verify that MongoDB is not running. Run
sudo status mongodb
. It should reportmongodb stop/waiting
. - Verify that you are unable to start MongoDB. Run
sudo start mongodb
. It will reportmongodb start/running, process XXXX
no matter what. But if you runsudo status mongodb
again, you'll get stop/waiting. - Check your logs to see that you in fact have the same problem as me. Your logs should be at /var/log/mongodb/mongodb.log. You should see an error like this:
************** old lock file: /var/lib/mongodb/mongod.lock. probably means unclean shutdown recommend removing file and running --repair see: http://dochub.mongodb.org/core/repair for more information *************
Instructions To Get MongoDB Up Again
- Manually remove the lockfile:
sudo rm /var/lib/mongodb/mongod.lock
- Run the repair script:
sudo -u mongodb mongod -f /etc/mongodb.conf --repair.
- You must run this command as the mongodb user. If you run it as root, then root will own files in /var/lib/mongodb/ that are necessary to run the mongodb daemon and therefore when the daemon trys to run later as the mongodb user, it won't have permissions to start. In that case you'll get this error:
Unable to create / open lock file for lockfilepath: /var/lib/mongodb/mongod.lock errno:13 Permission denied, terminating
. - On Ubuntu, you must specify the configuration file /etc/mongodb.conf using the -f flag. Otherwise it will look for the data files in the wrong place and you will see the following error:
dbpath (/data/db/) does not exist, terminating
.
- You must run this command as the mongodb user. If you run it as root, then root will own files in /var/lib/mongodb/ that are necessary to run the mongodb daemon and therefore when the daemon trys to run later as the mongodb user, it won't have permissions to start. In that case you'll get this error:
- Now you can start your MongoDB server with
sudo start mongodb
and verify it is running withsudo status mongodb
and by trying to connect to it withmongo test
.