From 7cc5798fd56793d9afa215531dd06ce615c8dfb5 Mon Sep 17 00:00:00 2001 From: Miroslav Ruda Date: Mon, 7 Jul 2008 15:11:46 +0000 Subject: [PATCH] chapter 1 --- org.glite.lb.doc/src/LBAG-Introduction.tex | 24 +++++++++++------------- org.glite.lb.doc/src/LBUG-Introduction.tex | 8 ++++---- org.glite.lb.doc/src/LBUG.tex | 1 + org.glite.lb.doc/src/components.tex | 12 +++++++----- org.glite.lb.doc/src/definitions.tex | 4 ++++ org.glite.lb.doc/src/lbjp.bib | 10 +++++++++- 6 files changed, 36 insertions(+), 23 deletions(-) diff --git a/org.glite.lb.doc/src/LBAG-Introduction.tex b/org.glite.lb.doc/src/LBAG-Introduction.tex index 1107120..f19705e 100644 --- a/org.glite.lb.doc/src/LBAG-Introduction.tex +++ b/org.glite.lb.doc/src/LBAG-Introduction.tex @@ -1,5 +1,6 @@ \section{Introduction} -\TODO{This document should contain:} +% \TODO{This document should contain:} +\input versions \subsection{Service overview} @@ -7,32 +8,29 @@ A~fairly complete overview of the \LB service is given in \LB User's Guide~\cite 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} diff --git a/org.glite.lb.doc/src/LBUG-Introduction.tex b/org.glite.lb.doc/src/LBUG-Introduction.tex index e826729..ba47960 100644 --- a/org.glite.lb.doc/src/LBUG-Introduction.tex +++ b/org.glite.lb.doc/src/LBUG-Introduction.tex @@ -1,5 +1,6 @@ \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 @@ -115,7 +116,7 @@ The \LB events themselves are structured into \emph{attribute}~= 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 @@ -595,8 +596,8 @@ and the user annotations. Rather complex query semantics can be 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 @@ -888,4 +889,3 @@ CE's should be penalized or completely avoided when RB decides where jobs get submitted. -\TODO{prehled verzi} diff --git a/org.glite.lb.doc/src/LBUG.tex b/org.glite.lb.doc/src/LBUG.tex index 2468a6e..2bb1bcb 100644 --- a/org.glite.lb.doc/src/LBUG.tex +++ b/org.glite.lb.doc/src/LBUG.tex @@ -1,4 +1,5 @@ \documentclass{egee} +\def\insideUG{} \input{definitions} diff --git a/org.glite.lb.doc/src/components.tex b/org.glite.lb.doc/src/components.tex index 383361b..d8a3b00 100644 --- a/org.glite.lb.doc/src/components.tex +++ b/org.glite.lb.doc/src/components.tex @@ -7,8 +7,8 @@ These APIs are provided as sets of C/C++ header files and shared libraries. 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), @@ -98,10 +98,12 @@ pending events belonging to this handle accordingly. % 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. diff --git a/org.glite.lb.doc/src/definitions.tex b/org.glite.lb.doc/src/definitions.tex index 34fcba3..96433c5 100644 --- a/org.glite.lb.doc/src/definitions.tex +++ b/org.glite.lb.doc/src/definitions.tex @@ -1,7 +1,10 @@ \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} @@ -15,3 +18,4 @@ \long\def\ludek#1{} \hyphenation{plug-in} + diff --git a/org.glite.lb.doc/src/lbjp.bib b/org.glite.lb.doc/src/lbjp.bib index dd164b4..0daf55a 100644 --- a/org.glite.lb.doc/src/lbjp.bib +++ b/org.glite.lb.doc/src/lbjp.bib @@ -692,9 +692,17 @@ @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", -- 1.8.2.3