Author: degenaro
Date: Thu Aug 11 18:35:36 2016
New Revision: 1756023
URL: http://svn.apache.org/viewvc?rev=1756023&view=rev
Log:
UIMA-5053 DUCC ducc_watcher optional admin script to determine status and send
notifications
Modified:
uima/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part4/install.tex
Modified:
uima/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part4/install.tex
URL:
http://svn.apache.org/viewvc/uima/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part4/install.tex?rev=1756023&r1=1756022&r2=1756023&view=diff
==============================================================================
---
uima/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part4/install.tex
(original)
+++
uima/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part4/install.tex
Thu Aug 11 18:35:36 2016
@@ -588,3 +588,33 @@ Red Hat Enterprise Linux Workstation rel
9. save
\end{verbatim}
+
+\section{DUCC daemons monitoring and notification}
+
+\begin{verbatim}
+
+$DUCC_HOME/admin/ducc_watcher is a Python script that, when run, contacts the
+DUCC Web Server to fetch data and determine the status of the critical head
node daemons.
+It can be run as a cron job to detect down daemons and send email notifications
+to a list of receipients specified in ducc.properties (via
site.ducc.properties).
+
+Purpose: send e-mail notification when overall DUCC state changes
+
+Configuration:
+
+ - to ducc.properties (via site.ducc.properties) add:
+ + ducc.watcher.notification.list = user1@host1 user2@host2
+
+ - add $DUCC_HOME/admin/ducc_watcher as a cron job on a host that:
+ + has access to $DUCC_HOME directory
+ + has access to DUCC WebServer URL
+ + has 'localhost' email server
+
+Files created by script:
+ - $DUCC_HOME/state/watcher
+ + comprises the last recorded overall state of DUCC
+
+ - $DUCC_HOME/logs/watcher.log
+ + comprises a state change events log
+
+\end{verbatim}
\ No newline at end of file
