Skip to content

Commit bfb3c7e

Browse files
committed
Updating Recommendations
1 parent 488968f commit bfb3c7e

File tree

1 file changed

+12
-12
lines changed

1 file changed

+12
-12
lines changed

articles/cosmos-db/mongodb/vcore/how-to-connect-mongoshell.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -16,27 +16,27 @@ ms.date: 02/05/2024
1616

1717
[!INCLUDE[MongoDB vCore](../../includes/appliesto-mongodb-vcore.md)]
1818

19-
MongoDB Shell (Mongosh), is a JavaScript and Node.js REPL environment for interacting with MongoDB deployments. It's a popular community tool to test queries and interact with the data in your Azure Cosmos DB for MongoDB database.
19+
MongoDB Shell (Mongosh), is a JavaScript and Node.js environment for interacting with MongoDB deployments. It's a popular community tool to test queries and interact with the data in your Azure Cosmos DB for MongoDB database.
2020

2121
## Prerequisites
22-
22+
Here are some pre-requisites
2323
- An existing Azure Cosmos DB for MongoDB vCore cluster.
24-
- Install the MongoShell from the community site.
25-
- Ensure you are setting up the necessary environment variables post installation for your operating system
26-
- Ensure you have set the firewall settings to allow the machine to connect. Follow the guidelines for [configuring the firewall for Azure CosmosDB](../../../cosmos-db/how-to-configure-firewall.md)
24+
- An installed version of the MongoShell from the community site.
25+
- Please ensure you're setting up the necessary environment variables post installation for your operating system
26+
- Please ensure you have set the firewall settings to allow the machine to connect. Follow the guidelines for [configuring the firewall for Azure CosmosDB](../../../cosmos-db/how-to-configure-firewall.md)
2727
- You can choose to allow requests from your current IP, requests from cloud services or requests from virtual machines - specific IP Ranges
2828

2929
![GIF of Firewall Settings update for MongoDB Vcore](media/connect-using-mongoshell/firewall-settings.gif)
3030

31-
If you accidentally open all the ports you will be warned before saving the changes.
31+
If you accidentally open all the ports, you'll be warned before saving the changes.
3232

3333
## Connect using Mongo Shell (Mongosh)
3434

3535
To add your Azure Cosmos DB cluster to Mongo shell, perform the following steps:
3636
1. Retrieve the connection information for your Azure Cosmos DB for MongoDB vCore using the instructions [here](quickstart-portal.md#get-cluster-credentials).
3737

3838
![GIF for getting connection string](./media/connect-using-mongoshell//getting-connectionstring-from-portal.gif)
39-
Once you have the connection string you can either
39+
Once you have the connection string, you can either
4040
- Have the shell prompt you to enter the password or
4141
- Provide the password as a part of the connection string
4242

@@ -50,23 +50,23 @@ Your connection string would look like this:
5050
```
5151
"mongodb+srv://<username>@<servername>.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000"
5252
```
53-
Here is an example of how the command looks like :
53+
Here's an example of how the command looks like:
5454
```
5555
mongosh "mongodb+srv://[email protected]/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000
5656
```
5757
![GIF for connecting by entering password](./media/connect-using-mongoshell/mongo-shell-connect.gif)
5858

59-
Once you provide the password and are successfully authenticated you will notice some warning stating *"This server or service appears to be an emulation of MongoDB"*
60-
This can be ignored. Its just shell way of notifying that you are not connection to an emulation of MongoDB. Since it is an Azure as a platform as a service offering this is expected.
59+
Once you provide the password and are successfully authenticated, you'll notice some warning stating *"This server or service appears to be an emulation of MongoDB"*
60+
The warning can be ignored. It's the shell's way of notifying that you aren't connection to an emulation of MongoDB. When it's an Azure as a platform as a service offering this is expected.
6161

6262
**B. By providing the password as a part of the connection string**
6363

64-
Alternately you can also use a connection string with the password in which case the format looks something like this
64+
Alternately you can also use a connection string with the password in which case the format looks something like this.
6565
```
6666
mongosh "mongodb+srv://<SERVERNAME>.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000" --username "<USER>" -password "<PASSWORD>"
6767
```
6868

69-
Here is an example of how the command looks like :
69+
Here's an example of how the command looks like:
7070
```
7171
mongosh "mongodb+srv://mongodbvcoretesting.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000" --username "testuser" -password "******"
7272
```

0 commit comments

Comments
 (0)