Skip to content

Commit 3b9f277

Browse files
jason-price-mongodbjason-price-mongodb
jason-price-mongodb
and
jason-price-mongodb
authored
DOCS-15299 fips mode legacy shell install (#215)
* DOCS-15299-fips-mode-legacy-shell-install * DOCS-15299-fips-mode-legacy-shell-install * DOCS-15299-fips-mode-legacy-shell-install * DOCS-15299-fips-mode-legacy-shell-install * DOCS-15299-fips-mode-legacy-shell-install * DOCS-15299-fips-mode-legacy-shell-install * DOCS-15299-fips-mode-legacy-shell-install) * DOCS-15299-fips-mode-legacy-shell-install * DOCS-15299-fips-mode-legacy-shell-install * DOCS-15299-fips-mode-legacy-shell-install * DOCS-15299-fips-mode-legacy-shell-install * DOCS-15299-fips-mode-legacy-shell-install * DOCS-15299-fips-mode-legacy-shell-install * DOCS-15299-fips-mode-legacy-shell-install * DOCS-15299-FIPS-mode-legacy-shell * DOCS-15299-FIPS-mode-legacy-shell * DOCS-15299-FIPS-mode-legacy-shell Co-authored-by: jason-price-mongodb <[email protected]>
1 parent e6b9c26 commit 3b9f277

File tree

4 files changed

+66
-5
lines changed

4 files changed

+66
-5
lines changed

‎source/includes/steps-install-shell-base.yaml

Lines changed: 24 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,21 +11,39 @@ title: "Download the ``mongosh`` installation archive for your
1111
operating system."
1212
ref: download-archive
1313
level: 4
14+
content: |
15+
16+
Download the appropriate version of ``mongosh`` for your operating
17+
system. MongoDB also provides versions of ``mongosh`` that use the
18+
system's OpenSSL installation. For details, see the `MongoDB Download
19+
Center <https://www.mongodb.com/try/download/shell?jmp=docs>`__.
1420
---
1521
title: "Extract the files from the downloaded archive."
1622
ref: extract-archive
1723
level: 4
1824
content: |
1925
20-
Run the following command from the directory containing the
21-
``mongosh`` ``.tgz`` package:
26+
Extract the files from the downloaded archive. For example, run the
27+
following command from the directory containing the downloaded
28+
``.tgz`` package:
2229
2330
.. code-block:: sh
2431
2532
tar -zxvf mongosh-{+version+}-linux-x64.tgz
2633
34+
You will need to provide your exact ``.tgz`` package in the command,
35+
which may vary depending on the package version you downloaded. For
36+
example, the ``mongosh`` OpenSSL 3 package is:
37+
38+
.. code-block:: sh
39+
40+
mongosh-{+version+}-linux-x64-openssl3.tgz
41+
2742
The extracted ``bin`` folder contains two binaries: ``mongosh`` and
2843
``mongosh_csfle_v1.so``.
44+
45+
For ``mongosh`` packages that support OpenSSL, you will see a
46+
different ``.so`` file. For example, ``mongosh_crypt_v1.so``.
2947
3048
If your web browser automatically extracts the archive as part of the
3149
download or you extract the archive without the ``tar`` command,
@@ -53,6 +71,10 @@ content: |
5371
sudo cp mongosh /usr/local/bin/
5472
sudo cp mongosh_csfle_v1.so /usr/local/lib/
5573
74+
For ``mongosh`` packages that support OpenSSL, you will see a
75+
different ``.so`` file. For example, ``mongosh_crypt_v1.so``. Use
76+
that file instead in the previous command.
77+
5678
- Create symbolic links to the ``MongoDB Shell``. Switch to the
5779
directory where you extracted the files from the ``.tgz`` archive.
5880
Run the following command to create links to a directory already

‎source/includes/steps-install-shell-linux-deb.yaml

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -98,6 +98,22 @@ content: |
9898
9999
.. code-block:: sh
100100
101-
sudo apt-get install -y mongodb-mongosh
101+
sudo apt-get install -y mongodb-mongosh
102+
103+
MongoDB also provides versions of ``mongosh`` that use your system's
104+
OpenSSL library.
105+
106+
To install ``mongosh`` that uses OpenSSL 1.1, issue the following
107+
command:
102108
109+
.. code-block:: sh
110+
111+
sudo apt-get install -y mongodb-mongosh-shared-openssl11
112+
113+
To install ``mongosh`` that uses OpenSSL 3.0, issue the following
114+
command:
115+
116+
.. code-block:: sh
117+
118+
sudo apt-get install -y mongodb-mongosh-shared-openssl3
103119
...

‎source/includes/steps-install-shell-linux-generic.yaml

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,12 @@ ref: navigate-dlc-generic-linux
77
title: "Download the Linux 64-bit ``.tgz`` package."
88
ref: download-archive-rhel
99
level: 4
10+
content: |
11+
12+
Download the appropriate version of ``mongosh`` for your operating
13+
system. MongoDB also provides versions of ``mongosh`` that use the
14+
system's OpenSSL installation. For details, see the `MongoDB Download
15+
Center <https://www.mongodb.com/try/download/shell?jmp=docs>`__.
1016
---
1117
source:
1218
file: steps-install-shell-base.yaml

‎source/includes/steps-install-shell-linux-rpm.yaml

Lines changed: 19 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -63,10 +63,27 @@ level: 4
6363
ref: install
6464
content: |
6565
66-
To install the latest stable version of ``mongosh``, issue the following
67-
command:
66+
To install the latest stable version of ``mongosh``, issue the
67+
following command:
6868
6969
.. code-block:: sh
7070
7171
sudo yum install -y mongodb-mongosh
72+
73+
MongoDB also provides versions of ``mongosh`` that use your system's
74+
OpenSSL library.
75+
76+
To install ``mongosh`` that uses OpenSSL 1.1, issue the following
77+
command:
78+
79+
.. code-block:: sh
80+
81+
sudo yum install -y mongodb-mongosh-shared-openssl11
82+
83+
To install ``mongosh`` that uses OpenSSL 3.0, issue the following
84+
command:
85+
86+
.. code-block:: sh
87+
88+
sudo yum install -y mongodb-mongosh-shared-openssl3
7289
...

0 commit comments

Comments
 (0)