Skip to content

Commit 0c564cb

Browse files
committed
DOCSP-8628: Document new 'hello' command
1 parent d89528c commit 0c564cb

25 files changed

+187
-155
lines changed

config/redirects

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1784,3 +1784,11 @@ raw: /manual/core/wildcard -> ${base}/manual/core/index-wildcard/
17841784
[v3.4-v4.0]: /${version}/reference/mongodb-defaults -> ${base}/${version}/reference/
17851785

17861786
[v3.6-*]: /${version}/reference/command/clean -> ${base}/${version}/reference/command/nav-administration/
1787+
1788+
#
1789+
# Redirects for 5.0 and greater (if pages are removed in 4.4 that used to exist in earlier versions)
1790+
#
1791+
1792+
[v5.0-*]: /${version}/reference/command/isMaster -> ${base}/${version}/reference/command/hello
1793+
[v5.0-*]: /${version}/reference/method/db.isMaster -> ${base}/${version}/reference/method/db.hello
1794+

source/core/replica-set-hidden-member.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ data set but is **invisible** to client applications. Hidden members
1919
are good for workloads with different usage patterns from the other
2020
members in the :term:`replica set`. Hidden members must always be
2121
:ref:`priority 0 members <replica-set-secondary-only-members>` and
22-
so **cannot become primary**. The :method:`db.isMaster()` method does not
22+
so **cannot become primary**. The :method:`db.hello()` method does not
2323
display hidden members. Hidden members, however, **may vote** in
2424
:ref:`elections <replica-set-elections>`.
2525

source/core/sharded-cluster-query-router.txt

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -205,15 +205,15 @@ Confirm Connection to ``mongos`` Instances
205205
------------------------------------------
206206

207207
To detect if the MongoDB instance that your client is connected
208-
to is :binary:`~bin.mongos`, use the :dbcommand:`isMaster` command. When a
209-
client connects to a :binary:`~bin.mongos`, :dbcommand:`isMaster` returns
208+
to is :binary:`~bin.mongos`, use the :dbcommand:`hello` command. When a
209+
client connects to a :binary:`~bin.mongos`, :dbcommand:`hello` returns
210210
a document with a ``msg`` field that holds the string
211211
``isdbgrid``. For example:
212212

213213
.. code-block:: javascript
214214

215215
{
216-
"ismaster" : true,
216+
"isWritablePrimary" : true,
217217
"msg" : "isdbgrid",
218218
"maxBsonObjectSize" : 16777216,
219219
"ok" : 1,

source/includes/extracts-server-status-projection-base.yaml

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -27,13 +27,13 @@ content: |
2727
2828
- :serverstatus:`metrics.commands.update.arrayFilters`
2929
30-
- :serverstatus:`metrics.commands.findAndModify.arrayFilters`
30+
- :serverstatus:`metrics.commands.findAndModify.arrayFilters`
3131
3232
- Added new metric to track number of times ``newlyAdded`` fields
3333
were automatically removed:
3434
3535
- :serverstatus:`metrics.repl.reconfig.numAutoReconfigsForRemovalOfNewlyAddedFields`
36-
36+
3737
- Replaced :serverstatus:`opReadConcernCounters` with
3838
:serverstatus:`readConcernCounters` to track use of read concern
3939
levels specified by query operations
@@ -56,6 +56,10 @@ content: |
5656
5757
- :serverstatus:`metrics.cursor.totalOpened`
5858
59+
- Added new metric to track hello commands:
60+
61+
- :serverstatus:`connections.exhaustHello`
62+
5963
- Starting in MongoDB 4.4, {{operationName}}:
6064
6165
- Added new metrics to track write concern failures caused

source/includes/extracts-transactions.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -115,7 +115,7 @@ content: |
115115
ref: transactions-operations-restrictions-info
116116
content: |
117117
118-
Informational commands, such as :dbcommand:`isMaster`,
118+
Informational commands, such as :dbcommand:`hello`,
119119
:dbcommand:`buildInfo`, :dbcommand:`connectionStatus` (and their
120120
helper methods) are allowed in transactions; however, they cannot be
121121
the first operation in the transaction.

source/includes/fact-bulkwrite-operation-batches.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
The number of operations in each group cannot exceed the value of
22
the :limit:`maxWriteBatchSize <Write Command Batch Limit Size>` of
33
the database. As of MongoDB 3.6, this value is ``100,000``.
4-
This value is shown in the :data:`isMaster.maxWriteBatchSize` field.
4+
This value is shown in the :data:`hello.maxWriteBatchSize` field.
55

66
This limit prevents issues with oversized error messages. If a group
77
exceeds this :limit:`limit <Write Command Batch Limit Size>`,

source/reference/command.txt

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -335,9 +335,9 @@ Replication Commands
335335

336336
- Internal command that applies :term:`oplog` entries to the current data set.
337337

338-
* - :dbcommand:`isMaster`
338+
* - :dbcommand:`hello`
339339

340-
- Displays information about this member's role in the replica set, including whether it is the master.
340+
- Displays information about this member's role in the replica set, including whether it is the primary.
341341

342342
* - :dbcommand:`replSetAbortPrimaryCatchUp`
343343

0 commit comments

Comments
 (0)