From 4e3c9f2d08167a8d306dfd23c1035e4a21bc4547 Mon Sep 17 00:00:00 2001 From: Iustin Pop <iustin@google.com> Date: Mon, 28 May 2012 16:05:32 +0200 Subject: [PATCH] Correct the watcher state files in the man page MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The move to per-group state files forgot to update the man page of ganeti-watcher; let's fix this and add some more details on what removal means and when it's needed. Signed-off-by: Iustin Pop <iustin@google.com> Reviewed-by: RenΓ© Nussbaumer <rn@google.com> --- man/ganeti-watcher.rst | 24 ++++++++++++++++++------ 1 file changed, 18 insertions(+), 6 deletions(-) diff --git a/man/ganeti-watcher.rst b/man/ganeti-watcher.rst index 6f2b69238..7c61d3830 100644 --- a/man/ganeti-watcher.rst +++ b/man/ganeti-watcher.rst @@ -68,12 +68,24 @@ execute much later than the watcher submits them. FILES ----- -The command has a state file located at -``@LOCALSTATEDIR@/lib/ganeti/watcher.data`` (only used on the master) -and a log file at ``@LOCALSTATEDIR@/log/ganeti/watcher.log``. Removal -of either file will not affect correct operation; the removal of the -state file will just cause the restart counters for the instances to -reset to zero. +The command has a set of state files (one per group) located at +``@LOCALSTATEDIR@/lib/ganeti/watcher.GROUP-UUID.data`` (only used on the +master) and a log file at +``@LOCALSTATEDIR@/log/ganeti/watcher.log``. Removal of either file(s) +will not affect correct operation; the removal of the state file will +just cause the restart counters for the instances to reset to zero, and +mark nodes as freshly rebooted (so for example DRBD minors will be +re-activated). + +In some cases, it's even desirable to reset the watcher state, for +example after maintenance actions, or when you want to simulate the +reboot of all nodes, so in this case, you can remove all state files:: + + rm -f @LOCALSTATEDIR@/lib/ganeti/watcher.*.data + rm -f @LOCALSTATEDIR@/lib/ganeti/watcher.*.instance-status + rm -f @LOCALSTATEDIR@/lib/ganeti/instance-status + +And then re-run the watcher. .. vim: set textwidth=72 : .. Local Variables: -- GitLab