Skip to content

Commit 7582ea1

Browse files
committed
MM feedback
1 parent 2f076f5 commit 7582ea1

File tree

1 file changed

+15
-15
lines changed

1 file changed

+15
-15
lines changed

source/connect/connection-troubleshooting.txt

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -46,16 +46,16 @@ indicates that the library cannot connect to a MongoDB deployment:
4646

4747
The following sections describe methods that might help resolve the issue.
4848

49-
Check the Connection String
50-
~~~~~~~~~~~~~~~~~~~~~~~~~~~
49+
Check the Connection URI
50+
~~~~~~~~~~~~~~~~~~~~~~~~
5151

52-
Verify that the hostname and port number in the connection string are both
52+
Verify that the hostname and port number in the connection URI are both
5353
accurate. In the sample error message, the hostname is ``127.0.0.1`` and the
54-
port is ``27017``. The default port value for an instance of MongoDB Server is
54+
port is ``27017``. The default port value for a {+mdb-server+} deployment is
5555
``27017``, but you can configure MongoDB to listen on another port.
5656

5757
When connecting to a replica set, include all the replica set hosts in
58-
your connection string. Separate each of the hosts in the connection
58+
your connection URI. Separate each of the hosts in the connection
5959
string with a comma. This enables the library to establish a connection if
6060
one of the hosts is unreachable.
6161

@@ -95,34 +95,34 @@ Check the Credentials Formatting
9595
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
9696

9797
One of the most common causes of authentication issues is invalid
98-
credentials formatting in the MongoDB connection string.
98+
credentials formatting in the MongoDB connection URI.
9999

100100
.. tip::
101101

102-
To learn more information about using connection strings,
102+
To learn more information about using connection URIs,
103103
see :ref:`Connection URI <php-connection-uri>` in the
104104
Create a MongoDB Client guide.
105105

106-
If your connection string contains a username and password, ensure that
106+
If your connection URI contains a username and password, ensure that
107107
they are correctly formatted.
108108

109109
.. note::
110110

111-
If your username or password includes any of the following characters, you
112-
must `percent-encode <https://tools.ietf.org/html/rfc3986#section-2.1>`__ it:
111+
You must `percent-encode <https://tools.ietf.org/html/rfc3986#section-2.1>`__
112+
the following characters if they appear in your username or password:
113113

114114
.. code-block:: none
115115
:copyable: false
116116

117117
: / ? # [ ] @
118118

119-
Use your percent-encoded username and password in your connection string.
119+
Use your percent-encoded username and password in your connection URI.
120120

121121
Verify the Authentication Mechanism
122122
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
123123

124124
Ensure that your credentials and authentication mechanism are correct. You can
125-
specify your authentication credentials in the options of your connection string.
125+
specify your authentication credentials in the options of your connection URI.
126126

127127
If you use the ``$uriOptions`` parameter to specify an authentication mechanism,
128128
ensure that you set the ``'authMechanism'`` option to the correct mechanism. The
@@ -155,7 +155,7 @@ the username must be defined in the authentication database.
155155

156156
The default authentication database is the ``admin`` database.
157157
To use a different database for authentication, specify the
158-
``authSource`` option in the connection string.
158+
``authSource`` option in the connection URI.
159159

160160
The following example instructs MongoDB to use the ``users`` database
161161
as the authentication database:
@@ -198,9 +198,9 @@ in the Atlas documentation.
198198
Check the Network Addresses
199199
~~~~~~~~~~~~~~~~~~~~~~~~~~~
200200

201-
Verify that the network addresses or hostnames in your connection string
201+
Verify that the network addresses or hostnames in your connection URI
202202
are accurate.
203203

204204
If your deployment is hosted on MongoDB Atlas, you can follow the
205205
:atlas:`Connect to Your Cluster </tutorial/connect-to-your-cluster/>`
206-
tutorial to find your Atlas connection string.
206+
tutorial to find your Atlas connection URI.

0 commit comments

Comments
 (0)