No description, website, or topics provided.
Clone or download
Pull request Compare This branch is 730 commits ahead, 1721 commits behind mongodb:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bsondump
common
mongodump
mongoexport
mongofiles
mongoimport
mongooplog
mongorestore
mongostat
mongotop
test
vendor/src
.gitattributes
.gitignore
Godeps
Makefile
README.md
build.sh
common.yml
go.sh
legacy-notes.md
set_gopath.sh
vendor.sh

README.md

MongoDB Tools

This is the 2.7.x unstable branch. This project is a work in progress.

  • bsondump - display BSON files in a human-readable format
  • mongoimport - Convert data from JSON, TSV or CSV and insert them into a collection
  • mongoexport - Write an existing collection to CSV or JSON format
  • mongodump/mongorestore - Dump MongoDB backups to disk in .BSON format, or restore them to a live database
  • mongostat - Monitor live MongoDB servers, replica sets, or sharded clusters
  • mongofiles - Read, write, delete, or update files in GridFS
  • mongooplog - Replay oplog entries between MongoDB servers
  • mongotop - Monitor read/write activity on a mongo server

Report any bugs, improvements, or new feature requests at https://jira.mongodb.org/browse/tools

####Setup

Clone the repo and set your GOPATH to include the vendored dependencies by using the helper script set_gopath.sh

git clone https://github.com/mongodb/mongo-tools
cd mongo-tools
. set_gopath.sh

Building Tools

To build the tools, you need to have Go version 1.3 and up. Running the build.sh script will install all the tools to ./bin.

Alternatively, you can set GOBIN and use go install:

export GOBIN=bin
go install mongodump/main/mongodump.go

An additional flag, -tags, can be passed to the go install command in order to install the tools with support for SSL and/or SASL. For example:

go install -tags ssl mongoimport/main/mongoimport.go # install mongoimport with SSL support enabled
go install -tags sasl mongoimport/main/mongoimport.go # install mongoimport with SASL support enabled
go install -tags "ssl sasl" mongoimport/main/mongoimport.go # install mongoimport with both SASL and SSL

Alternatively, you can run build.sh with the appropriate arguments. For example:

build.sh ssl # install all the tools with SSL support enabled
build.sh sasl ssl # install all the tools with both SASL and SSL support enabled