Skip to content

Commit 41a64b1

Browse files
ajhuh-mdbajhuh-mdb
authored
DOCSP-27248 Distinguish Intel and Apple Silicon versions in MacOS Installation (#2431)
* DOCSP-27248 Distinguish Intel and Apple Silicon versions in MacOS Installation * swap m1 for apple silicon + update intro sentence * re-swap to be consistent with other installation pages * edit enterprise * move stepfiles into procedure directives * update enterprise links * move enterprise arm steps to procedure directive * fix include link * move steps to procedure directives + extracts * rename extracts, move download link above sub-steps * fix header of step 3 * remove yaml and move to includes * fix include links for ensuring binaries in path * remove extracts that aren't needed * edit tense + move to include * DM edits * fix include typos
1 parent b8920f6 commit 41a64b1

12 files changed

+150
-68
lines changed

‎source/includes/automatically-unzipped-tar-files.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
If your web browser automatically unzips the file as part of the download, the
2+
file ends in ``.tar`` instead.

‎source/includes/ensure-binaries-in-path.rst

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
The MongoDB binaries are in the ``bin/`` directory of the tarball. You can
2+
either:
3+
4+
- Copy the binaries into a directory listed in your ``PATH`` variable, such as
5+
``/usr/local/bin`` (Update ``/path/to/the/mongodb-directory/`` with your
6+
installation directory as appropriate)
7+
8+
.. code-block:: bash
9+
10+
sudo cp /path/to/the/mongodb-directory/bin/* /usr/local/bin/
11+
12+
- Create symbolic links to the binaries from a directory listed in your ``PATH``
13+
variable, such as ``/usr/local/bin`` (Update
14+
``/path/to/the/mongodb-directory/`` with your installation directory as
15+
appropriate):
16+
17+
.. code-block:: bash
18+
19+
sudo ln -s /path/to/the/mongodb-directory/bin/* /usr/local/bin/

‎source/includes/install-mongodb-enterprise-on-os-x-m1.rst

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
.. procedure::
2+
:style: normal
3+
4+
.. step:: Download the tarball.
5+
6+
.. include:: /includes/macos-install-download-tarball-m1.rst
7+
8+
.. step:: Extract the files from the downloaded archive.
9+
10+
.. code-block:: sh
11+
12+
tar -zxvf mongodb-macos-arm64-enterprise-{+version+}.tgz
13+
14+
.. include:: /includes/automatically-unzipped-tar-files.rst
15+
16+
.. step:: Ensure the binaries are in a directory listed in your ``PATH`` environment variable.
17+
18+
.. include:: /includes/ensure-binaries-in-path.rst

‎source/includes/install-mongodb-enterprise-on-os-x.rst

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
.. procedure::
2+
:style: normal
3+
4+
.. step:: Download the tarball.
5+
6+
.. include:: /includes/macos-install-download-tarball-intel.rst
7+
8+
.. step:: Extract the files from the downloaded archive.
9+
10+
.. code-block:: sh
11+
12+
tar -zxvf mongodb-macos-x86_64-enterprise-{+version+}.tgz
13+
14+
.. include:: /includes/automatically-unzipped-tar-files.rst
15+
16+
.. step:: Ensure the binaries are in a directory listed in your ``PATH`` environment variable.
17+
18+
.. include:: /includes/ensure-binaries-in-path.rst

‎source/includes/install-mongodb-on-osx-m1-manually.rst

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
.. procedure::
2+
:style: normal
3+
4+
.. step:: Download the tarball.
5+
6+
.. include:: /includes/macos-install-download-tarball-m1.rst
7+
8+
.. step:: Extract the files from the downloaded archive.
9+
10+
.. code-block:: sh
11+
12+
tar -zxvf mongodb-macos-arm64-{+version+}.tgz
13+
14+
.. include:: /includes/automatically-unzipped-tar-files.rst
15+
16+
.. step:: Ensure the binaries are in a directory listed in your ``PATH`` environment variable.
17+
18+
.. include:: /includes/ensure-binaries-in-path.rst

‎source/includes/install-mongodb-on-osx-manually.rst

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
.. procedure::
2+
:style: normal
3+
4+
.. step:: Download the tarball.
5+
6+
.. include:: /includes/macos-install-download-tarball-intel.rst
7+
8+
.. step:: Extract the files from the downloaded archive.
9+
10+
.. code-block:: sh
11+
12+
tar -zxvf mongodb-macos-x86_64-{+version+}.tgz
13+
14+
.. include:: /includes/automatically-unzipped-tar-files.rst
15+
16+
.. step:: Ensure the binaries are in a directory listed in your ``PATH`` environment variable.
17+
18+
.. include:: /includes/ensure-binaries-in-path.rst

‎source/includes/macos-install-download-tarball-intel.rst

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
Download the MongoDB |edition| ``tgz`` tarball from the following link:
2+
3+
|arrow| |mdb-download-link|
4+
5+
.. procedure::
6+
:style: connected
7+
8+
.. step:: In the :guilabel:`Version` dropdown, select the version of
9+
MongoDB to download.
10+
11+
.. step:: In the :guilabel:`Platform` dropdown, select :guilabel:`macOS`.
12+
13+
.. step:: In the :guilabel:`Package` dropdown, select :guilabel:`tgz`.
14+
15+
.. step:: Click :guilabel:`Download`.

‎source/includes/macos-install-download-tarball-m1.rst

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
Download the MongoDB |edition| ``tgz`` tarball from the following link:
2+
3+
|arrow| |mdb-download-link|
4+
5+
.. procedure::
6+
:style: connected
7+
8+
.. step:: In the :guilabel:`Version` dropdown, select the version of MongoDB
9+
to download.
10+
11+
.. step:: In the :guilabel:`Platform` dropdown, select
12+
:guilabel:`macOS ARM 64`.
13+
14+
.. step:: In the :guilabel:`Package` dropdown, select :guilabel:`tgz`.
15+
16+
.. step:: Click :guilabel:`Download`.

‎source/includes/steps-install-mongodb-enterprise-on-os-x.yaml

Lines changed: 0 additions & 25 deletions
This file was deleted.

‎source/includes/steps-install-mongodb-on-osx-manually.yaml

Lines changed: 0 additions & 37 deletions
This file was deleted.

‎source/tutorial/install-mongodb-enterprise-on-os-x.txt

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -57,10 +57,20 @@ Production Notes
5757
Install MongoDB Enterprise Edition
5858
----------------------------------
5959

60-
Follow these steps to manually install MongoDB |edition| Edition from
61-
the ``.tgz``.
60+
To manually install MongoDB |edition| Edition from the ``.tgz``, select the tab
61+
that corresponds with your Mac's processor and complete the following steps:
6262

63-
.. include:: /includes/steps/install-mongodb-enterprise-on-os-x.rst
63+
.. tabs::
64+
65+
.. tab:: Intel
66+
:tabid: intel
67+
68+
.. include:: /includes/install-mongodb-enterprise-on-os-x.rst
69+
70+
.. tab:: Apple M1
71+
:tabid: apple
72+
73+
.. include:: /includes/install-mongodb-enterprise-on-os-x-m1.rst
6474

6575
Run MongoDB Enterprise Edition
6676
------------------------------

‎source/tutorial/install-mongodb-on-os-x-tarball.txt

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -61,10 +61,20 @@ Production Notes
6161
Install MongoDB Community Edition
6262
---------------------------------
6363

64-
Follow these steps to manually install MongoDB |edition| Edition from
65-
the ``.tgz``.
64+
To manually install MongoDB |edition| Edition from the ``.tgz``, select the tab
65+
that corresponds with your Mac's processor and complete the following steps:
6666

67-
.. include:: /includes/steps/install-mongodb-on-osx-manually.rst
67+
.. tabs::
68+
69+
.. tab:: Intel
70+
:tabid: intel
71+
72+
.. include:: /includes/install-mongodb-on-osx-manually.rst
73+
74+
.. tab:: Apple M1
75+
:tabid: apple
76+
77+
.. include:: /includes/install-mongodb-on-osx-m1-manually.rst
6878

6979
Run MongoDB Community Edition
7080
-----------------------------

0 commit comments

Comments
 (0)