From ec25954df1ee498bf8990f935b0f835bc4d92355 Mon Sep 17 00:00:00 2001 From: Tom Fifield Date: Mon, 5 Oct 2015 12:18:55 +0800 Subject: [PATCH] Fix NTP verify appearing before install Due to the way the toctree was working on this page, the steps to verify the NTP installation: a) appeared prominently on the initial page, leading to people wanting to try them before installing the service b) were not available in a logical order when using the previous/next buttons This patch adds a new file for the verify steps to fix a) and b) and includes it from the toctree. It's a solution, but may not be the best solution. Change-Id: I14b977147e70bf29ea42e40bb337c89426e6b8d5 Closes-Bug: 1501704 --- .../source/environment-ntp-verify.rst | 35 +++++++++++++++++++ doc/install-guide/source/environment-ntp.rst | 35 +------------------ 2 files changed, 36 insertions(+), 34 deletions(-) create mode 100644 doc/install-guide/source/environment-ntp-verify.rst diff --git a/doc/install-guide/source/environment-ntp-verify.rst b/doc/install-guide/source/environment-ntp-verify.rst new file mode 100644 index 0000000000..0b8fdbdad0 --- /dev/null +++ b/doc/install-guide/source/environment-ntp-verify.rst @@ -0,0 +1,35 @@ +.. _environment-ntp-verify: + +Verify operation +~~~~~~~~~~~~~~~~ + +We recommend that you verify NTP synchronization before proceeding +further. Some nodes, particularly those that reference the controller +node, can take several minutes to synchronize. + +#. Run this command on the *controller* node: + + .. code-block:: console + + # chronyc sources + 210 Number of sources = 2 + MS Name/IP address Stratum Poll Reach LastRx Last sample + =============================================================================== + ^- 192.0.2.11 2 7 12 137 -2814us[-3000us] +/- 43ms + ^* 192.0.2.12 2 6 177 46 +17us[ -23us] +/- 68ms + + Contents in the *Name/IP address* column should indicate the hostname or IP + address of one or more NTP servers. Contents in the *S* column should indicate + *\** for the server to which the NTP service is currently synchronized. + +#. Run the same command on *all other* nodes: + + .. code-block:: console + + # chronyc sources + 210 Number of sources = 1 + MS Name/IP address Stratum Poll Reach LastRx Last sample + =============================================================================== + ^* controller 3 9 377 421 +15us[ -87us] +/- 15ms + + Contents in the *remote* column should indicate the hostname of the controller node. diff --git a/doc/install-guide/source/environment-ntp.rst b/doc/install-guide/source/environment-ntp.rst index f82ac9e192..70ab61c2e6 100644 --- a/doc/install-guide/source/environment-ntp.rst +++ b/doc/install-guide/source/environment-ntp.rst @@ -16,37 +16,4 @@ nodes to reference the controller node. environment-ntp-controller.rst environment-ntp-other.rst - -Verify operation ----------------- - -We recommend that you verify NTP synchronization before proceeding -further. Some nodes, particularly those that reference the controller -node, can take several minutes to synchronize. - -#. Run this command on the *controller* node: - - .. code-block:: console - - # chronyc sources - 210 Number of sources = 2 - MS Name/IP address Stratum Poll Reach LastRx Last sample - =============================================================================== - ^- 192.0.2.11 2 7 12 137 -2814us[-3000us] +/- 43ms - ^* 192.0.2.12 2 6 177 46 +17us[ -23us] +/- 68ms - - Contents in the *Name/IP address* column should indicate the hostname or IP - address of one or more NTP servers. Contents in the *S* column should indicate - *\** for the server to which the NTP service is currently synchronized. - -#. Run the same command on *all other* nodes: - - .. code-block:: console - - # chronyc sources - 210 Number of sources = 1 - MS Name/IP address Stratum Poll Reach LastRx Last sample - =============================================================================== - ^* controller 3 9 377 421 +15us[ -87us] +/- 15ms - - Contents in the *remote* column should indicate the hostname of the controller node. + environment-ntp-verify.rst