From 0df6886f1b06f0c0b11640e3e40d0285eecb41a6 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Zden=C4=9Bk=20=C5=A0ustr?= Date: Fri, 13 Jan 2012 11:21:50 +0000 Subject: [PATCH] Front matter facelift --- org.glite.lb.doc/src/LBAG-Abstract.tex | 2 +- org.glite.lb.doc/src/LBDG-Abstract.tex | 2 +- org.glite.lb.doc/src/LBTG-Abstract.tex | 2 +- org.glite.lb.doc/src/LBTP-Abstract.tex | 2 +- org.glite.lb.doc/src/LBUG-Abstract.tex | 6 +++--- org.glite.lb.doc/src/versions.tex | 21 +++++++++++---------- 6 files changed, 18 insertions(+), 17 deletions(-) diff --git a/org.glite.lb.doc/src/LBAG-Abstract.tex b/org.glite.lb.doc/src/LBAG-Abstract.tex index a3346a9..71ea87f 100644 --- a/org.glite.lb.doc/src/LBAG-Abstract.tex +++ b/org.glite.lb.doc/src/LBAG-Abstract.tex @@ -16,6 +16,6 @@ % % when changed, update also http://egee.cesnet.cz/en/JRA1/LB/lb.html % (in CVSROOT=:gserver:lindir.ics.muni.cz:/cvs/edg, cvsweb/lb.html) -This administrator's guide explains how to administer the Logging and +The Administrator's Guide explains how to administer the Logging and Bookkeeping (\LB) service. Several deployment scenarios are described together with the installation, configuration, running and troubleshooting steps. diff --git a/org.glite.lb.doc/src/LBDG-Abstract.tex b/org.glite.lb.doc/src/LBDG-Abstract.tex index 6c4fdb2..d6bacc9 100644 --- a/org.glite.lb.doc/src/LBDG-Abstract.tex +++ b/org.glite.lb.doc/src/LBDG-Abstract.tex @@ -16,7 +16,7 @@ % % when changed, update also http://egee.cesnet.cz/en/JRA1/LB/lb.html % (in CVSROOT=:gserver:lindir.ics.muni.cz:/cvs/edg, cvsweb/lb.html) -This developer's guide explains how to use the Logging and Bookkeeping (\LB) +The Developer's Guide explains how to use the Logging and Bookkeeping (\LB) service API. Logging (producer), querying (consumer) and notification API as well as the Web Services Interface is described in details together with programing examples. diff --git a/org.glite.lb.doc/src/LBTG-Abstract.tex b/org.glite.lb.doc/src/LBTG-Abstract.tex index 3be0001..a0fd003 100644 --- a/org.glite.lb.doc/src/LBTG-Abstract.tex +++ b/org.glite.lb.doc/src/LBTG-Abstract.tex @@ -16,6 +16,6 @@ % % when changed, update also http://egee.cesnet.cz/en/JRA1/LB/lb.html % (in CVSROOT=:gserver:lindir.ics.muni.cz:/cvs/edg, cvsweb/lb.html) -This is a guide for user-side troubleshooting of the Logging and Bookkeeping +The Troubleshooting Guide covers user-side troubleshooting of the Logging and Bookkeeping (\LB) service. It is based on previous experience with problems frequently encountered by users. diff --git a/org.glite.lb.doc/src/LBTP-Abstract.tex b/org.glite.lb.doc/src/LBTP-Abstract.tex index 4025c1b..0387fd5 100644 --- a/org.glite.lb.doc/src/LBTP-Abstract.tex +++ b/org.glite.lb.doc/src/LBTP-Abstract.tex @@ -16,7 +16,7 @@ % % when changed, update also http://egee.cesnet.cz/en/JRA1/LB/lb.html % (in CVSROOT=:gserver:lindir.ics.muni.cz:/cvs/edg, cvsweb/lb.html) -This test plan document explains how to test the Logging and Bookkeeping (\LB) +The Test Plan document explains how to test the Logging and Bookkeeping (\LB) service. Two major categories of tests are described: integration tests (include installation, configuration and basic service ping tests) and system tests (basic functionality tests, performance and stress tests, diff --git a/org.glite.lb.doc/src/LBUG-Abstract.tex b/org.glite.lb.doc/src/LBUG-Abstract.tex index b3adf4c..45c3367 100644 --- a/org.glite.lb.doc/src/LBUG-Abstract.tex +++ b/org.glite.lb.doc/src/LBUG-Abstract.tex @@ -16,7 +16,7 @@ % % when changed, update also http://egee.cesnet.cz/en/JRA1/LB/lb.html % (in CVSROOT=:gserver:lindir.ics.muni.cz:/cvs/edg, cvsweb/lb.html) -This user's guide explains how to use the Logging and Bookkeeping (\LB) service +The User's Guide explains how to use the Logging and Bookkeeping (\LB) service from the user's point of view. The service architecture is described -thoroughly. Examples on using \LB\ event logging command to log a~user tag and -change job ACL are given, as well as \LB\ query and notification use cases. +thoroughly. Examples on using \LB's event logging commands to log user tags and +change job ACLs are given, as well as \LB query and notification use cases. diff --git a/org.glite.lb.doc/src/versions.tex b/org.glite.lb.doc/src/versions.tex index 8d17c4e..f7c403a 100644 --- a/org.glite.lb.doc/src/versions.tex +++ b/org.glite.lb.doc/src/versions.tex @@ -30,25 +30,25 @@ gLite\footnote{\url{http://www.glite.org}} middleware~\cite{glite}, and then in The complete \LB Documentation consists of the following parts: \begin{itemize} \item \textbf{\LB User's Guide} - \ifx\insideUG\undefined{\cite{lbug}}\else{- this document}\fi. + \ifx\insideUG\undefined{\cite{lbug}}\else{-- this document}\fi. \input{LBUG-Abstract} \item \textbf{\LB Administrator's Guide} - \ifx\insideAG\undefined{\cite{lbag}}\else{- this document}\fi. + \ifx\insideAG\undefined{\cite{lbag}}\else{-- this document}\fi. \input{LBAG-Abstract} \item \textbf{\LB Developer's Guide} - \ifx\insideDG\undefined{\cite{lbdg}}\else{- this document}\fi. + \ifx\insideDG\undefined{\cite{lbdg}}\else{-- this document}\fi. \input{LBDG-Abstract} \item \textbf{\LB Test Plan} - \ifx\insideTP\undefined{\cite{lbtp}}\else{- this document}\fi. + \ifx\insideTP\undefined{\cite{lbtp}}\else{-- this document}\fi. \input{LBTP-Abstract} \end{itemize} \textbf{The following versions of \LB service are covered by these documents:} \begin{itemize} -%\item \LBver{x.x}: included in the EMI-3 Monte Bianco release -\item \LBver{3.2}: included in the EMI-2 Matterhorn release -\item \LBver{3.1}: an update for the EMI-1 Kebnekaise release -\item \LBver{3.0}: included in the EMI-1 Kebnekaise release +%\item \LBver{x.x}: included in the EMI-3 \emph{Monte Bianco} release +\item \LBver{3.2}: included in the EMI-2 \emph{Matterhorn} release +\item \LBver{3.1}: an update for the EMI-1 \emph{Kebnekaise} release +\item \LBver{3.0}: included in the EMI-1 \emph{Kebnekaise} release \item \LBver{2.1}: replacement for \LBver{2.0} in gLite 3.2, \item \LBver{2.0}: current stable version, in production as part of gLite 3.2, \item \LBver{1.x}: old stable version, in production as part of gLite 3.1. @@ -57,9 +57,10 @@ The complete \LB Documentation consists of the following parts: \textbf{\LB packages can be obtained from two distinguished sources:} +\nopagebreak \begin{itemize} -\item \textbf{gLite releases}: gLite node-type repositories, offering a specific repository for each node type such as \emph{glite-LB} -\item \textbf{emi releases}: EMI repository or EGI's UMD repository, offering all EMI middleware packages from a single repository and relying on EPEL for dependencies +\item \textbf{gLite releases}: gLite node-type repositories, offering a specific repository for each node type such as \emph{glite-LB}. Only binary RPM packages are available from that source. +\item \textbf{emi releases}: EMI repository\footnote{\url{http://emisoft.web.cern.ch/emisoft/}} or EGI's UMD repository,\footnote{\url{http://repository.egi.eu/}} offering all EMI middleware packages from a single repository. There are RPM packages, both source and binary, the latter relying on EPEL for dependencies. There are also DEB packages (starting with EMI-2) and \texttt{tar.gz} archives. \end{itemize} \emph{Note:} Despite offering the same functionality, binary packages obtained from different repositories differ and switching from one to the other for upgrades may not be altogether straightforward. -- 1.8.2.3