Merge "Add additional ntp information around ceph"

1 files changed, 16 insertions, 9 deletions

diff --git a/doc/quickstart.rst b/doc/quickstart.rst
index 0eedcc569..1eac54c59 100644
--- a/doc/quickstart.rst
+++ b/doc/quickstart.rst
@@ -126,13 +126,17 @@ To install these clients use:
 
     pip install -U python-openstackclient
 
-OpenStack uses healthcheck timers which run off wall-clock time rather then
-starting a timer and expiring the timer, encoding the expiration in the message
-contents. In some cases, this timer interval can be on the order of 60
-seconds. For OpenStack to operate correctly with these tight health-check
-timer intervals, the Kolla community highly recommends running the ntpd
-service on all deployment targets. To install, start, and enable ntp
-execute the following:
+OpenStack, RabbitMQ, and Ceph require all hosts to have matching times to ensure
+proper message delivery. In the case of Ceph, it will complain if the hosts
+differ by more than 0.05 seconds. Some OpenStack services have timers as low as
+2 seconds by default. For these reasons it is highly recommended to setup an NTP
+service of some kind. While `ntpd` will achieve more accurate time for the
+deployment if the NTP servers are running in the local deployment environment,
+`chrony <http://chrony.tuxfamily.org>`_ is more accurate when syncing the time
+across a WAN connection. When running Ceph it is recommended to setup `ntpd` to
+sync time locally due to the tight time constraints.
+
+To install, start, and enable ntp on CentOS execute the following:
 
 ::
 
@@ -141,8 +145,11 @@ execute the following:
     systemctl enable ntpd
     systemctl start ntpd
 
-    # Ubuntu
-    sudo apt-get install ntp
+To install and start on Debian based systems execute the following:
+
+::
+
+    apt-get install ntp
 
 Libvirt is started by default on many operating systems. Please disable libvirt
 on any machines that will be deployment targets. Only one copy of libvirt may