Skip to content

DOCS-2745 Reference new split packages #1615

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

Closed
wants to merge 1 commit into from
Closed
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
73 changes: 56 additions & 17 deletions source/tutorial/install-mongodb-on-debian.txt
Original file line number Diff line number Diff line change
Expand Up @@ -19,9 +19,36 @@ MongoDB packages are generally more up to date.
Package Options
---------------

The downloads repository provides the ``mongodb-10gen`` package,
which contains the latest **stable** release. Additionally you can
:ref:`install previous releases <install-debian-version-pinning>` of MongoDB.
The MongoDB package repository contains five packages:

- ``mongodb-org``

This package is a ``metapackage`` that will automatically install
the four component packages listed below.

- ``mongodb-org-server``

This package contains the :program:`mongod` daemon and associated
configuration and init scripts.

- ``mongodb-org-mongos``

This package contains the :program:`mongos` daemon.

- ``mongodb-org-shell``

This package contains the :program:`mongo` shell.

- ``mongodb-org-tools``

This package contains the following MongoDB tools: :program:`mongoimport`
:program:`bsondump`, :program:`mongodump`, :program:`mongoexport`,
:program:`mongofiles`, :program:`mongoimport`, :program:`mongooplog`,
:program:`mongoperf`, :program:`mongorestore`, :program:`mongostat`,
and :program:`mongotop`.

Additionally you can :ref:`install previous releases <install-debian-version-pinning>`
of MongoDB.

You cannot install this package concurrently with the ``mongodb``,
``mongodb-server``, or ``mongodb-clients`` packages that
Expand All @@ -47,7 +74,7 @@ MongoDB:

.. code-block:: sh

sudo apt-get install mongodb-10gen
sudo apt-get install mongodb-org

When this command completes, you have successfully installed MongoDB!

Expand All @@ -56,25 +83,37 @@ When this command completes, you have successfully installed MongoDB!
Manage Installed Versions
~~~~~~~~~~~~~~~~~~~~~~~~~

You can use the ``mongodb-10gen`` package to install previous versions
of MongoDB. To install a specific release, append the version number
to the package name, as in the following example:
You can use these packages to install specific versions of MongoDB.
To install a specific release, you must specify the component packages
individually and append the version number to the package name, as in
the following example:

.. code-block:: sh

apt-get install mongodb-10gen=2.2.3
apt-get install mongodb-org=2.6.1 mongodb-org-server=2.6.1 mongodb-org-shell=2.6.1 mongodb-org-mongos=2.6.1 mongodb-org-tools=2.6.1

This will install the ``2.2.3`` release of MongoDB. You can specify
any available version of MongoDB; however ``apt-get`` **will** upgrade
the ``mongodb-10gen`` package when a newer version becomes available. Use
the following *pinning* procedure to prevent unintended upgrades.
This will install the ``2.6.1`` release of MongoDB. You can specify
any available version and package of MongoDB; however ``apt-get``
**will** upgrade the packages when newer versions become available.
Use the following *pinning* procedure to prevent unintended upgrades.

To pin a package, issue the following command at the system prompt to
*pin* the version of MongoDB at the currently installed version:

.. code-block:: sh

echo "mongodb-10gen hold" | sudo dpkg --set-selections
echo "mongodb-org hold" | sudo dpkg --set-selections
echo "mongodb-org-server hold" | sudo dpkg --set-selections
echo "mongodb-org-shell hold" | sudo dpkg --set-selections
echo "mongodb-org-mongos hold" | sudo dpkg --set-selections
echo "mongodb-org-tools hold" | sudo dpkg --set-selections

.. note::

Previous versions of :term:`MongoDB` packages use different naming
conventions. See the :v2.4:`2.4 version of documentation for more
information </tutorial/install-mongodb-on-linux>`.


Control Scripts
---------------
Expand All @@ -93,10 +132,10 @@ Issue the following command to start :program:`mongod`:

.. code-block:: sh

sudo /etc/init.d/mongodb start
sudo /etc/init.d/mongod start

You can verify that :program:`mongod` has started successfully by checking the
contents of the log file at ``/var/log/mongodb/mongodb.log``.
contents of the log file at ``/var/log/mongodb/mongod.log``.

