From 3890c47dddd0d028b0c003cb46a9bec670c445f1 Mon Sep 17 00:00:00 2001 From: Alfredo Deza Date: Fri, 20 Oct 2017 10:00:17 -0400 Subject: [PATCH] doc/ceph-volume elaborate on env vars for interval and tries in activation Signed-off-by: Alfredo Deza (cherry picked from commit 1dc24d1a7065b4e23b1bfa0e7c6d263b5ebc6906) --- doc/ceph-volume/lvm/systemd.rst | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/doc/ceph-volume/lvm/systemd.rst b/doc/ceph-volume/lvm/systemd.rst index 7162e0433526f..43804c6510d59 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. -- 2.39.5