Skip to content

Commit 0517797

Browse files
author
Sam Kleinman
committed
DOCS-792: additional clarifications to replica-set reconfiguration text
1 parent 4746348 commit 0517797

File tree

1 file changed

+19
-16
lines changed

1 file changed

+19
-16
lines changed

source/administration/replica-sets.txt

Lines changed: 19 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -157,17 +157,19 @@ operations in the :program:`mongo` shell:
157157
cfg.members[0].hidden = true
158158
rs.reconfig(cfg)
159159

160-
After re-configuring the set, the member with the ``_id`` of ``0``
161-
has a priority of ``0`` so that it cannot become primary. The
162-
other members in the set will not advertise the hidden member in the
163-
:dbcommand:`isMaster` or :method:`db.isMaster()` output.
160+
After re-configuring the set, the first member of the set in the
161+
:data:`members <rs.conf.members>` array will have a priority of ``0``
162+
so that it cannot become primary. The other members in the set will
163+
not advertise the hidden member in the :dbcommand:`isMaster` or
164+
:method:`db.isMaster()` output.
164165

165166
.. note::
166167

167168
You must send the :method:`rs.reconfig()` command to a set member
168-
that *can* become :term:`primary`. In the above example, if you issue
169-
the :method:`rs.reconfig()` operation to the member with the ``_id``
170-
of ``0``, the operation fails.
169+
that *can* become :term:`primary`. In the above example, if you
170+
issue the :method:`rs.reconfig()` operation to a member with a
171+
:data:`priority <members.[n].priority>` of ``0`` the operation will
172+
fail.
171173

172174
.. note::
173175

@@ -225,8 +227,8 @@ following sequence of operations in the :program:`mongo` shell:
225227
cfg.members[0].slaveDelay = 3600
226228
rs.reconfig(cfg)
227229

228-
After the replica set reconfigures, the set member with the ``_id`` of
229-
``0`` has a priority of ``0`` and cannot become :term:`primary`. The :data:`slaveDelay <members[n].slaveDelay>` value
230+
After the replica set reconfigures, the first member of the set in the
231+
:data:`members <rs.conf.members>` array will have a priority of ``0`` and cannot become :term:`primary`. The :data:`slaveDelay <members[n].slaveDelay>` value
230232
delays both replication and the member's :term:`oplog` by 3600 seconds (1
231233
hour). Setting :data:`slaveDelay <members[n].slaveDelay>` to a
232234
non-zero value also sets :data:`hidden <members[n].hidden>` to
@@ -314,13 +316,14 @@ command sequence in the :program:`mongo` shell.
314316
cfg.members[5].votes = 0
315317
rs.reconfig(cfg)
316318

317-
This sequence gives ``0`` votes to set members with the ``_id``
318-
values of ``3``, ``4``, and ``5``. This setting allows the set to
319-
elect these members as :term:`primary` but does not allow them to
320-
vote in elections. If you have three non-voting members, you can add
321-
three additional voting members to your set. Place voting members so that
322-
your designated primary or primaries can reach a majority of votes in
323-
the event of a network partition.
319+
This sequence gives ``0`` votes to the fourth, fifth, and sixth
320+
members of the set according to the order of the :data:`members
321+
<rs.conf.members>` array in the output of :method:`rs.conf()`. This
322+
setting allows the set to elect these members as :term:`primary` but
323+
does not allow them to vote in elections. If you have three non-voting
324+
members, you can add three additional voting members to your
325+
set. Place voting members so that your designated primary or primaries
326+
can reach a majority of votes in the event of a network partition.
324327

325328
.. note::
326329

0 commit comments

Comments
 (0)