Stop MongoDB
~~~~~~~~~~~~
Expand All @@ -105,7 +144,7 @@ Issue the following command to stop :program:`mongod`:

.. code-block:: sh

sudo /etc/init.d/mongodb stop
sudo /etc/init.d/mongod stop

Restart MongoDB
~~~~~~~~~~~~~~~
Expand All @@ -114,4 +153,4 @@ Issue the following command to restart :program:`mongod`:

.. code-block:: sh

sudo /etc/init.d/mongodb restart
sudo /etc/init.d/mongod restart
Original file line number Diff line number Diff line change
Expand Up @@ -13,24 +13,33 @@ MongoDB packages are generally more up to date.
Packages
--------

The MongoDB downloads repository contains two packages:
The MongoDB package repository contains five packages:

- ``mongo-10gen-server``
- ``mongodb-org``

This package contains the :program:`mongod` and :program:`mongos`
daemons from the latest **stable** release and associated
configuration and init scripts. Additionally, you can use this
package to :ref:`install daemons from a previous release
<install-rhel-version-pinning>` of MongoDB.
This package is a ``metapackage`` that will automatically install
the four component packages listed below.

- ``mongo-10gen``
- ``mongodb-org-server``

This package contains all MongoDB tools from the latest **stable**
release. Additionally, you can use this package to :ref:`install
tools from a previous release <install-rhel-version-pinning>` of
MongoDB. Install this package on all production MongoDB hosts and
optionally on other systems from which you may need to administer
MongoDB systems.
This package contains the :program:`mongod` daemon and associated
configuration and init scripts.

- ``mongodb-org-mongos``

This package contains the :program:`mongos` daemon.

- ``mongodb-org-shell``

This package contains the :program:`mongo` shell.

- ``mongodb-org-tools``

This package contains the following MongoDB tools: :program:`mongoimport`
:program:`bsondump`, :program:`mongodump`, :program:`mongoexport`,
:program:`mongofiles`, :program:`mongoimport`, :program:`mongooplog`,
:program:`mongoperf`, :program:`mongorestore`, :program:`mongostat`,
and :program:`mongotop`.

Install MongoDB
---------------
Expand Down Expand Up @@ -69,11 +78,11 @@ Install Packages
~~~~~~~~~~~~~~~~

Issue the following command (as ``root`` or with ``sudo``) to install
the latest stable version of MongoDB and the associated tools:
the latest stable version of MongoDB and associated tools:

.. code-block:: sh

yum install mongo-10gen mongo-10gen-server
yum install mongodb-org

When this command completes, you have successfully installed MongoDB!

Expand All @@ -82,27 +91,32 @@ When this command completes, you have successfully installed MongoDB!
Manage Installed Versions
~~~~~~~~~~~~~~~~~~~~~~~~~

You can use the ``mongo-10gen`` and ``mongo-10gen-server`` packages to
install previous releases of MongoDB. To install a specific release, append the
version number, as in the following example:
You can use these packages to install specific releases of MongoDB.
To install a specific release, you must specify the component packages
individually and append the version number to the package names,
as in the following example:

.. code-block:: sh

yum install mongo-10gen-2.2.3 mongo-10gen-server-2.2.3
yum install mongodb-org-2.6.1 mongodb-org-server-2.6.1 mongodb-org-shell-2.6.1 mongodb-org-mongos-2.6.1 mongodb-org-tools-2.6.1

This installs the ``mongo-10gen`` and ``mongo-10gen-server`` packages
with the ``2.2.3`` release. You can specify any available version of
MongoDB; however ``yum`` **will** upgrade the ``mongo-10gen`` and
``mongo-10gen-server`` packages when a newer version becomes
available. Use the following *pinning* procedure to prevent unintended
upgrades.
This will install the ``2.6.1`` release of MongoDB. You can specify
any available version of MongoDB; however ``yum`` **will** upgrade the
packages when a newer version becomes available. Use the following
*pinning* procedure to prevent unintended upgrades.

To pin a package, add the following line to your ``/etc/yum.conf``
file:

.. code-block:: ini

exclude=mongo-10gen,mongo-10gen-server
exclude=mongodb-org,mongodb-org-server,mongodb-org-shell,mongodb-org-mongos,mongodb-org-tools

.. note::

