Skip to main content

ZC Buildout recipe for setting up mongoDB.

Project description

Buildout recipe for downloading and installing mongoDB. Visit http://www.mongodb.org for further details on mongoDB.

Credits

Thanks to Andreas Jung for provinding a patch to symlink all mongoDB binaries.

Thanks to Stephan Hofmockel who contributed a patch for creating a start script with custom command line parameters specified as buildout options.

A brief documentation

This recipe takes a number of options:

darwin-32bit-url
The URL to download the 32 bit binary package for the darwin platform.
darwin-64bit-url
The URL to download the 64 bit binary package for the darwin platform.
linux2-32bit-url
The URL to download the 32 bit binary package for the linux platform.
linux2-64bit-url
The URL to download the 64 bit binary package for the linux platform.

(And all options of mongod version v1.6.0 as described below.)

Tests

We will define a buildout template used by the recipe:

>>> buildout_cfg = """
... [buildout]
... parts = mongodb
...
... [mongodb]
... recipe = rod.recipe.mongodb
... darwin-32bit-url = http://downloads.mongodb.org/osx/mongodb-osx-i386-1.6.5.tgz
... darwin-64bit-url = http://downloads.mongodb.org/osx/mongodb-osx-x86_64-1.6.5.tgz
... linux2-32bit-url = http://downloads.mongodb.org/linux/mongodb-linux-i686-1.6.5.tgz
... linux2-64bit-url = http://downloads.mongodb.org/linux/mongodb-linux-x86_64-1.6.5.tgz
... """

We’ll start by creating a buildout:

>>> import os.path
>>> write('buildout.cfg', buildout_cfg)

Running the buildout gives us:

>>> output = system(buildout)
>>> 'rod.recipe.mongodb: downloading mongoDB distribution...' in output
True

Check whether the binaries are copied:

>>> set(os.listdir('bin')).issuperset(['mongo', 'mongod', 'mongodump', 'mongoexport', 'mongofiles', 'mongoimport', 'mongorestore', 'mongos', 'mongosniff', 'mongostat'])
True

A start script with the format ‘start_PART-NAME_mongod.sh’ should be generated.

>>> 'start_mongodb_mongod.sh' in os.listdir('bin')
True

It is possible to change the name of this start script with the ‘script_name’ option. Furthermore all options of mongod (version v1.6.0) are supported via buildout options. A more comprehensive recipe could be for example:

>>> buildout_cfg = """
... [buildout]
... parts = mongodb
... [mongodb]
... recipe = rod.recipe.mongodb
... darwin-32bit-url = http://downloads.mongodb.org/osx/mongodb-osx-i386-1.6.5.tgz
... darwin-64bit-url = http://downloads.mongodb.org/osx/mongodb-osx-x86_64-1.6.5.tgz
... linux2-32bit-url = http://downloads.mongodb.org/linux/mongodb-linux-i686-1.6.5.tgz
... linux2-64bit-url = http://downloads.mongodb.org/linux/mongodb-linux-x86_64-1.6.5.tgz
... script_name = start_master.sh
... quiet=true
... fork=true
... logpath=${buildout:parts-directory}/mongodb/log
... dbpath=${buildout:parts-directory}/mongodb/data
... directoryperdb=true
... master=true
... update=true
... """
>>> write('buildout.cfg', buildout_cfg)

Re-running the buildout:

>>> output = system(buildout)

Changes

1.2.2 2011-01-21

  • Added buildout option ‘update=true/false’ to force or prevent updating the part.

1.2.1 2010-08-11

  • Added missing command line parameters for Replica Sets (MongoDB 1.6.0).

1.2.0 2010-05-16

  • Creating start script with command line parameters specified as buildout options.

1.1.4 2010-04-18

  • Symlinking rather than copying binaries.

1.1.0 2010-04-15

  • Copying all MongoDB binaries into the ‘bin’ folder of the buildout environment (ajung).

1.0.1 2009-08-21

  • Removing part before updating.

1.0.0 2009-08-14

  • Initial release.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for rod.recipe.mongodb, version 1.2.2
Filename, size File type Python version Upload date Hashes
Filename, size rod.recipe.mongodb-1.2.2.tar.gz (9.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page