From d5f10b79862f4ea67c20b6e4032e72a14187f87c Mon Sep 17 00:00:00 2001
From: =?utf8?q?Zden=C4=9Bk=20=C5=A0ustr?= <sustr4@cesnet.cz>
Date: Mon, 19 Mar 2012 15:48:27 +0000
Subject: [PATCH] - New test description - NOTIF query strings

---
 org.glite.lb.doc/src/LBTP-Tests.tex | 25 +++++++++++++++++++++++++
 org.glite.lb.doc/src/LBUG-Tools.tex |  7 +++++--
 2 files changed, 30 insertions(+), 2 deletions(-)

diff --git a/org.glite.lb.doc/src/LBTP-Tests.tex b/org.glite.lb.doc/src/LBTP-Tests.tex
index 5e56e00..3bc588b 100644
--- a/org.glite.lb.doc/src/LBTP-Tests.tex
+++ b/org.glite.lb.doc/src/LBTP-Tests.tex
@@ -77,6 +77,8 @@ Besides pure System Functionality Tests, this list also includes In-the-Wild tes
 \hline
 {\tt lb-test-nagios-probe.sh} & Run the nagios probe and check results \\
 \hline
+{\tt lb-test-notif-keeper.sh} & Test the \texttt{notif-keeper} script \\
+\hline
 \end{tabularx}
 
 \subsubsection{Event logging examples}
@@ -431,6 +433,29 @@ through ActiveMQ messages.
 %\end{hints}
 
 
+\subsection{Site Notification Maintenance}
+\label{notifkeeper}
+
+\req\ All \LB\ services running.
+
+\what
+\begin{enumerate}
+\item Create or modify a \texttt{site-notif.conf} file
+\item Run the ``keeper'' script and check if the effect was as desired
+\begin{itemize}
+\item Setting up a new notification
+\item Changing its conditions
+\item Registering for anonymized notifications
+\item \dots
+\end{itemize}
+\item Repeat from step~1 with different settings until all scenarios have been checked
+\end{enumerate}
+
+\how\ \ctblb{lb-test-notif-keeper.sh}
+
+\note\ The test includes artificial delays. Takes approx. 30\,s to finish.
+
+\result\ Notifications must be registered and messages must arrive matching the currently applicable contents of the config file.
 
 
 \subsection{Server purge}
diff --git a/org.glite.lb.doc/src/LBUG-Tools.tex b/org.glite.lb.doc/src/LBUG-Tools.tex
index 5199947..ccd79da 100644
--- a/org.glite.lb.doc/src/LBUG-Tools.tex
+++ b/org.glite.lb.doc/src/LBUG-Tools.tex
@@ -87,11 +87,14 @@ To list all user's jobs, it is possible to query only the \LB server address, e.
 \begin{verbatim}
   firefox https://pelargir.ics.muni.cz:9000
 \end{verbatim}
-To list all user's notification registrations curently valid on a given \LB server, use a URL constructed as in folowing example:
+To list all user's notification registrations curently valid on a given \LB server, use an URL constructed as in folowing example:
 \begin{verbatim}
   firefox https://pelargir.ics.muni.cz:9000/NOTIF
 \end{verbatim}
-A notification ID also have a form of URL. If you direct your browser to a particular notification ID, the \LB server will provide the notification details for it.
+
+On top of that, \LB super users may use query strings \texttt{?all} or \texttt{?foreign} to display registrations belonging to anyone or anyone but themselves, respectively.
+
+A notification ID also takes the form of an URL. If you direct your browser to a particular notification ID, the \LB server will provide related registration details.
 \begin{verbatim}
   firefox https://pelargir.ics.muni.cz:9000/NOTIF:1234567890
 \end{verbatim}
-- 
1.8.2.3