path: root/debian/mongorestore.1

.\" Man page generated from reStructuredText.
.
.TH "MONGORESTORE" "1" "October 03, 2013" "2.4" "mongodb-manual"
.SH NAME
mongorestore \- MongoDB
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SYNOPSIS
.sp
The \fBmongorestore\fP program writes data from a binary database
dump created by \fBmongodump\fP to a MongoDB
instance. \fBmongorestore\fP can create a new database or add
data to an existing database.
.sp
\fBmongorestore\fP can write data to either \fImongod\fP or \fBmongos\fP
instances, in addition to writing directly to MongoDB data files
without an active \fBmongod\fP\&.
.sp
If you restore to an existing database, \fBmongorestore\fP will
only insert into the existing database, and does not perform updates
of any kind. If existing documents have the same value \fB_id\fP field
in the target database and collection,
\fBmongorestore\fP will \fInot\fP overwrite those documents.
.sp
Remember the following properties of \fBmongorestore\fP behavior:
.INDENT 0.0
.IP \(bu 2
\fBmongorestore\fP recreates indexes recorded by
\fBmongodump\fP\&.
.IP \(bu 2
all operations are inserts, not updates.
.IP \(bu 2
\fBmongorestore\fP does not wait for a response from a
\fBmongod\fP to ensure that the MongoDB process has received or
recorded the operation.
.sp
The \fBmongod\fP will record any errors to its log that occur
during a restore operation, but \fBmongorestore\fP will not
receive errors.
.UNINDENT
.sp
\fBNOTE:\fP
.INDENT 0.0
.INDENT 3.5
The format of data created by \fBmongodump\fP tool from the
2.2 distribution or later is different and incompatible with
earlier versions of \fBmongod\fP\&.
.UNINDENT
.UNINDENT
.SH OPTIONS
.INDENT 0.0
.TP
.B mongorestore
.UNINDENT
.INDENT 0.0
.TP
.B mongorestore
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help
Returns a basic help and usage text.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-verbose, \-v
Increases the amount of internal reporting returned on the command
line. Increase the verbosity with the \fB\-v\fP form by including
the option multiple times (e.g. \fB\-vvvvv\fP).
.UNINDENT
.INDENT 0.0
.TP
.B \-\-version
Returns the version of the \fBmongorestore\fP tool.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-host <hostname><:port>
Specifies a resolvable hostname for the \fBmongod\fP to which
you want to restore the database. By default
\fBmongorestore\fP will attempt to connect to a MongoDB
process running on the localhost port number \fB27017\fP\&. For an
example of \fI\-\-host\fP, see \fIbackup\-restore\-dump\fP\&.
.sp
Optionally, specify a port number to connect a MongoDB instance
running on a port other than \fB27017\fP\&.
.sp
To connect to a replica set, you can specify the replica set seed
name, and a seed list of set members, in the following format:
.INDENT 7.0
.INDENT 3.5
.sp
.nf
.ft C
<replica_set_name>/<hostname1><:port>,<hostname2:<port>,...
.ft P
.fi
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-\-port <port>
Specifies the port number, if the MongoDB instance is not running
on the standard port (i.e. \fB27017\fP). You may also specify a port
number using the \fI\-\-host\fP command. For
an example of \fI\-\-port\fP, see \fIbackup\-restore\-dump\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-ipv6
Enables IPv6 support that allows \fBmongorestore\fP to connect
to the MongoDB instance using an IPv6 network. All MongoDB programs
and processes, including \fBmongorestore\fP, disable IPv6
support by default.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-ssl
New in version 2.4: MongoDB added support for SSL connections to \fBmongod\fP
instances in mongorestore\&.

.sp
\fBNOTE:\fP
.INDENT 7.0
.INDENT 3.5
SSL support in mongorestore is not compiled into the default
distribution of MongoDB. See
http://docs.mongodb.org/manual/tutorial/configure\-ssl for more information on SSL
and MongoDB.
.sp
Additionally, mongorestore does not support connections to
\fBmongod\fP instances that require client certificate
validation.
.UNINDENT
.UNINDENT
.sp
Allows \fBmongorestore\fP to connect to \fBmongod\fP
instance over an SSL connection.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-username <username>, \-u <username>
Specifies a username to authenticate to the MongoDB instance, if
your database requires authentication. Use in conjunction with the
\fI\-\-password\fP option to supply a
password. For an example of \fI\-\-username\fP, see
\fIbackup\-restore\-dump\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-password <password>, \-p <password>
Specifies a password to authenticate to the MongoDB instance. Use
in conjunction with the \fI\-\-username\fP option to
supply a username. For an example of \fI\-\-password\fP, see
\fIbackup\-restore\-dump\fP\&.
.sp
If you specify a \fI\-\-username\fP and do not pass an argument
to \fI\-\-password\fP, \fBmongorestore\fP will prompt for a
password interactively. If you do not specify a password on the
command line, \fI\-\-password\fP must be the last argument
specified.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-authenticationDatabase <dbname>
New in version 2.4.

.sp
Specifies the database that holds the user\(aqs (e.g
\fI\-\-username\fP) credentials.
.sp
By default, \fBmongorestore\fP assumes that the database specified to the
\fI\-\-db\fP argument holds the user\(aqs credentials, unless you
specify \fI\-\-authenticationDatabase\fP\&.
.sp
See \fBuserSource\fP,
http://docs.mongodb.org/manual/reference/privilege\-documents and
http://docs.mongodb.org/manual/reference/user\-privileges for more information about
delegated authentication in MongoDB.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-authenticationMechanism <name>
New in version 2.4.

.sp
Specifies the authentication mechanism. By default, the
authentication mechanism is \fBMONGODB\-CR\fP, which is the MongoDB
challenge/response authentication mechanism. In MongoDB Enterprise,
\fBmongorestore\fP also includes support for \fBGSSAPI\fP to handle
Kerberos authentication.
.sp
See http://docs.mongodb.org/manual/tutorial/control\-access\-to\-mongodb\-with\-kerberos\-authentication
for more information about Kerberos authentication.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-dbpath <path>
Specifies the directory of the MongoDB data files. If used, the
\fI\-\-dbpath\fP option enables \fBmongorestore\fP to attach
directly to local data files and insert the data without the
\fBmongod\fP\&. To run with \fI\-\-dbpath\fP,
\fBmongorestore\fP needs to lock access to the data directory:
as a result, no \fBmongod\fP can access the same path while the
process runs. For an example of \fI\-\-dbpath\fP, see
\fIbackup\-restore\-dbpath\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-directoryperdb
Use the \fI\-\-directoryperdb\fP in conjunction with the
corresponding option to \fBmongod\fP, which allows
\fBmongorestore\fP to import data into MongoDB instances that
have every database\(aqs files saved in discrete directories on the
disk. This option is only relevant when specifying the
\fI\-\-dbpath\fP option.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-journal
Allows \fBmongorestore\fP write to the durability
\fIjournal\fP to ensure that the data files will remain in a
consistent state during the write process. This option is only
relevant when specifying the \fI\-\-dbpath\fP option. For an
example of \fI\-\-journal\fP, see \fIbackup\-restore\-dbpath\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-db <db>, \-d <db>
Use the \fI\-\-db\fP option to specify a database for
\fBmongorestore\fP to restore data \fIinto\fP\&. If the database
doesn\(aqt exist, \fBmongorestore\fP will create the specified
database.  If you do not specify a \fB<db>\fP,
\fBmongorestore\fP creates new databases that correspond to
the databases where data originated and data may be
overwritten. Use this option to restore data into a MongoDB
instance that already has data.
.sp
\fI\-\-db\fP does \fInot\fP control which \fIBSON\fP files
\fBmongorestore\fP restores. You must use the
\fBmongorestore\fP \fI\%path option\fP to limit that restored data.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-collection <collection>, \-c <collection>
Use the \fI\-\-collection\fP option to specify a collection for
\fBmongorestore\fP to restore. If you do not specify a
\fB<collection>\fP, \fBmongorestore\fP imports all collections
created. Existing data may be overwritten. Use this option to
restore data into a MongoDB instance that already has data, or to
restore only some data in the specified imported data set.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-objcheck
Forces the \fBmongorestore\fP to validate all requests from
clients upon receipt to ensure that clients never insert invalid
documents into the database. For objects with a high degree of
sub\-document nesting, \fI\-\-objcheck\fP can have a small impact
on performance. You can set \fI\%--noobjcheck\fP to disable
object checking at run\-time.
.sp
Changed in version 2.4: MongoDB enables \fI\-\-objcheck\fP by default, to prevent any
client from inserting malformed or invalid BSON into a MongoDB
database.

.UNINDENT
.INDENT 0.0
.TP
.B \-\-noobjcheck
New in version 2.4.

.sp
Disables the default document validation that MongoDB performs on all
incoming BSON documents.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-filter \(aq<JSON>\(aq
Limits the documents that \fBmongorestore\fP imports to only
those documents that match the JSON document specified as
\fB\(aq<JSON>\(aq\fP\&. Be sure to include the document in single quotes to
avoid interaction with your system\(aqs shell environment. For an
example of \fI\%--filter\fP, see \fIbackup\-restore\-filter\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-drop
Modifies the restoration procedure to drop every collection from
the target database before restoring the collection from the dumped
backup.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-oplogReplay
Replays the \fIoplog\fP after restoring the dump to ensure that the current
state of the database reflects the point\-in\-time backup captured with
the "\fImongodump \-\-oplog\fP" command. For an example of
\fI\%--oplogReplay\fP, see \fIbackup\-restore\-oplogreplay\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-keepIndexVersion
Prevents \fBmongorestore\fP from upgrading the index to the latest
version during the restoration process.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-w <number of replicas per write>
New in version 2.2.

.sp
Specifies the \fIwrite concern\fP for each write operation that
\fBmongorestore\fP writes to the target database. By default,
\fBmongorestore\fP does not wait for a response for
\fIwrite acknowledgment\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-noOptionsRestore
New in version 2.2.

.sp
Prevents \fBmongorestore\fP from setting the collection
options, such as those specified by the \fBcollMod\fP
\fIdatabase command\fP, on restored collections.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-noIndexRestore
New in version 2.2.

.sp
Prevents \fBmongorestore\fP from restoring and building
indexes as specified in the corresponding \fBmongodump\fP
output.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-oplogLimit <timestamp>
New in version 2.2.

.sp
Prevents \fBmongorestore\fP from applying \fIoplog\fP entries newer
than the \fB<timestamp>\fP\&. Specify \fB<timestamp>\fP values in the
form of \fB<time_t>:<ordinal>\fP, where \fB<time_t>\fP is the seconds
since the UNIX epoch, and \fB<ordinal>\fP represents a counter of
operations in the oplog that occurred in the specified second.
.sp
You must use \fI\%--oplogLimit\fP in conjunction with the
\fI\%--oplogReplay\fP option.
.UNINDENT
.INDENT 0.0
.TP
.B <path>
The final argument of the \fBmongorestore\fP command is a
directory path. This argument specifies the location of the
database dump from which to restore.
.UNINDENT
.SH USAGE
.sp
See http://docs.mongodb.org/manual/tutorial/backup\-databases\-with\-binary\-database\-dumps
for a larger overview of \fBmongorestore\fP
usage. Also see the \fBmongodump\fP document for an overview of the
\fBmongodump\fP, which provides the related inverse
functionality.
.sp
Consider the following example:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
mongorestore \-\-collection people \-\-db accounts dump/accounts/people.bson
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Here, \fBmongorestore\fP reads the database dump in the \fBdump/\fP
sub\-directory of the current directory, and restores \fIonly\fP the
documents in the collection named \fBpeople\fP from the database named
\fBaccounts\fP\&. \fBmongorestore\fP restores data to the instance
running on the localhost interface on port \fB27017\fP\&.
.sp
In the next example, \fBmongorestore\fP restores a backup of the
database instance located in \fBdump\fP to a database instance stored
in the \fB/srv/mongodb\fP on the local machine. This requires that there
are no active \fBmongod\fP instances attached to \fB/srv/mongodb\fP
data directory.
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
mongorestore \-\-dbpath /srv/mongodb
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
In the final example, \fBmongorestore\fP restores a database
dump located at \fB/opt/backup/mongodump\-2011\-10\-24\fP, to a database
running on port \fB37017\fP on the host
\fBmongodb1.example.net\fP\&. The \fBmongorestore\fP command authenticates to
the MongoDB instance using the username \fBuser\fP and the
password \fBpass\fP, as follows:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
mongorestore \-\-host mongodb1.example.net \-\-port 37017 \-\-username user \-\-password pass /opt/backup/mongodump\-2011\-10\-24
.ft P
.fi
.UNINDENT
.UNINDENT
.SH AUTHOR
MongoDB Documentation Project
.SH COPYRIGHT
2011-2013, MongoDB, Inc.
.\" Generated by docutils manpage writer.
.