Skip to content

DOCS-4621 Updates for new targeted community build packages #2101

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 5 commits 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
4 changes: 4 additions & 0 deletions primer/config/primer-migrations-simple.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,8 @@ sources:
- includes/steps-install-mongodb-on-osx-with-homebrew.yaml
- includes/steps-install-mongodb-on-red-hat-centos-or-fedora-linux.yaml
- includes/steps-install-mongodb-on-ubuntu.yaml
- includes/steps-install-mongodb-on-amazon.yaml
- includes/steps-install-mongodb-on-suse.yaml
- includes/steps-install-mongodb-on-windows.yaml
- includes/steps-run-mongodb-on-a-linux-distribution.yaml
- includes/steps-run-mongodb-on-debian.yaml
Expand All @@ -42,6 +44,8 @@ sources:
- tutorial/install-mongodb-on-linux.txt
- tutorial/install-mongodb-on-os-x.txt
- tutorial/install-mongodb-on-ubuntu.txt
- tutorial/install-mongodb-on-amazon.txt
- tutorial/install-mongodb-on-suse.txt
- includes/driver-table.rst
- includes/fact-id-values-generated.rst
- includes/steps-getting-started-prereq.yaml
Expand Down
2 changes: 2 additions & 0 deletions primer/config/sphinx.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -135,6 +135,8 @@ drivers-base:
- /tutorial/install-mongodb-on-os-x.txt
- /tutorial/install-mongodb-on-red-hat-centos-or-fedora-linux.txt
- /tutorial/install-mongodb-on-ubuntu.txt
- /tutorial/install-mongodb-on-amazon.txt
- /tutorial/install-mongodb-on-suse.txt
- /tutorial/install-mongodb-on-windows.txt
- /tutorial/install-on-linux.txt
java-base:
Expand Down
74 changes: 74 additions & 0 deletions source/includes/steps-install-mongodb-on-amazon.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,74 @@
title: Configure the package management system (YUM).
stepnum: 1
ref: config-yum
pre: |
Create a ``/etc/yum.repos.d/mongodb-org-2.8.repo`` file so that
you can install MongoDB directly, using ``yum``.
action:
- pre: |
Use the following repository file to specify the *latest*
stable release of MongoDB.
language: cfg
code: |
[mongodb-org-2.8]
name=MongoDB Repository
baseurl=http://repo.mongodb.org/yum/amazon/2013.03/mongodb-org/2.8/x86_64/
gpgcheck=0
enabled=1
- pre: |
Use the following repository to install *only* versions of
MongoDB for the ``2.8`` release. If you'd like to install
MongoDB Enterprise packages from a particular :ref:`release
series <release-version-numbers>`, such as 2.4 or 2.6, you can
specify the release series in the repository configuration. For
example, to restrict your system to the 2.6 release series,
create a ``/etc/yum.repos.d/mongodb-org-2.6.repo`` file
to hold the following configuration information for the MongoDB
Enterprise 2.6 repository:
language: cfg
code: |
[mongodb-org-2.6]
name=MongoDB Enterprise 2.6 Repository
baseurl=http://repo.mongodb.org/yum/amazon/2013.03/mongodb-org/2.6/x86_64/
gpgcheck=0
enabled=1
- pre: |
``.repo`` files for each release can also be found `in the repository itself <https://repo.mongodb.org/yum/amazon/>`_.
Remember that odd-numbered minor release versions (e.g. 2.5) are development versions and are unsuitable
for production deployment.

