Skip to content

Commit d8a575b

Browse files
authored
Merge pull request ceph#54344 from zdover23/wip-doc-2023-11-05-rados-troubleshooting-mon-clock-skews-edit
doc/rados: edit t-mon.rst text Reviewed-by: Anthony D'Atri <[email protected]>
2 parents 3627b99 + 5496bd4 commit d8a575b

File tree

1 file changed

+13
-12
lines changed

1 file changed

+13
-12
lines changed

doc/rados/troubleshooting/troubleshooting-mon.rst

Lines changed: 13 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -350,12 +350,13 @@ Inject a monmap into the monitor
350350
Clock Skews
351351
-----------
352352

353-
The Paxos consensus algorithm requires tight time alignment. For this reason,
354-
clock skew among the monitors in the quorum can have a serious effect on
355-
monitor operation. The resulting behavior can be very puzzling. To avoid
356-
this kind of issue, run a clock synchronization tool on your monitor nodes:
357-
for example, ``Chrony`` or the legacy ``ntpd`` utility. Be sure to configure
358-
the monitor nodes with the `iburst` option and multiple peers:
353+
The Paxos consensus algorithm requires close time synchroniziation, which means
354+
that clock skew among the monitors in the quorum can have a serious effect on
355+
monitor operation. The resulting behavior can be puzzling. To avoid this issue,
356+
run a clock synchronization tool on your monitor nodes: for example, use
357+
``Chrony`` or the legacy ``ntpd`` utility. Configure each monitor nodes so that
358+
the `iburst` option is in effect and so that each monitor has multiple peers,
359+
including the following:
359360

360361
* Each other
361362
* Internal ``NTP`` servers
@@ -366,12 +367,12 @@ the monitor nodes with the `iburst` option and multiple peers:
366367
into initial synchronization.
367368

368369
Furthermore, it is advisable to synchronize *all* nodes in your cluster against
369-
internal and external servers, and perhaps even against your monitors. ``NTP``
370-
servers should run on bare metal; VM virtualized clocks are not suitable for
371-
steady timekeeping. For more information, visit `https://www.ntp.org
372-
<https://www.ntp.org>`_. Your organization might already have quality internal
373-
``NTP`` servers available. Sources for ``NTP`` server appliances include the
374-
following:
370+
internal and external servers, and perhaps even against your monitors. Run
371+
``NTP`` servers on bare metal: VM-virtualized clocks are not suitable for
372+
steady timekeeping. See `https://www.ntp.org <https://www.ntp.org>`_ for more
373+
information about the Network Time Protocol (NTP). Your organization might
374+
already have quality internal ``NTP`` servers available. Sources for ``NTP``
375+
server appliances include the following:
375376

376377
* Microsemi (formerly Symmetricom) `https://microsemi.com <https://www.microsemi.com/product-directory/3425-timing-synchronization>`_
377378
* EndRun `https://endruntechnologies.com <https://endruntechnologies.com/products/ntp-time-servers>`_

0 commit comments

Comments
 (0)