DOCSP-15525 update Manual for mongosh - mongo codeblocks

source/appendix/security/appendixC-openssl-client.txt

@@ -142,7 +142,7 @@ B. Generate the Test PEM File for Client
 
       .. code-block:: javascript
 
-         mongo --tls --host <serverHost> --tlsCertificateKeyFile test-client.pem  --tlsCAFile test-ca.pem
+         mongosh --tls --host <serverHost> --tlsCertificateKeyFile test-client.pem  --tlsCAFile test-ca.pem
 
 
    .. example:: 
@@ -151,7 +151,7 @@ B. Generate the Test PEM File for Client
 
       .. code-block:: javascript
 
-         mongo --ssl --host <serverHost> --sslPEMKeyFile test-client.pem  --sslCAFile test-ca.pem
+         mongosh --ssl --host <serverHost> --sslPEMKeyFile test-client.pem  --sslCAFile test-ca.pem
 
    On macOS, 
       If you are :red:`testing` with Keychain Access to manage certificates,
@@ -172,7 +172,7 @@ B. Generate the Test PEM File for Client
 
       .. code-block:: javascript
 
-         mongo --tls --tlsCertificateSelector subject="<TestClientCertificateCommonName>"
+         mongosh --tls --tlsCertificateSelector subject="<TestClientCertificateCommonName>"
 
       Although still available, :option:`--ssl <mongosh --ssl>` and
       :option:`--sslCertificateSelector <mongosh
@@ -183,7 +183,7 @@ B. Generate the Test PEM File for Client
 
       .. code-block:: javascript
 
-         mongo --ssl --sslCertificateSelector subject="<TestClientCertificateCommonName>"
+         mongosh --ssl --sslCertificateSelector subject="<TestClientCertificateCommonName>"
 
       For adding certificates to Keychain Access, refer to your
       official documentation for Keychain Access.

source/core/retryable-writes.txt

@@ -79,7 +79,7 @@ MongoDB Drivers
 
   .. code-block:: bash
 
-     mongo --retryWrites
+     mongosh --retryWrites
 
 .. _retryable-write-ops:
 

source/core/security-ldap-external.txt

@@ -431,7 +431,7 @@ with LDAP authentication and authorization:
 
 .. code-block:: bash
 
-   mongo --username alice@dba.example.com --password  --authenticationDatabase '$external' --authenticationMechanism "PLAIN"  --host "mongodb.example.com" --port 27017
+   mongosh --username alice@dba.example.com --password  --authenticationDatabase '$external' --authenticationMechanism "PLAIN"  --host "mongodb.example.com" --port 27017
 
 If you do not specify the password to the :option:`-password <mongo
 --password>` command-line option, :mongosh:`mongosh </>`

source/includes/extracts-client-side-field-level-encryption.yaml

@@ -57,7 +57,7 @@ content: |
 
   .. code-block:: bash
 
-     mongo --eval "
+     mongosh --eval "
          var AWS_ACCESS_KEY_ID = '$AWS_ACCESS_KEY_ID'
          var AWS_SECRET_ACCESS_KEY = '$AWS_SECRET_ACCESS_KEY'
        " \
@@ -82,7 +82,7 @@ content: |
 
      TEST_LOCAL_KEY=$(echo "$(head -c 96 /dev/urandom | base64 | tr -d '\n')")
 
-     mongo --nodb --shell --eval "var TEST_LOCAL_KEY='$TEST_LOCAL_KEY'"
+     mongosh --nodb --shell --eval "var TEST_LOCAL_KEY='$TEST_LOCAL_KEY'"
 
   Create the client-side field level encryption object using the
   generated local key string:

source/includes/fact-default-bind-ip.rst

@@ -41,8 +41,8 @@ the hostname  or its associated ip address ``198.51.100.1``:
 
 .. code-block:: none
 
-   mongo --host My-Example-Associated-Hostname
+   mongosh --host My-Example-Associated-Hostname
 
-   mongo --host 198.51.100.1
+   mongosh --host 198.51.100.1
 
 .. end-override

source/includes/steps-authenticate-as-client.yaml

@@ -9,7 +9,7 @@ action:
     example:
   language: javascript
   code: |
-    mongo --username "prodManager" --password "cleartextPassword" --authenticationDatabase "products"
+    mongosh --username "prodManager" --password "cleartextPassword" --authenticationDatabase "products"
 ---
 title: Close the session when your work is complete.
 stepnum: 2

source/includes/steps-change-own-password-and-custom-data-prereq.yaml

@@ -9,7 +9,7 @@ pre: |
 action:
   language: javascript
   code: |
-     mongo --port 27017 -u myUserAdmin -p  --authenticationDatabase 'admin'
+     mongosh --port 27017 -u myUserAdmin -p  --authenticationDatabase 'admin'
   post: |
      If you do not specify the password to the :option:`-p <mongosh -p>`
      command-line option, :mongosh:`mongosh </>` prompts for the

source/includes/steps-change-own-password-and-custom-data.yaml

@@ -11,7 +11,7 @@ action:
     section.
   language: javascript
   code: |
-    mongo --port 27017 -u user123 --authenticationDatabase 'test' -p
+    mongosh --port 27017 -u user123 --authenticationDatabase 'test' -p
 post: |
 
   If you do not specify the password to the :option:`-p <mongosh -p>`

source/includes/steps-configure-ldap-mongodb.yaml

@@ -98,7 +98,7 @@ content: |
 
               .. code-block:: bash
 
-                 mongo --host <host> --authenticationMechanism PLAIN --authenticationDatabase '$external' -u <user> -p
+                 mongosh --host <host> --authenticationMechanism PLAIN --authenticationDatabase '$external' -u <user> -p
 
          - id: authafter
            name: Authenticate after Connection

source/includes/steps-configure-ldap-sasl-activedirectory-authentication.yaml

@@ -301,7 +301,7 @@ pre: |
 
      .. code-block:: bash
 
-        mongo --username sam@DBA.EXAMPLE.COM --password  --authenticationMechanism 'PLAIN' --authenticationDatabase '$external' --host <hostname> --port <port>
+        mongosh --username sam@DBA.EXAMPLE.COM --password  --authenticationMechanism 'PLAIN' --authenticationDatabase '$external' --host <hostname> --port <port>
 
      If you do not specify the password to the :option:`-p <mongosh
      --password>` command-line option, :mongosh:`mongosh </>`

source/includes/steps-connect-with-admin-privileges.yaml

@@ -12,5 +12,5 @@ action:
     :doc:`/tutorial/enable-authentication`.
   language: javascript
   code: |
-    mongo --port 27017 -u myUserAdmin -p 'abc123' --authenticationDatabase 'admin'
+    mongosh --port 27017 -u myUserAdmin -p 'abc123' --authenticationDatabase 'admin'
 ...

source/includes/steps-control-access-to-mongodb-with-kerberos-authentication.yaml

@@ -112,7 +112,7 @@ action:
   - pre: You can connect and authenticate from the command line.
     language: sh
     code: |
-       mongo --host hostname.example.net --authenticationMechanism=GSSAPI --authenticationDatabase='$external' --username application/reporting@EXAMPLE.NET
+       mongosh --host hostname.example.net --authenticationMechanism=GSSAPI --authenticationDatabase='$external' --username application/reporting@EXAMPLE.NET
     post: |
        If you are connecting to a system whose hostname matches the
        Kerberos name, ensure that you specify the fully qualified

source/includes/steps-convert-replica-set-add-new-shard.yaml

@@ -34,7 +34,7 @@ action:
   copyable: true
   language: javascript
   code: |
-    mongo mongodb3.example.net
+    mongosh mongodb3.example.net
 ---
 title: "Initiate the replica set."
 level: 4
@@ -69,7 +69,7 @@ action:
      copyable: true
      language: javascript
      code: |
-        mongo mongodb6.example.net:27017/admin
+        mongosh mongodb6.example.net:27017/admin
 ---
 title:
   text: Add the shard.

source/includes/steps-convert-replica-set-add-shards.yaml

@@ -6,7 +6,7 @@ ref: connect-mongos
 action:
    language: javascript
    code: |
-      mongo mongodb6.example.net:27017/admin
+      mongosh mongodb6.example.net:27017/admin
 ---
 title:
   text: Add the shard.

source/includes/steps-create-admin-then-enable-authentication.yaml

@@ -26,7 +26,7 @@ pre: |
 action:
   language: sh
   code: |
-    mongo --port 27017 
+    mongosh --port 27017 
 post: |
    Specify additional command line options as appropriate to connect
    :mongosh:`mongosh </>` to your deployment, such as ``--host``.
@@ -132,7 +132,7 @@ content: |
 
               .. code-block:: bash
 
-                 mongo --port 27017  --authenticationDatabase "admin" -u "myUserAdmin" -p
+                 mongosh --port 27017  --authenticationDatabase "admin" -u "myUserAdmin" -p
 
               Enter your password when prompted.
 
@@ -145,7 +145,7 @@ content: |
 
               .. code-block:: bash
 
-                 mongo --port 27017
+                 mongosh --port 27017
 
 
               In :mongosh:`mongosh </>`, switch to the
@@ -237,7 +237,7 @@ content: |
 
               .. code-block:: bash
 
-                 mongo --port 27017 -u "myTester" --authenticationDatabase "test" -p
+                 mongosh --port 27017 -u "myTester" --authenticationDatabase "test" -p
 
               Enter the password for the user when prompted.
 
@@ -250,7 +250,7 @@ content: |
 
               .. code-block:: bash
 
-                 mongo --port 27017
+                 mongosh --port 27017
 
               In :mongosh:`mongosh </>`, switch to the
               authentication database (in this case, ``test``), and use

source/includes/steps-csfle-shell-aws-create-key.yaml

@@ -25,7 +25,7 @@ content: |
 
   .. code-block:: bash
 
-      mongo --eval "
+      mongosh --eval "
           var AWS_ACCESS_KEY_ID = '$AWS_ACCESS_KEY_ID'
           var AWS_SECRET_ACCESS_KEY = '$AWS_SECRET_ACCESS_KEY'
         " \

source/includes/steps-csfle-shell-azure-create-key.yaml

@@ -24,7 +24,7 @@ content: |
 
   .. code-block:: bash
 
-      mongo --eval "
+      mongosh --eval "
           var AZURE_TENANT_ID = '$AZURE_TENANT_ID'
           var AZURE_CLIENT_ID = '$AZURE_CLIENT_ID'
           var AZURE_CLIENT_SECRET = '$AZURE_CLIENT_SECRET'

source/includes/steps-csfle-shell-gcp-create-key.yaml

@@ -23,7 +23,7 @@ content: |
 
   .. code-block:: bash
 
-      mongo --eval "
+      mongosh --eval "
           var GCP_EMAIL = '$GCP_EMAIL'
           var GCP_PRIVATEKEY = '$GCP_PRIVATEKEY'
         " \

source/includes/steps-csfle-shell-local-create-key.yaml

@@ -43,7 +43,7 @@ content: |
 
   .. code-block:: bash
 
-      mongo --eval "var LOCAL_KEY = '$DEV_LOCAL_KEY' " \
+      mongosh --eval "var LOCAL_KEY = '$DEV_LOCAL_KEY' " \
         --shell --nodb
 
   The example automatically opens :mongosh:`mongosh </>`

source/includes/steps-deploy-replica-set-with-auth.yaml

@@ -214,7 +214,7 @@ action:
       parameters.
     language: sh
     code: |
-      mongo -u "fred" -p  --authenticationDatabase "admin"
+      mongosh -u "fred" -p  --authenticationDatabase "admin"
     post: |
       If you do not specify the password to the :option:`-p <mongosh -p>`
       command-line option, :mongosh:`mongosh </>` prompts for the

source/includes/steps-deploy-sharded-cluster-config-server-noauth.yaml

@@ -77,7 +77,7 @@ action:
   copyable: true
   language: sh
   code: |
-    mongo --host <hostname> --port <port>
+    mongosh --host <hostname> --port <port>
 ---
 stepnum: 3
 title: Initiate the replica set.

source/includes/steps-deploy-sharded-cluster-connect.yaml

@@ -129,7 +129,7 @@ action:
       to the :binary:`~bin.mongos`.
     language: sh
     code: |
-      mongo -u "fred" -p  --authenticationDatabase "admin"
+      mongosh -u "fred" -p  --authenticationDatabase "admin"
     post: |
       If you do not specify the password to the :option:`-p <mongosh -p>`
       command-line option, :mongosh:`mongosh </>` prompts for the

source/includes/steps-deploy-sharded-cluster-shard-replica-noauth.yaml

@@ -70,7 +70,7 @@ action:
   copyable: true
   language: sh
   code: |
-    mongo --host <hostname> --port <port>
+    mongosh --host <hostname> --port <port>
 ---
 title: Initiate the replica set.
 level: 4

source/includes/steps-enable-authentication-in-replica-set-no-downtime.yaml

@@ -157,7 +157,7 @@ action:
 
     language: shell
     code: |
-      mongo  -u joe -password  -authenticationDatabase foo --host mongoRepl/mongo1.example.net:27017, mongo2.example.net:27017, mongo3.example.net:27017
+      mongosh  -u joe -password  -authenticationDatabase foo --host mongoRepl/mongo1.example.net:27017, mongo2.example.net:27017, mongo3.example.net:27017
     post: |
        If you do not specify the password to the :option:`-p <mongosh -p>`
        command-line option, :mongosh:`mongosh </>` prompts for the

source/includes/steps-enable-authentication-in-shardcluster-nodowntime-uac.yaml

@@ -97,7 +97,7 @@ pre: |
 
      .. code-block:: javascript
 
-        mongo  --username "joe" --password "<password>" \
+        mongosh  --username "joe" --password "<password>" \
           --authenticationDatabase "marketing" --host mongos1.example.net:27017
 
      If your application uses a MongoDB driver, see the associated

source/includes/steps-kerberos-auth-activedirectory-authz.yaml

@@ -97,7 +97,7 @@ pre: |
 
   .. code-block:: bash
 
-     mongo --host <hostname> --port <port>
+     mongosh --host <hostname> --port <port>
 
   If your MongoDB server currently enforces authentication, you must
   authenticate to the ``admin`` database as a user with role management
@@ -108,7 +108,7 @@ pre: |
 
   .. code-block:: bash
 
-     mongo --host <hostname> --port <port> --username <user> --password <pass> --authenticationDatabase="admin" --authenticationMechanism="<mechanism>"
+     mongosh --host <hostname> --port <port> --username <user> --password <pass> --authenticationDatabase="admin" --authenticationMechanism="<mechanism>"
 
   .. note::
 
@@ -497,7 +497,7 @@ pre: |
 
      .. code-block:: bash
 
-        mongo --username sam@DBA.EXAMPLE.COM --password  --authenticationMechanisms="GSSAPI" --authenticationDatabase "$external" --host <hostname> --port <port>
+        mongosh --username sam@DBA.EXAMPLE.COM --password  --authenticationMechanisms="GSSAPI" --authenticationDatabase "$external" --host <hostname> --port <port>
 
      If you do not specify the password to the :option:`-p <mongosh
      --password>` command-line option, :mongosh:`mongosh </>`

source/includes/steps-shard-a-collection-ranged.yaml

@@ -11,7 +11,7 @@ action:
       parameter passing the port the :binary:`~bin.mongos` listens on.
     language: javascript
     code: |
-      mongo --host <hostname> --port <port>
+      mongosh --host <hostname> --port <port>
   - pre: |
       If your cluster enforces :term:`authentication`, add the 
       ``--username``, ``-password``, and ``--authenticationDatabase`` 
@@ -26,7 +26,7 @@ action:
       authenticating to the ``admin`` database.
     language: javascript
     code: |
-      mongo --host <hostname> --port <port> --username <user> --password <pass> --authenticationDatabase 'admin'
+      mongosh --host <hostname> --port <port> --username <user> --password <pass> --authenticationDatabase 'admin'
 ---
 title: "Enable Sharding on the Database"
 level: 4

source/reference/command/getLog.txt

@@ -149,7 +149,7 @@ messages associated with replication:
 
 .. code-block:: javascript
 
-   mongo --quiet --eval "db.adminCommand( { getLog:'global'} ).log.forEach(x => {print(x)})" | jq -c '. | select(.c=="REPL")'
+   mongosh --quiet --eval "db.adminCommand( { getLog:'global'} ).log.forEach(x => {print(x)})" | jq -c '. | select(.c=="REPL")'
 
 Be sure to provide any necessary connection-specific parameters to
 :mongosh:`mongosh </>` as needed, such as :option:`--host
