aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorSam Yaple <sam@yaple.net>2015-11-05 09:10:47 +0000
committerSam Yaple <sam@yaple.net>2015-11-05 10:01:45 +0000
commitfdb010e56b19cd0efb7866fb3d0cc16b008ea3a7 (patch)
tree4e14de3d8d1bfd626e072a7ea06a7252b3016776 /doc
parentcf79c8a6f5ce6dc5e6ed0a421056a59e1994746d (diff)
downloadkolla-fdb010e56b19cd0efb7866fb3d0cc16b008ea3a7.tar.gz
kolla-fdb010e56b19cd0efb7866fb3d0cc16b008ea3a7.zip
Add additional ntp information around ceph
Mention `chrony` since thats what docs.openstack.org recommends for WAN connections. It does do better than ntpd Change-Id: I28caade26492294bf12b092ff949003c7bf0bb8e
Diffstat (limited to 'doc')
-rw-r--r--doc/quickstart.rst25
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