From bdafc357331813222b1e677b66041dad1fc852a5 Mon Sep 17 00:00:00 2001 From: Shane Harvey Date: Fri, 21 Jan 2022 10:09:03 -0800 Subject: [PATCH] PYTHON-3041 Fix doc example for initializing a replica set (#835) --- doc/examples/high_availability.rst | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/doc/examples/high_availability.rst b/doc/examples/high_availability.rst index a5c252f8a..19b48f7d0 100644 --- a/doc/examples/high_availability.rst +++ b/doc/examples/high_availability.rst @@ -52,11 +52,11 @@ At this point all of our nodes are up and running, but the set has yet to be initialized. Until the set is initialized no node will become the primary, and things are essentially "offline". -To initialize the set we need to connect to a single node and run the -initiate command:: +To initialize the set we need to connect directly to a single node and run the +initiate command using the ``directConnection`` option:: >>> from pymongo import MongoClient - >>> c = MongoClient('localhost', 27017) + >>> c = MongoClient('localhost', 27017, directConnection=True) .. note:: We could have connected to any of the other nodes instead, but only the node we initiate from is allowed to contain any @@ -81,15 +81,19 @@ The initial connection as made above is a special case for an uninitialized replica set. Normally we'll want to connect differently. A connection to a replica set can be made using the :meth:`~pymongo.mongo_client.MongoClient` constructor, specifying -one or more members of the set, along with the replica set name. Any of -the following connects to the replica set we just created:: +one or more members of the set and optionally the replica set name. +Any of the following connects to the replica set we just created:: + >>> MongoClient('localhost') + MongoClient(host=['localhost:27017'], ...) >>> MongoClient('localhost', replicaset='foo') MongoClient(host=['localhost:27017'], replicaset='foo', ...) >>> MongoClient('localhost:27018', replicaset='foo') MongoClient(['localhost:27018'], replicaset='foo', ...) >>> MongoClient('localhost', 27019, replicaset='foo') MongoClient(['localhost:27019'], replicaset='foo', ...) + >>> MongoClient('mongodb://localhost:27017,localhost:27018/') + MongoClient(['localhost:27017', 'localhost:27018'], ...) >>> MongoClient('mongodb://localhost:27017,localhost:27018/?replicaSet=foo') MongoClient(['localhost:27017', 'localhost:27018'], replicaset='foo', ...)