@@ -163,7 +163,7 @@ Messages" example for use with :dbcommand:`getLog`:
 
 .. code-block:: javascript
 
-   mongo --quiet --eval "db.adminCommand( { getLog:'global'} ).log.forEach(x => {print(x)})" | jq -r ".msg" | sort | uniq -c | sort -rn | head -10
+   mongosh --quiet --eval "db.adminCommand( { getLog:'global'} ).log.forEach(x => {print(x)})" | jq -r ".msg" | sort | uniq -c | sort -rn | head -10
 
 Examples
 --------

source/reference/connection-string.txt

@@ -1417,7 +1417,7 @@ has been configured to support authentication via `AWS IAM credentials
 
 .. code-block:: none
 
-   mongo 'mongodb+srv://<aws access key id>:<aws secret access key>@cluster0.example.com/testdb?authSource=$external&authMechanism=MONGODB-AWS'
+   mongosh 'mongodb+srv://<aws access key id>:<aws secret access key>@cluster0.example.com/testdb?authSource=$external&authMechanism=MONGODB-AWS'
 
 Connecting to Atlas using AWS IAM credentials in this manner uses the
 ``MONGODB-AWS`` :urioption:`authentication mechanism <authMechanism>`
@@ -1430,7 +1430,7 @@ as well, provide it with the ``AWS_SESSION_TOKEN``
 
 .. code-block:: none
 
-   mongo 'mongodb+srv://<aws access key id>:<aws secret access key>@cluster0.example.com/testdb?authSource=$external&authMechanism=MONGODB-AWS&authMechanismProperties=AWS_SESSION_TOKEN:<aws session token>'
+   mongosh 'mongodb+srv://<aws access key id>:<aws secret access key>@cluster0.example.com/testdb?authSource=$external&authMechanism=MONGODB-AWS&authMechanismProperties=AWS_SESSION_TOKEN:<aws session token>'
 
 .. note::
 
@@ -1483,4 +1483,4 @@ using these environment variables:
 
 .. code-block:: none
 
-   mongo 'mongodb+srv://cluster0.example.com/testdb?authSource=$external&authMechanism=MONGODB-AWS'
+   mongosh 'mongodb+srv://cluster0.example.com/testdb?authSource=$external&authMechanism=MONGODB-AWS'