Skip to content

DOCS-1557 sasl lib change for 2.4.4 #1029

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-1557 sasl lib change for 2.4.4 #1029

Show file tree
Hide file tree
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
10 changes: 9 additions & 1 deletion source/release-notes/2.4.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -136,6 +136,15 @@ MongoDB using Kerberos:

.. see:: :doc:`MongoDB Security Practices and Procedures </security>`.

.. _2.4.4-sasl-change:

SASL Library Change
~~~~~~~~~~~~~~~~~~~

In 2.4.4, MongoDB Enterprise uses Cyrus SASL. Earlier 2.4 Enterprise
versions use GNU SASL (``libgsasl``). See
:doc:`/tutorial/install-mongodb-enterprise` for all dependency details.

Role Based Access Control and New Privilege Documents
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Expand All @@ -161,7 +170,6 @@ MongoDB distribution that supports SSL, and your client driver must
support SSL. See :doc:`/tutorial/configure-ssl` for more
information.


.. _2.4-unique-users:

Compatibility Change: User Uniqueness Enforced
Expand Down
53 changes: 48 additions & 5 deletions source/tutorial/install-mongodb-enterprise.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,16 +11,59 @@ Install MongoDB Enterprise
four platforms and contains support for several features related to
security and monitoring.

.. _required-packages:

Required Packages
-----------------

.. versionchanged:: 2.4
MongoDB Enterprise requires ``libgsasl``.
.. versionchanged:: 2.4.4
MongoDB Enterprise uses Cyrus SASL instead of GNU SASL.
Earlier 2.4 Enterprise versions use GNU SASL (``libgsasl``) instead.
For required packages for the earlier 2.4 versions, see
:ref:`earlier-2.4-versions`.

To use MongoDB Enterprise, you must install several
prerequisites. The names of the packages vary by distribution and are
as follows:

- Debian or Ubuntu 12.04 require: ``libssl0.9.8``, ``snmp``, ``snmpd``,
``cyrus-sasl2-dbg``, ``cyrus-sasl2-mit-dbg``, ``libsasl2-2``,
``libsasl2-dev``, ``libsasl2-modules``, and
``libsasl2-modules-gssapi-mit``. Issue a command such as the
following to install these packages:

.. code-block:: sh

sudo apt-get install libssl0.9.8 snmp snmpd cyrus-sasl2-dbg cyrus-sasl2-mit-dbg libsasl2-2 libsasl2-dev libsasl2-modules libsasl2-modules-gssapi-mit

- CentOS, Red Hat Enterprise Linux 6.x series and Amazon Linux AMI
require: ``libssl``, ``net-snmp``, ``net-snmp-libs``,
``net-snmp-utils``, ``cyrus-sasl``, ``cyrus-sasl-lib``,
``cyrus-sasl-devel``, and ``cyrus-sasl-gssapi``. Issue a command such
as the following to install these packages:

.. code-block:: sh

sudo yum install libssl net-snmp net-snmp-libs net-snmp-utils cyrus-sasl cyrus-sasl-lib cyrus-sasl-devel cyrus-sasl-gssapi

- SUSE Enterprise Linux requires ``libopenssl0_9_8``, ``libsnmp15``,
``slessp1-libsnmp15``, ``snmp-mibs``, ``cyrus-sasl``,
``cyrus-sasl-devel``, and ``cyrus-sasl-gssapi``. Issue a command such
as the following to install these packages:

.. code-block:: sh

sudo zypper install libopenssl0_9_8 libsnmp15 slessp1-libsnmp15 snmp-mibs cyrus-sasl cyrus-sasl-devel cyrus-sasl-gssapi

.. _earlier-2.4-versions:

Earlier 2.4 Versions
~~~~~~~~~~~~~~~~~~~~

Before version 2.4.4, the 2.4 versions of MongoDB Enterprise use
`libgsasl <http://www.gnu.org/software/gsasl/>`_. The required packages
for the different distributions are as follows:

- Ubuntu 12.04 requires ``libssl0.9.8``, ``libgsasl``,
``snmp``, and ``snmpd``. Issue a command such as the following to
install these packages:
Expand Down Expand Up @@ -58,9 +101,9 @@ as follows:

.. note::

For the 2.4 release, the MongoDB Enterprise for SUSE requires
`libgsasl <http://www.gnu.org/software/gsasl/>`_ which is not
available in the default repositories for SUSE.
Before 2.4.4, MongoDB Enterprise 2.4 for SUSE
requires `libgsasl <http://www.gnu.org/software/gsasl/>`_ which is
not available in the default repositories for SUSE.

Install MongoDB Enterprise Binaries
-----------------------------------
Expand Down