svn commit: r1756023 - /uima/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part4/install.tex

[de...@apache.org]

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