Previous versions of :term:`MongoDB` packages use different naming
conventions. See the :v2.4:`2.4 version of documentation for more
information </tutorial/install-mongodb-on-linux>`.

Control Scripts
---------------
Expand Down
69 changes: 53 additions & 16 deletions source/tutorial/install-mongodb-on-ubuntu.txt
Original file line number Diff line number Diff line change
Expand Up @@ -18,9 +18,36 @@ are generally more up to date.
Package Options
---------------

The MongoDB downloads repository provides the ``mongodb-org`` package,
which contains the latest **stable** release. Additionally you can
:ref:`install previous releases <install-ubuntu-version-pinning>` of MongoDB.
The MongoDB package repository contains five packages:

- ``mongodb-org``

This package is a ``metapackage`` that will automatically install
the four component packages listed below.

- ``mongodb-org-server``

This package contains the :program:`mongod` daemon and associated
configuration and init scripts.

- ``mongodb-org-mongos``

This package contains the :program:`mongos` daemon.

- ``mongodb-org-shell``

This package contains the :program:`mongo` shell.

- ``mongodb-org-tools``

This package contains the following MongoDB tools: :program:`mongoimport`
:program:`bsondump`, :program:`mongodump`, :program:`mongoexport`,
:program:`mongofiles`, :program:`mongoimport`, :program:`mongooplog`,
:program:`mongoperf`, :program:`mongorestore`, :program:`mongostat`,
and :program:`mongotop`.

Additionally you can :ref:`install previous releases <install-ubuntu-version-pinning>`
of MongoDB.

You cannot install this package concurrently with the ``mongodb``,
``mongodb-server``, or ``mongodb-clients`` packages provided by Ubuntu.
Expand Down Expand Up @@ -71,26 +98,36 @@ Continue for configuration and start-up suggestions.
Manage Installed Versions
~~~~~~~~~~~~~~~~~~~~~~~~~

You can use the ``mongodb-org`` package to install previous versions
of MongoDB. To install a specific release, append the version number
to the package name, as in the following example:
You can use these packages to install specific versions of MongoDB.
To install a specific release, you must specify the component packages
individually and append the version number to the package name, as in
the following example:

.. code-block:: sh

apt-get install mongodb-org=2.2.3
apt-get install mongodb-org=2.6.1 mongodb-org-server=2.6.1 mongodb-org-shell=2.6.1 mongodb-org-mongos=2.6.1 mongodb-org-tools=2.6.1

This will install the ``2.2.3`` release of MongoDB. You can specify
any available version of MongoDB; however ``apt-get`` **will** upgrade
the ``mongodb-org`` package when a newer version becomes
available. Use the following *pinning* procedure to prevent unintended
upgrades.
This will install the ``2.6.1`` release of MongoDB. You can specify
any available version and package of MongoDB; however ``apt-get``
**will** upgrade the packages when newer versions become available.
Use the following *pinning* procedure to prevent unintended upgrades.

To pin a package, issue the following command at the system prompt to
*pin* the version of MongoDB at the currently installed version:

.. code-block:: sh

echo "mongodb-org hold" | sudo dpkg --set-selections
echo "mongodb-org-server hold" | sudo dpkg --set-selections
echo "mongodb-org-shell hold" | sudo dpkg --set-selections
echo "mongodb-org-mongos hold" | sudo dpkg --set-selections
echo "mongodb-org-tools hold" | sudo dpkg --set-selections

.. note::

Previous versions of :term:`MongoDB` packages use different naming
conventions. See the :v2.4:`2.4 version of documentation for more
information </tutorial/install-mongodb-on-linux>`.

Control Scripts
---------------
Expand All @@ -111,10 +148,10 @@ command:

.. code-block:: sh

sudo service mongodb start
sudo service mongod start

You can verify that :program:`mongod` has started successfully by checking the
contents of the log file at ``/var/log/mongodb/mongodb.log``.
contents of the log file at ``/var/log/mongodb/mongod.log``.

Stop MongoDB
~~~~~~~~~~~~
Expand All @@ -124,7 +161,7 @@ following command:

.. code-block:: sh

sudo service mongodb stop
sudo service mongod stop

Restart MongoDB
~~~~~~~~~~~~~~~
Expand All @@ -134,4 +171,4 @@ following command:

.. code-block:: sh

sudo service mongodb restart
sudo service mongod restart