Skip to content

SERVER-6961 2.2 release notes update re mongodump #219

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Sep 13, 2012
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions source/administration/backups.txt
Original file line number Diff line number Diff line change
Expand Up @@ -426,6 +426,8 @@ the local database instance (e.g. ``127.0.0.1`` or ``localhost``) and
create a database backup in a in the current directory named
``dump/``.

.. include:: /includes/note-mongodump-compatibility-2.2.rst

You can specify database and collection as options to the
:program:`mongodump` command to limit the amount of data included in the
database dump. For example:
Expand Down
5 changes: 5 additions & 0 deletions source/includes/note-mongodump-compatibility-2.2.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
.. note::

If you use the :program:`mongodump` tool from the 2.2 distribution to
create a dump of a database, you can restore that dump only to a 2.2
database.
2 changes: 2 additions & 0 deletions source/reference/mongodump.txt
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,8 @@ effective :doc:`backup strategy </administration/backups>`. Use in
conjunction with :program:`mongorestore` to provide restore
functionality.

.. include:: /includes/note-mongodump-compatibility-2.2.rst

.. seealso:: ":program:`mongorestore`" and ":doc:`/administration/backups`".

Options
Expand Down
20 changes: 16 additions & 4 deletions source/reference/mongorestore.txt
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,21 @@
Synopsis
--------

The :program:`mongorestore` utility provides the ability to import content
from binary database dump into a specific database. This is the
inverse functionality of :program:`mongodump`.
The :program:`mongorestore` tool imports content from binary database
dump into a specific database. :program:`mongorestore` can import
content to an existing database or create a new one.

Specifically, :program:`mongorestore` takes the output from
:program:`mongodump` and restores it. :program:`mongorestore` creates
indexes on a restore. :program:`mongorestore` performs only inserts. If
existing data with the same ``_id`` already exists on the database,
:program:`mongorestore` will not replace it.

The :program:`mongorestore` tool does "fire-n-forget" inserts and does
not perform safe writes. Any errors that might happen during inserts are
recorded only on the server logs and not reported in the tool.

.. include:: /includes/note-mongodump-compatibility-2.2.rst

Options
-------
Expand All @@ -32,7 +44,7 @@ Options

.. option:: --version

Returns the version of the :program:`mongorestore` utility.
Returns the version of the :program:`mongorestore` tool.

.. option:: --host <hostname><:port>

Expand Down
11 changes: 10 additions & 1 deletion source/release-notes/2.2.txt
Original file line number Diff line number Diff line change
Expand Up @@ -254,7 +254,16 @@ running as upserts will only output a ``null`` value.
Previously, in version 2.0 these operations would return an empty
document, e.g. ``{ }``.

See: :issue:`SERVER-6226`.
See: :issue:`SERVER-6226` for more information.

``mongodump`` Can Restore Only to a 2.2 Database
````````````````````````````````````````````````

If you use the :program:`mongodump` tool from the 2.2 distribution to
create a dump of a database, you may only restore that dump to a 2.2
database.

See: :issue:`SERVER-6961` for more information.

Behavioral Changes
~~~~~~~~~~~~~~~~~~
Expand Down