---
title: Install the MongoDB packages and associated tools.
stepnum: 2
ref: install
pre: |
When you install the packages, you choose whether to install the current
release or a previous one. This step provides the commands for both.
action:
- pre: |
To install the latest stable version of MongoDB, issue the following
command:
language: sh
code: |
sudo yum install -y mongodb-org
- pre: |
To install a specific release of MongoDB, specify each
component package individually and append the version number to the
package name, as in the following example that installs the `2.8.1``
release of MongoDB:
language: sh
code: |
sudo yum install -y mongodb-org-2.8.1 mongodb-org-server-2.8.1 mongodb-org-shell-2.8.1 mongodb-org-mongos-2.8.1 mongodb-org-tools-2.8.1
- pre: |
You can specify any available version of MongoDB. However ``yum``
will upgrade the packages when a newer version becomes available. To
prevent unintended upgrades, pin the package. To pin a package, add
the following ``exclude`` directive to your ``/etc/yum.conf`` file:
language: ini
code: |
exclude=mongodb-org,mongodb-org-server,mongodb-org-shell,mongodb-org-mongos,mongodb-org-tools
post: |
Previous versions of MongoDB packages use a different repo location.
See the :v2.6:`2.6 version of documentation for more information
</tutorial/install-mongodb-on-linux>`.
...
2 changes: 1 addition & 1 deletion source/includes/steps-install-mongodb-on-debian.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ action:
Create the list file using the following command:
language: sh
code: |
echo 'deb http://downloads-distro.mongodb.org/repo/debian-sysvinit dist 10gen' | sudo tee /etc/apt/sources.list.d/mongodb.list
echo "deb http://repo.mongodb.org/apt/debian "$(lsb_release -sc)"/mongodb-org/2.8 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-2.8.list
---
stepnum: 3
source:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,28 +2,41 @@ title: Configure the package management system (YUM).
stepnum: 1
ref: config-yum
pre: |
Create a ``/etc/yum.repos.d/mongodb.repo`` file to hold the
following configuration information for the MongoDB repository:
Create a ``/etc/yum.repos.d/mongodb-org-2.8.repo`` file so that
you can install MongoDB directly, using ``yum``.
action:
- pre: |
If you are running a 64-bit system, use the following configuration:
Use the following repository file to specify the *latest*
stable release of MongoDB.
language: cfg
code: |
[mongodb]
[mongodb-org-2.8]
name=MongoDB Repository
baseurl=http://downloads-distro.mongodb.org/repo/redhat/os/x86_64/
baseurl=http://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/2.8/x86_64/
gpgcheck=0
enabled=1
- pre: |
If you are running a 32-bit system, which is not recommended for
production deployments, use the following configuration:
Use the following repository to install *only* versions of
MongoDB for the ``2.8`` release. If you'd like to install
MongoDB Enterprise packages from a particular :ref:`release
series <release-version-numbers>`, such as 2.4 or 2.6, you can
specify the release series in the repository configuration. For
example, to restrict your system to the 2.6 release series,
create a ``/etc/yum.repos.d/mongodb-org-2.6.repo`` file
to hold the following configuration information for the MongoDB
Enterprise 2.6 repository:
language: cfg
code: |
[mongodb]
name=MongoDB Repository
baseurl=http://downloads-distro.mongodb.org/repo/redhat/os/i686/
[mongodb-org-2.6]
name=MongoDB Enterprise 2.6 Repository
baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/2.6/$basearch/
gpgcheck=0
enabled=1
- pre: |
``.repo`` files for each release can also be found `in the repository itself <https://repo.mongodb.org/yum/redhat/>`_.
Remember that odd-numbered minor release versions (e.g. 2.5) are development versions and are unsuitable
for production deployment.

