Skip to content

DOCS-4778: Tweak 3.0 upgrade guide #2185

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.

Sign up for GitHub

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

Closed
wants to merge 1 commit into from
Closed

DOCS-4778: Tweak 3.0 upgrade guide #2185

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
49 changes: 13 additions & 36 deletions source/release-notes/3.0-upgrade.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ Before upgrading MongoDB, always test your application in a staging
environment before deploying the upgrade to your production
environment.

Some changes in MongoDB 2.6 require manual checks and intervention.
Some changes in MongoDB 3.0 require manual checks and intervention.
Before beginning your upgrade, see the
:doc:`/release-notes/3.0-compatibility` document to ensure that your
applications and deployments are compatible with MongoDB 3.0. Resolve
Expand All @@ -55,36 +55,6 @@ If you upgrade to 3.0 and have run :dbcommand:`authSchemaUpgrade`, you
restoring a pre-upgrade backup, as :dbcommand:`authSchemaUpgrade`
discards the ``MONGODB-CR`` credentials used in 2.6.

Package Upgrades
~~~~~~~~~~~~~~~~

If you installed MongoDB from the MongoDB ``apt`` or ``yum`` repositories,
upgrade to 3.0 using the package manager.

For Debian, Ubuntu, and related operating systems, type these commands:

.. code-block:: javascript

sudo apt-get update
sudo apt-get install mongodb-org

For Red Hat Enterprise, CentOS, Fedora, or Amazon Linux:

.. code-block:: javascript

sudo yum install mongodb-org

If you did not install the ``mongodb-org`` package, and installed a subset
of MongoDB components replace ``mongodb-org`` in the commands above with
the appropriate package names.

See installation instructions for :doc:`Ubuntu
</tutorial/install-mongodb-on-ubuntu>`, :doc:`RHEL
</tutorial/install-mongodb-on-red-hat>`,
:doc:`Debian </tutorial/install-mongodb-on-debian>`, or :doc:`other Linux
Systems </tutorial/install-mongodb-on-linux>` for a list of the available
packages and complete MongoDB installation instructions.

Upgrade MongoDB Processes
-------------------------

Expand All @@ -93,14 +63,21 @@ Upgrade MongoDB Processes
Upgrade Standalone ``mongod`` Instance to MongoDB 3.0
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The following steps outline the procedure to upgrade a standalone
:program:`mongod` from version 2.6 to 3.0. To upgrade from version
2.4 to 3.0, :doc:`upgrade to version 2.6</release-notes/2.6-upgrade>`
*first*, and then use the following procedure to upgrade from 2.6 to 3.0.

Upgrade Binaries
````````````````

The following steps outline the procedure to upgrade a standalone
:program:`mongod` from version 2.6 to 3.0. To upgrade from version
2.4 to 3.0, :doc:`upgrade to version 2.6
</release-notes/2.6-upgrade>` *first*, and then follow the procedure to
upgrade from 2.6 to 3.0.
If you installed MongoDB from the MongoDB ``apt``, ``yum``, or ``zypper``
repositories, you should upgrade to 3.0 using your package manager. Follow the
appropriate :doc:`installation instructions</administration/install-on-linux>`
for your Linux system. This will involve adding a repository for the new
release, then performing the actual upgrade.

Otherwise, you can manually upgrade MongoDB:

.. include:: /includes/steps/3.0-upgrade-mongod.rst

Expand Down