From cff33b74723016c0d25969cbb7385505cedffe0f Mon Sep 17 00:00:00 2001 From: =?utf8?q?Zden=C4=9Bk=20=C5=A0ustr?= Date: Wed, 29 Apr 2009 07:30:56 +0000 Subject: [PATCH] Documented new glite-lb-notify options, and added a new example for the --state option. --- org.glite.lb.doc/src/notify.tex | 47 ++++++++++++++++++++++++++++++++++++++--- 1 file changed, 44 insertions(+), 3 deletions(-) diff --git a/org.glite.lb.doc/src/notify.tex b/org.glite.lb.doc/src/notify.tex index 3be405e..e154325 100644 --- a/org.glite.lb.doc/src/notify.tex +++ b/org.glite.lb.doc/src/notify.tex @@ -37,8 +37,9 @@ server.\\ For action \verb'new', command usage is: \begin{verbatim} - glite-lb-notify new [ { -s socket_fd | -a fake_addr } -t requested_validity ] - {-j jobid | -o owner | -n network_server | -v virtual_organization } + glite-lb-notify new [ { -s socket_fd | -a fake_addr } -t requested_validity + -j jobid { -o owner | -O } -n network_server + -v virtual_organization --states state1,state2,... -c -f flags] \end{verbatim} For action \verb'bind', command usage is: @@ -72,10 +73,13 @@ where \texttt{ -t requested\_validity} & requested validity of the notification (in seconds) \\ \texttt{ -j jobid} & job ID to connect notification registration with \\ \texttt{ -o owner} & match this owner DN \\ +\texttt{ -O} & match owner on current user's DN \\ \texttt{ -n network\_server} & match only this network server (WMS entry point) \\ \texttt{ -v virtual\_organization} & match only jobs of this Virtual Organization \\ \texttt{ -i timeout} & timeout to receive operation in seconds \\ \texttt{ -f field1,field2,...} & list of status fields to print (only owner by default) \\ +\texttt{ -c} & notify only on job state change \\ +\texttt{ -S, --state state1,state2,...} & match on events resulting in listed states \\ \end{tabularx} For additional information see also manual page glite-lb-notify(1). @@ -130,7 +134,7 @@ Destroy notification: \subsubsection{Example: Waiting for notifications on all user's jobs} -Instead of waiting for one job, user may want accept notification about +Instead of waiting for one job, user may want to accept notification about state changes of all his jobs. Register notification for user (DN obtained by \verb'grid-proxy-info -subject'): @@ -218,3 +222,40 @@ got connection https://skurut68-2.cesnet.cz:9100/p2jBsy5WkFItY284lW2o8A Waiting /DC=cz/DC=cesnet-ca/O=Masaryk University/CN=Miroslav Ruda \end{verbatim} + + +\subsubsection{Example: Waiting for notifications on jobs reaching terminal states} + +This example shows how to set up notifications for jobs reaching state \emph{done} or \emph {aborted}. Since we prefer to receive just one notification per job, we will also use the \texttt{-c} option, which makes sure that notifications will be generated only on actual job state change. + + +\begin{verbatim} + GLITE_WMS_NOTIF_SERVER=skurut68-2.cesnet.cz:9100 glite-lb-notify new \ + --state done,aborted -c +\end{verbatim} + +returns: + +\begin{verbatim} + notification ID: https://skurut68-2.cesnet.cz:9100/NOTIF:6krjMRshTouH2n7D9t-xdg + valid: '2009-04-30 06:59:18 UTC' (1241074758) +\end{verbatim} + +Wait for notification (with timeout 120 seconds): +\begin{verbatim} + GLITE_WMS_NOTIF_SERVER=skurut68-2.cesnet.cz:9100 glite-lb-notify receive \ + -i 120 https://skurut68-2.cesnet.cz:9100/NOTIF:6krjMRshTouH2n7D9t-xdg +\end{verbatim} + +returns: +\begin{verbatim} +https://skurut68-2.cesnet.cz:9100/eIbQNz3oHpv-OkYVu-cXNg Done + /DC=cz/DC=cesnet-ca/O=Masaryk University/CN=Miroslav Ruda +https://skurut68-2.cesnet.cz:9100/GpBy2gfIZOAXR2hKOAYGgg Aborted + /DC=cz/DC=cesnet-ca/O=Masaryk University/CN=Miroslav Ruda +https://skurut68-2.cesnet.cz:9100/KWXmsqvsTQKizQ4OMiXItA Done + /DC=cz/DC=cesnet-ca/O=Masaryk University/CN=Miroslav Ruda +https://skurut68-2.cesnet.cz:9100/O1zs50Nm1r03vx2GLyaxQw Done + /DC=cz/DC=cesnet-ca/O=Masaryk University/CN=Miroslav Ruda +\end{verbatim} + -- 1.8.2.3