\section{Introduction}
-\TODO{This document should contain:}
+% \TODO{This document should contain:}
+\input versions
\subsection{Service overview}
This section is a~brief excerpt only, providing minimal information necessary for
understanding the rest of this document.
-The task of \LB is gathering \emph{\LB events} from various grid middleware components,
-and delivering the events to \LB servers where users can query for them.
-Figure~\ref{f:gather} shows all principal components involved in the event gathering.
+The task of \LB is gathering \emph{\LB events} from various grid middleware components
+(see Figure~\ref{f:comp-gather})
+and delivering the events to \LB servers where users can query for them
+(Figure~\ref{f:comp-query}).
+%Figure~\ref{f:comp-gather} shows all principal components involved in the event gathering.
-\begin{figure}
+\begin{figure}[ht]
\centering
\includegraphics[width=.67\hsize]{LB-components-gather}
\caption{Components involved in gathering and transfering \LB events}
+\label{f:comp-gather}
\end{figure}
-\begin{figure}
+\begin{figure}[ht]
\centering
\includegraphics[width=.67\hsize]{LB-components-query}
\caption{\LB queries and notifications}
+\label{f:comp-query}
\end{figure}
-\TODO{revize vhodnosti textu wrt. include do AG i UG}
\input components
-\subsection{Versions overview}
-Mame v tom hokej, verze glite vs. verze LB, co je jak dostupne,
-cim se lisi.
-
-Popisovat glite 3.1 a LB 2.0, glite 3.0 prohlasit za obsolete
-
\subsection{Deployment scenarios}
\TODO{jakou zatez ktery snese}
\section{Introduction}
+\input versions
%historie: vyrobeno pro WMS v EDG, 1. a 2. verze (seq. èísla,
%cache a dotazy na stavy), v EGEE gLite---ustabilnìní, proxy
event \emph{type} (or scheme). For the purpose of tracking job status on
the Grid and with the knowledge of WMS Grid middleware structure we
defined an \LB schema with specific \LB event
-types\footnote{\url{https://edms.cern.ch/document/571273/}}.
+types (see Appendix\ref{a:events}).
The schema contains a common base, the attributes that must be assigned
to every single event. The primary key is the jobid, which is also one of
the required attributes. The other common attributes are currently the
supported, \eg
\emph{Which of my jobs annotated as ``apple'' or ``pear'' are already
scheduled for execution and are heading to the ``garden'' computing element?}
-The \LB User's
-Guide\footnote{\url{https://edms.cern.ch/file/571273/1/LB-guide.pdf}} provides a~series of similar examples of
+The \LB Developer's
+Guide\cite{lbdg} provides a~series of similar examples of
complex queries.
%dotazy na události
when RB decides where jobs get submitted.
-\TODO{prehled verzi}
\documentclass{egee}
+\def\insideUG{}
\input{definitions}
The library implements communication protocol with other \LB components
(logger and server), including encryption, authentication etc.
-We do not describe the API here in detail; it is documented in~\LB User's
-Guide\footnote{\url{https://edms.cern.ch/file/571273/1/LB-guide.pdf}},
+We do not describe the API here in detail; it is documented in~\LB Developer's
+Guide\cite{lbdg},
including complete reference and both simple and complex usage examples.
Events can be also logged with a~standalone program (using the C~API in turn),
% asi nepotrebujeme \subsubsection{Clients}
\subsubsection{Proxy}
-\TODO{Proxy is now "integrated" into the server executable, update the text:}
+
\emph{\LB proxy} is the implementation of the local view concept
-(Sect.~\ref{local}).
-When deployed (on the Resource Broker node in the current gLite middleware)
+\ifx\insideUG\undefined{(see \cite{lbug}).}\else{Sect.~\ref{local}}.\fi
+Since \LBnew, \LB proxy is intergrated into \LB server
+executable.
+When deployed (on the WMS node in the current gLite middleware)
it takes over the role of the local-logger daemon---it accepts the incoming
events, stores them in files, and forwards them to the inter-logger.
\usepackage{xspace}
+\usepackage{ifthen}
%\usepackage{doxygen}
\def\LB{L\&B\xspace}
+\def\LBnew{LB version 2.0}
+\def\LBold{LB version 1.x}
\def\JP{JP\xspace}
%\def\eg{e.\,g.}
\def\eg{for example\xspace}
\long\def\ludek#1{}
\hyphenation{plug-in}
+
@Misc{ lbug,
author = "A. K\v{r}enek and others",
- title = "{L\&B Users Guide}",
+ title = "{L\&B User's Guide}",
howpublished = "\url{https://edms.cern.ch/file/571273/1/LB-guide.pdf}"
}
+@Misc{ lbdg,
+ author = "A. K\v{r}enek and others",
+ title = "{L\&B Developer's Guide}",
+}
+@Misc{ lbag,
+ author = "A. K\v{r}enek and others",
+ title = "{L\&B Administrator's Guide}",
+}
@Misc{ lcg,
author = "LCG",
git://scientific.zcu.cz / jra1mw.git / commitdiff