(DOCSP-12582): Add mdbtools note to local mode (#399)

* (DOCSP-12582): Add mdbtools note to local mode

* tech review

* copy review

Author: melissamahoney-mongodb

conf.py

@@ -70,9 +70,10 @@
     'old-version': '4.0.14',
     'old-version-val': '``4.0.14-ent``',
     'old-version-example': '4.0.14-ent',
-     'appdb-init-version' : '1.0.4',
-     'ops-manager-init-version': '1.0.2',
-     'database-init-version': '1.0.0',
+    'appdb-init-version' : '1.0.4',
+    'ops-manager-init-version': '1.0.2',
+    'database-init-version': '1.0.0',
+    'mdbtools-version': '100.1.0'
 }
 
 rst_epilog = '\n'.join([

snooty.toml

@@ -9,3 +9,4 @@ bndl-version-val = "``4.2.2-ent``"
 appdb-init-version = "1.0.4"
 ops-manager-init-version = "1.0.2"
 database-init-version = "1.0.0"
+mdbtools-version = "100.1.0"

source/includes/steps-deploy-k8s-opsmgr-local-mode.yaml

@@ -120,11 +120,11 @@ content: |
 
         #. If you deployed |onprem| 4.4.0 and later, you must also
            download the Ubuntu 16.04 MongoDB Database Tools installation
-           tarball. For example, to download the ``100.1.0`` release:
+           tarball. For example, to download the ``{+mdbtools-version+}`` release:
 
            .. code-block:: sh
 
-              curl -OL https://fastdl.mongodb.org/tools/db/mongodb-database-tools-ubuntu1604-x86_64-100.1.0.tgz
+              curl -OL https://fastdl.mongodb.org/tools/db/mongodb-database-tools-ubuntu1604-x86_64-{+mdbtools-version+}.tgz
 
      .. tab:: OpenShift
         :tabid: os
@@ -139,11 +139,11 @@ content: |
 
         #. If you deployed |onprem| 4.4.0 and later, you must also
            download the RHEL MongoDB Database Tools installation
-           tarball. For example, to download the ``100.1.0`` release:
+           tarball. For example, to download the ``{+mdbtools-version+}`` release:
 
            .. code-block:: sh
 
-              curl -OL https://fastdl.mongodb.org/tools/db/mongodb-database-tools-rhel<version>-x86_64-100.1.0.tgz
+              curl -OL https://fastdl.mongodb.org/tools/db/mongodb-database-tools-rhel<version>-x86_64-{+mdbtools-version+}.tgz
 
 ---
 
@@ -167,7 +167,7 @@ content: |
      .. tab:: Vanilla Kubernetes
         :tabid: k8s
 
-        To copy the MongoDB ``4.2.0`` installation archive to the 
+        To copy the MongoDB installation archive to the 
         |onprem| PersistentVolume:
 
         a. Copy the MongoDB Server installation tarball to the
@@ -188,29 +188,29 @@ content: |
               kubectl cp mongodb-linux-x86_64-ubuntu1604-4.4.0.tgz \ 
               "ops-manager-localmode-1:/mongodb-ops-manager/mongodb-releases/mongodb-linux-x86_64-ubuntu1604-4.4.0.tgz"
 
-        #. If you deployed |onprem| 4.4.0 and later, copy the MongoDB
+        #. If you deployed |onprem| 4.4.0 and later, copy the MongoDB   
            Database Tools installation tarball to the |onprem|
-           PersistentVolume. For example, to copy the ``100.1.0``
-           release:
+           PersistentVolume. For example, to copy the
+           ``{+mdbtools-version+}`` release:
 
            | Replica 0:
 
            .. code-block:: sh
 
-              kubectl cp mongodb-database-tools-ubuntu1604-x86_64-100.1.0.tgz \ 
-              "ops-manager-localmode-0:/mongodb-ops-manager/mongodb-releases/mongodb-database-tools-ubuntu1604-x86_64-100.1.0.tgz"
+              kubectl cp mongodb-database-tools-ubuntu1604-x86_64-{+mdbtools-version+}.tgz \ 
+              "ops-manager-localmode-0:/mongodb-ops-manager/mongodb-releases/mongodb-database-tools-ubuntu1604-x86_64-{+mdbtools-version+}.tgz"
 
            | Replica 1:
 
            .. code-block:: sh
 
-              kubectl cp mongodb-database-tools-ubuntu1604-x86_64-100.1.0.tgz \ 
-              "ops-manager-localmode-1:/mongodb-ops-manager/mongodb-releases/mongodb-database-tools-ubuntu1604-x86_64-100.1.0.tgz"
+              kubectl cp mongodb-database-tools-ubuntu1604-x86_64-{+mdbtools-version+}.tgz \ 
+              "ops-manager-localmode-1:/mongodb-ops-manager/mongodb-releases/mongodb-database-tools-ubuntu1604-x86_64-{+mdbtools-version+}.tgz"
 
      .. tab:: OpenShift
         :tabid: os
 
-        To copy the MongoDB ``4.2.0`` installation archive to the 
+        To copy the MongoDB installation archive to the 
         |onprem| PersistentVolume:
 
         a. Copy the MongoDB Server installation tarball to the 
@@ -231,24 +231,24 @@ content: |
               oc rsync  "ops-manager-localmode-1:/mongodb-ops-manager/mongodb-releases/mongodb-linux-x86_64-rhel<version>-4.4.0.tgz" \ 
               mongodb-linux-x86_64-rhel<version>-4.4.0.tgz
 
-        #. If you deployed |onprem| 4.4.0 and later, copy the MongoDB
+        #. If you deployed |onprem| 4.4.0 and later, copy the MongoDB 
            Database Tools installation tarball to the |onprem|
-           PersistentVolume. For example, to copy the ``100.1.0``
-           release:
+           PersistentVolume. For example, to copy the
+           ``{+mdbtools-version+}`` release:
 
            | Replica 0:
 
            .. code-block:: sh
 
-              kubectl cp mongodb-database-tools-ubuntu1604-x86_64-100.1.0.tgz \ 
-              "ops-manager-localmode-0:/mongodb-ops-manager/mongodb-releases/mongodb-database-tools-ubuntu1604-x86_64-100.1.0.tgz"
+              kubectl cp mongodb-database-tools-ubuntu1604-x86_64-{+mdbtools-version+}.tgz \ 
+              "ops-manager-localmode-0:/mongodb-ops-manager/mongodb-releases/mongodb-database-tools-ubuntu1604-x86_64-{+mdbtools-version+}.tgz"
 
            | Replica 1:
 
            .. code-block:: sh
 
-              kubectl cp mongodb-database-tools-rhel<version>-x86_64-100.1.0.tgz \ 
-              "ops-manager-localmode-1:/mongodb-ops-manager/mongodb-releases/mongodb-database-tools-rhel<version>-x86_64-100.1.0.tgz"
+              kubectl cp mongodb-database-tools-rhel<version>-x86_64-{+mdbtools-version+}.tgz \ 
+              "ops-manager-localmode-1:/mongodb-ops-manager/mongodb-releases/mongodb-database-tools-rhel<version>-x86_64-{+mdbtools-version+}.tgz"
 
 ---
 title: "Deploy a MongoDB Database Resource."

source/tutorial/deploy-om-container-local-mode.txt

@@ -27,8 +27,17 @@ the |onprem| StatefulSet.
 
 This procedure covers uploading installation archives to |onprem|.
 
-Prerequisites and Considerations
---------------------------------
+Considerations
+--------------
+
+When you upgrade the version of an |onprem| resource in Local
+Mode, you must also upgrade to the latest version of the :dl:`MongoDB
+Database Tools <database-tools>`. ``automation.versions.directory``
+specifies the location of the Database Tools, which defaults to
+``/mongodb-ops-manager/mongodb-releases/``.
+
+Prerequisites
+-------------
 
 :ref:`deploy-om-container`. The following procedure shows you how to 
 update your |onprem| |k8s| |k8s-obj| to enable Local Mode.