From ca9ab48ba39d6f1002fe6b58f59635b6a2c8ec7c Mon Sep 17 00:00:00 2001 From: Miroslav Ruda Date: Tue, 8 Jul 2008 08:40:38 +0000 Subject: [PATCH] small changes across LBUG --- org.glite.lb.doc/src/LBUG-Appendix.tex | 7 +++++-- org.glite.lb.doc/src/LBUG-Introduction.tex | 4 ++-- org.glite.lb.doc/src/LBUG-Tools.tex | 11 +++++++---- org.glite.lb.doc/src/change_acl.tex | 11 ++++++----- org.glite.lb.doc/src/events.tex.T | 6 +++++- org.glite.lb.doc/src/log_usertag.tex | 8 ++++---- org.glite.lb.doc/src/logevent.tex | 6 +++--- org.glite.lb.doc/src/notify.tex | 28 ++++++++++++++++------------ 8 files changed, 48 insertions(+), 33 deletions(-) diff --git a/org.glite.lb.doc/src/LBUG-Appendix.tex b/org.glite.lb.doc/src/LBUG-Appendix.tex index 42405da..f8c999a 100644 --- a/org.glite.lb.doc/src/LBUG-Appendix.tex +++ b/org.glite.lb.doc/src/LBUG-Appendix.tex @@ -4,7 +4,6 @@ \label{a:events} Complete list of all events' names together with their description follows. % see events.tex.T -\TODO{Enable page break in the following table:} \input{events} \newpage @@ -14,4 +13,8 @@ Complete list of all job' states together with their description follows. % see status.tex.T \input{status} - +\begin{figure}[hb] +\centering +\includegraphics[width=.6\hsize]{images/wms2-jobstat} +\caption{\LB\ job state diagram} +\end{figure} diff --git a/org.glite.lb.doc/src/LBUG-Introduction.tex b/org.glite.lb.doc/src/LBUG-Introduction.tex index d6e439a..5d73daf 100644 --- a/org.glite.lb.doc/src/LBUG-Introduction.tex +++ b/org.glite.lb.doc/src/LBUG-Introduction.tex @@ -1,4 +1,4 @@ -\section{Introduction} +\section{\LB Architecture} \input versions %historie: vyrobeno pro WMS v EDG, 1. a 2. verze (seq. èísla, @@ -229,7 +229,7 @@ See Appendix~\ref{a:jobstat} for a list of the individual states. \begin{figure} \centering -\includegraphics[width=.8\hsize]{images/wms2-jobstat} +\includegraphics[width=.6\hsize]{images/wms2-jobstat} \caption{\LB\ job state diagram} \label{f:jobstat} \end{figure} diff --git a/org.glite.lb.doc/src/LBUG-Tools.tex b/org.glite.lb.doc/src/LBUG-Tools.tex index 2aa42e2..ac186f3 100644 --- a/org.glite.lb.doc/src/LBUG-Tools.tex +++ b/org.glite.lb.doc/src/LBUG-Tools.tex @@ -3,8 +3,10 @@ In this section we give a description of the tools that are installed together with the \verb'glite-lb-client' RPM. These tools are \LB-specific. -Besides these tools, \verb'glite-wms-job-status' and \verb'glite-wms-job-logging-info' available -in \verb'glite-wms-ui-cli-python' RPM, provide more information about user jobs and corresponding events. +Besides these tools, more general WMS commands \verb'glite-wms-job-status' +and \verb'glite-wms-job-logging-info' available +in \verb'glite-wms-ui-cli-python' RPM, provide also information about user jobs +and corresponding events. Behaviour of \verb'glite-lb-*' commands can be changed by setting the following enviroment variables: \begin{tabularx}{\textwidth}{lX} @@ -15,7 +17,8 @@ GLITE\_WMS\_NOTIF\_SERVER& address of \verb'glite-lb-bkserver' daemon, in form \ GLITE\_WMS\_NOTIF\_TIMEOUT& timeout (in seconds) for notification registration\\ X509\_USER\_CERT and X509\_USER\_KEY & location of user credentials\\ \end{tabularx} -For backward compatibility, all \verb'GLITE\_WMS\_*' variables can be prefixed by \verb'EDG\_WL\_' instead. +For backward compatibility, all \verb'GLITE_WMS_*' variables can be prefixed by +\verb'EDG_WL_' instead. \input{logevent} @@ -26,5 +29,5 @@ For backward compatibility, all \verb'GLITE\_WMS\_*' variables can be prefixed b For debugging purposes, low-level commands for getting \LB job status and job related events are provided in \verb'examples' directory (\verb'glite-lb-job-status' and \verb'glite-lb-job-log'). The same directory -contains also debugging commands for getting of all user jobs (\verb'glite-lb-user\_jobs') and +contains also debugging commands for getting of all user jobs (\verb'glite-lb-user_jobs') and CE-reputability rank (see Section \ref{s:ce-rank}, \verb'glite-lb-stats'). diff --git a/org.glite.lb.doc/src/change_acl.tex b/org.glite.lb.doc/src/change_acl.tex index be4bd7a..cecbfd7 100644 --- a/org.glite.lb.doc/src/change_acl.tex +++ b/org.glite.lb.doc/src/change_acl.tex @@ -8,10 +8,10 @@ event can be logged by the job owner using the \verb'glite-lb-logevent' command is as follows: \begin{verbatim} -glite-lb-logevent -e ChangeACL -s UserInterface -p --permission 1 \ - -j \ - --user_id \ - --user_id_type \ +glite-lb-logevent -e ChangeACL -s UserInterface -p --permission 1 + -j + --user_id + --user_id_type --permission_type --operation \end{verbatim} @@ -20,7 +20,8 @@ where \begin{tabularx}{\textwidth}{lX} \verb'' & specifies the job to change \\ \verb'' & specifies the user to use, can be either an X.500 name - (subject name) or a VOMS group (of the form :)\\ + (subject name) or a VOMS group (of the form + VO:Group)\\ \verb'' & \verb'0' or \verb'1', indicating \verb'user_id' specifies X.500 name or VOMS group, respectively \\ \verb'' & \verb'0' or \verb'1', indicating the user is diff --git a/org.glite.lb.doc/src/events.tex.T b/org.glite.lb.doc/src/events.tex.T index 6fe5c52..d45d188 100644 --- a/org.glite.lb.doc/src/events.tex.T +++ b/org.glite.lb.doc/src/events.tex.T @@ -5,6 +5,8 @@ gen qq{ }; @@@} +Events for gLite world: + \begin{tabularx}{\textwidth}{l>{\bfseries}lX} @@@{ my $flesh = 'gLite'; #XXX @@ -17,7 +19,9 @@ for my $e (sort { $event->{order}->{$a} <=> $event->{order}->{$b} } if ($flesh ne $event->{flesh}->{$e}) { $flesh = $event->{flesh}->{$e}; - gen "% new flesh $flesh \n"; + gen "\\end{tabularx}\n"; + gen " Events for $flesh world:\n\n"; + gen "\\begin{tabularx}{\\textwidth}{l>{\\bfseries}lX}\n"; $fleshno += 100; $eventno = $fleshno; } diff --git a/org.glite.lb.doc/src/log_usertag.tex b/org.glite.lb.doc/src/log_usertag.tex index 4333014..d3aa38c 100644 --- a/org.glite.lb.doc/src/log_usertag.tex +++ b/org.glite.lb.doc/src/log_usertag.tex @@ -17,10 +17,10 @@ needed by the command is assured. General template for adding user tag is as follows: \begin{verbatim} -glite-lb-logevent -s Application -e UserTag \ - -j \ - -c \ - --name \ +glite-lb-logevent -s Application -e UserTag + -j + -c + --name --value \end{verbatim} diff --git a/org.glite.lb.doc/src/logevent.tex b/org.glite.lb.doc/src/logevent.tex index 7e0040a..6ca6eb4 100644 --- a/org.glite.lb.doc/src/logevent.tex +++ b/org.glite.lb.doc/src/logevent.tex @@ -16,14 +16,13 @@ dealing with these two events. Command usage is: \begin{verbatim} - glite-lb-logevent [-h] [-p] [-c seq_code] \ + glite-lb-logevent [-h] [-p] [-c seq_code] -j -s Application -e [key=value ...] \end{verbatim} where \begin{tabularx}{\textwidth}{lX} -\texttt{ -h -{}-help} & this help message\\ \texttt{ -p -{}-priority} & send a priority event\\ \texttt{ -c -{}-sequence} & event sequence code\\ \texttt{ -j -{}-jobid} & JobId\\ @@ -35,7 +34,8 @@ where Each event specified after \verb'-e' option has different sub-options enabling to set event specific values. -Address of local logger, where event is sent, must be specified by environment +Address of local-logger, daemon responsible for further message delivery, must +be specified by environment variable \verb'GLITE_WMS_LOG_DESTINATION' in a form \verb'address:port'. Because user is allowed to change ACL or add user tags only for her jobs, paths diff --git a/org.glite.lb.doc/src/notify.tex b/org.glite.lb.doc/src/notify.tex index 6d84f7e..2d50008 100644 --- a/org.glite.lb.doc/src/notify.tex +++ b/org.glite.lb.doc/src/notify.tex @@ -21,38 +21,42 @@ However, only a single active client for a notification is allowed. environment variable. \verb'glite-lb-notify' support these actions: -\begin{description} -\item[new] Create new notification registration -\item[bind] Binds an notification registration to a client. -\item[refresh] Enlarge notification registration validity. -\item[receive] Binds to an existing notification registration and listen to server. -\item[drop] Drop the notification registration. -\end{description} +\begin{tabularx}{\textwidth}{lX} +\texttt{new} & Create new notification registration.\\ +\texttt{bind} & Binds an notification registration to a client.\\ +\texttt{refresh} & Enlarge notification registration validity.\\ +\texttt{receive} & Binds to an existing notification registration and listen to +server.\\ +\texttt{drop} & Drop the notification registration.\\ +\end{tabularx} 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 | -n network_server | -v virtual_organization } \end{verbatim} For action \verb'bind', command usage is: \begin{verbatim} -glite-lb-notify bind [ { -s socket_fd | -a fake_addr } -t requested_validity ] notifid + glite-lb-notify bind [ { -s socket_fd | -a fake_addr } -t requested_validity ] + notifid \end{verbatim} For action \verb'refresh', command usage is: \begin{verbatim} -glite-lb-notify refresh [-t requested_validity ] notifid + glite-lb-notify refresh [-t requested_validity ] notifid \end{verbatim} For action \verb'receive', command usage is: \begin{verbatim} -glite-lb-notify receive [ { -s socket_fd | -a fake_addr } ] [-t requested_validity ] [-i timeout] [-f field1,field2,...] [notifid] + glite-lb-notify receive [ { -s socket_fd | -a fake_addr } ] [-t requested_validity ] + [-i timeout] [-f field1,field2,...] [notifid] \end{verbatim} For action \verb'drop', command usage is: \begin{verbatim} -glite-lb-notify drop notifid + glite-lb-notify drop notifid \end{verbatim} where -- 1.8.2.3