From: Alfredo Deza Date: Fri, 20 Oct 2017 14:00:17 +0000 (-0400) Subject: doc/ceph-volume elaborate on env vars for interval and tries in activation X-Git-Tag: v13.0.1~463^2~12 X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=1dc24d1a7065b4e23b1bfa0e7c6d263b5ebc6906;p=ceph.git doc/ceph-volume elaborate on env vars for interval and tries in activation Signed-off-by: Alfredo Deza --- diff --git a/doc/ceph-volume/lvm/systemd.rst b/doc/ceph-volume/lvm/systemd.rst index 7162e0433526..43804c6510d5 100644 --- a/doc/ceph-volume/lvm/systemd.rst +++ b/doc/ceph-volume/lvm/systemd.rst @@ -44,3 +44,22 @@ be mounted at:: Once that process is complete, a call will be made to start the OSD:: systemctl start ceph-osd@0 + + +Failure and Retries +------------------- +It is common to have failures when a system is coming up online. The devices +are sometimes not fully available and this unpredictable behavior may cause an +OSD to not be ready to be used. + +There are two configurable environment variables used to set the retry +behavior: + +* ``CEPH_VOLUME_SYSTEMD_TRIES``: Defaults to 30 +* ``CEPH_VOLUME_SYSTEMD_INTERVAL``: Defaults to 5 + +The *"tries"* is a number that sets the maximum amount of times the unit will +attempt to activate an OSD before giving up. + +The *"interval"* is a value in seconds that determines the waiting time before +initiating another try at activating the OSD.