---
title: Install the MongoDB packages and associated tools.
stepnum: 2
Expand All @@ -41,11 +54,11 @@ action:
- pre: |
To install a specific release of MongoDB, specify each
component package individually and append the version number to the
package name, as in the following example that installs the `2.6.1``
package name, as in the following example that installs the `2.8.1``
release of MongoDB:
language: sh
code: |
sudo yum install -y 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
sudo yum install -y mongodb-org-2.8.1 mongodb-org-server-2.8.1 mongodb-org-shell-2.8.1 mongodb-org-mongos-2.8.1 mongodb-org-tools-2.8.1
- pre: |
You can specify any available version of MongoDB. However ``yum``
will upgrade the packages when a newer version becomes available. To
Expand All @@ -55,7 +68,7 @@ action:
code: |
exclude=mongodb-org,mongodb-org-server,mongodb-org-shell,mongodb-org-mongos,mongodb-org-tools
post: |
Previous versions of MongoDB packages use different naming conventions.
See the :v2.4:`2.4 version of documentation for more information
Previous versions of MongoDB packages use a different repo location.
See the :v2.6:`2.6 version of documentation for more information
</tutorial/install-mongodb-on-linux>`.
...
57 changes: 57 additions & 0 deletions source/includes/steps-install-mongodb-on-suse.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
title: Configure the package management system (YUM).
stepnum: 1
ref: config-yum
pre: |
Add the repository so that you can install MongoDB directly, using ``zypper``.
action:
- pre: |
Use the following command to specify the *latest* stable release of MongoDB.
language: sh
code: |
zypper addrepo --no-gpgcheck http://repo.mongodb.org/zypper/suse/11/mongodb-org/2.8/x86_64/ mongodb
- pre: |
Use the following repository for *only* versions of
MongoDB for the ``2.8`` release. If you'd like to install
MongoDB Enterprise packages from a particular :ref:`release
series <release-version-numbers>`, such as 2.6, you can
specify the release series in the repository configuration. For
example, to restrict your system to the 2.6 release series,
use the following comand:
language: sh
code: |
zypper addrepo --no-gpgcheck http://repo.mongodb.org/zypper/suse/11/mongodb-org/2.6/x86_64/ mongodb
---
title: Install the MongoDB packages and associated tools.
stepnum: 2
ref: install
pre: |
When you install the packages, you choose whether to install the current
release or a previous one. This step provides the commands for both.
action:
- pre: |
To install the latest stable version of MongoDB, issue the following
command:
language: sh
code: |
sudo zypper install mongodb-org
- pre: |
To install a specific release of MongoDB, specify each
component package individually and append the version number to the
package name, as in the following example that installs the `2.8.1``
release of MongoDB:
language: sh
code: |
sudo zypper install mongodb-org-2.8.1 mongodb-org-server-2.8.1 mongodb-org-shell-2.8.1 mongodb-org-mongos-2.8.1 mongodb-org-tools-2.8.1
- pre: |
You can specify any available version of MongoDB. However ``zypper``
will upgrade the packages when a newer version becomes available. To
prevent unintended upgrades, pin the packages. To pin the packages, run
the folllowing command:
language: sh
code: |
sudo zypper addlock mongodb-org-2.8.1 mongodb-org-server-2.8.1 mongodb-org-shell-2.8.1 mongodb-org-mongos-2.8.1 mongodb-org-tools-2.8.1
post: |
Previous versions of MongoDB packages use a different repo location.
See the :v2.6:`2.6 version of documentation for more information
</tutorial/install-mongodb-on-linux>`.
...
10 changes: 5 additions & 5 deletions source/includes/steps-install-mongodb-on-ubuntu.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ action:
the following command:
language: sh
code: |
echo 'deb http://downloads-distro.mongodb.org/repo/ubuntu-upstart dist 10gen' | sudo tee /etc/apt/sources.list.d/mongodb.list
echo "deb http://repo.mongodb.org/apt/ubuntu "$(lsb_release -sc)"/mongodb-org/2.8 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-2.8.list
---
title: Reload local package database.
stepnum: 3
Expand Down Expand Up @@ -52,10 +52,10 @@ action:
pre: |
Specify each component package individually and append the
version number to the package name, as in the following example
that installs the ``2.6.1`` release of MongoDB:
that installs the ``2.8.1`` release of MongoDB:
language: sh
code: |
sudo apt-get install -y 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
sudo apt-get install -y mongodb-org=2.8.1 mongodb-org-server=2.8.1 mongodb-org-shell=2.8.1 mongodb-org-mongos=2.8.1 mongodb-org-tools=2.8.1
- heading:
text: Pin a specific version of MongoDB.
character: "'"
Expand All @@ -73,7 +73,7 @@ action:
echo "mongodb-org-mongos hold" | sudo dpkg --set-selections
echo "mongodb-org-tools hold" | sudo dpkg --set-selections
post: |
Previous versions of MongoDB packages use different naming conventions.
See the :v2.4:`2.4 version of documentation for more information
Previous versions of MongoDB packages use a different repo location.
See the :v2.6:`2.6 version of documentation for more information
</tutorial/install-mongodb-on-ubuntu>`.
...
8 changes: 8 additions & 0 deletions source/includes/toc-installation-linux.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,14 @@ file: /tutorial/install-mongodb-on-red-hat-centos-or-fedora-linux
name: Install on Red Hat
description: Install MongoDB on Red Hat Enterprise, CentOS, Fedora and related Linux systems using ``.rpm`` packages.
---
file: /tutorial/install-mongodb-on-suse
name: Install on SUSE
description: Install MongoDB on SUSE Linux systems using ``.rpm`` packages.
---
file: /tutorial/install-mongodb-on-amazon
name: Install on Amazon Linux
description: Install MongoDB on Amazon Linux systems using ``.rpm`` packages.
---
file: /tutorial/install-mongodb-on-ubuntu
name: Install on Ubuntu
description: Install MongoDB on Ubuntu Linux systems using ``.deb`` packages.
Expand Down
2 changes: 2 additions & 0 deletions source/includes/toc-spec-installation-linux-packages.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2,5 +2,7 @@ sources:
- toc-installation-linux.yaml
files:
- /tutorial/install-mongodb-on-red-hat-centos-or-fedora-linux
- /tutorial/install-mongodb-on-suse
- /tutorial/install-mongodb-on-amazon
- /tutorial/install-mongodb-on-ubuntu
- /tutorial/install-mongodb-on-debian
4 changes: 4 additions & 0 deletions source/includes/toc-spec-installation.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,10 @@ files:
level: 1
- file: /tutorial/install-mongodb-on-red-hat-centos-or-fedora-linux
level: 2
- file: /tutorial/install-mongodb-on-amazon
level: 2
- file: /tutorial/install-mongodb-on-suse
level: 2
- file: /tutorial/install-mongodb-on-ubuntu
level: 2
- file: /tutorial/install-mongodb-on-debian
Expand Down
2 changes: 2 additions & 0 deletions source/tutorial.txt
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,8 @@ Getting Started
- :doc:`/tutorial/install-mongodb-on-red-hat-centos-or-fedora-linux`
- :doc:`/tutorial/install-mongodb-on-debian`
- :doc:`/tutorial/install-mongodb-on-ubuntu`
- :doc:`/tutorial/install-mongodb-on-amazon`
- :doc:`/tutorial/install-mongodb-on-suse`
- :doc:`/tutorial/install-mongodb-on-os-x`
- :doc:`/tutorial/install-mongodb-on-windows`
- :doc:`/tutorial/getting-started`
Expand Down
42 changes: 42 additions & 0 deletions source/tutorial/install-mongodb-on-amazon.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
======================================================================
Install MongoDB on Amazon Linux
======================================================================

.. default-domain:: mongodb

Overview
--------

Use this tutorial to install MongoDB on Amazon Linux from ``.rpm``
packages.

.. The following include includes two h2 headers:
.. Packages and Control Scripts

.. |init-script-path| replace:: ``/etc/rc.d/init.d/mongod``

.. include:: /includes/list-mongodb-org-packages.rst

Considerations
--------------

For production deployments, always run MongoDB on 64-bit systems.

.. include:: /includes/fact-installation-bind-ip-default-in-config.rst

.. include:: /includes/note-package-change.rst

Install MongoDB
---------------

.. include:: /includes/steps/install-mongodb-on-amazon.rst

Run MongoDB
-----------

.. |mongod-user| replace:: ``mongod``
.. |mongod-datadir| replace:: ``/var/lib/mongo``

.. include:: /includes/fact-installation-directories.rst

.. include:: /includes/steps/run-mongodb-on-a-linux-distribution.rst
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
======================================================================
Install MongoDB on Red Hat Enterprise, CentOS, Fedora, or Amazon Linux
Install MongoDB on Red Hat Enterprise, CentOS, or Fedora
======================================================================

.. default-domain:: mongodb
Expand Down
Loading