Spin off section on reading configuration and use it in both UG and AG

diff --git a/org.glite.lb.doc/Makefile b/org.glite.lb.doc/Makefile
index 62e10e8..281d3b4 100644 (file)
--- a/org.glite.lb.doc/Makefile
+++ b/org.glite.lb.doc/Makefile
@@ -99,7 +99,7 @@ LBUG.pdf: ${COMMON} \
        LBUG.tex \
        LBUG-Abstract.tex \
        LBUG-Introduction.tex components.tex \
-       LBUG-Tools.tex logevent.tex notify.tex log_usertag.tex change_acl.tex \
+       LBUG-Tools.tex logevent.tex https_configuration.tex notify.tex log_usertag.tex change_acl.tex \
        LBUG-Troubleshooting.tex \
        LBUG-Appendix.tex events.tex status.tex faq.tex
 
@@ -107,6 +107,7 @@ LBAG.pdf: ${COMMON} \
        LBAG.tex \
        LBAG-Abstract.tex \
        LBAG-Introduction.tex components.tex \
+       https_configuration.tex \
        LBAG-Installation.tex \
        LBAG-Running.tex \
        LBAG-Troubleshooting.tex faq.tex

diff --git a/org.glite.lb.doc/src/LBAG-Installation.tex b/org.glite.lb.doc/src/LBAG-Installation.tex
index c533b4a..018581f 100644 (file)
--- a/org.glite.lb.doc/src/LBAG-Installation.tex
+++ b/org.glite.lb.doc/src/LBAG-Installation.tex
@@ -302,6 +302,8 @@ Besides configuration files observed directly by \LB's services, there is a scor
 \end{tabularx}
 \footnotetext{When using \emph{yaim}, these scripts are generated and command line options inserted by \emph{yaim}.}
 
+\input{https_configuration}
+
 \subsubsection{Migration to a Different OS Version}
 \label{inst:OSmigration}
 Migration of a LB server to different machine is possible using
@@ -428,6 +430,7 @@ Overall, \texttt{msg.conf} specifies the following information:
 \item Broker settings (attribute \texttt{broker}). They may require an adaptive change in case the currently configured broker disappears and automatic checks fail to switch the settings to another one on time.
 \item Permissible topic title prefixes (attribute \texttt{prefix}). Registrations for delivery to topics not matching the prefix will be rejected. In case no prefix is specified, \LB applies the default EGI prefix: \texttt{grid.emi.}
 \end{itemize}
+Note: Current broker and prefix settings can be retrieved from the \LB server by any authenticated user reading the server's configuration page -- see Section \ref{s:findbroker}.
 
 
 \subsubsection{Index configuration}

diff --git a/org.glite.lb.doc/src/LBUG-Tools.tex b/org.glite.lb.doc/src/LBUG-Tools.tex
index 119ca98..5199947 100644 (file)
--- a/org.glite.lb.doc/src/LBUG-Tools.tex
+++ b/org.glite.lb.doc/src/LBUG-Tools.tex
@@ -113,20 +113,7 @@ or
     https://pelargir.ics.muni.cz:9000/1234567890?text
 \end{verbatim}
 
-\subsubsection{\LB Server Configuration}
-
-As of \LBver{3.0}, it is also possible to use the HTTPs interface to retrieve essential information on \LB Server configuration. For example:
-\begin{verbatim}
-  firefox https://scientific65.zcu.cz:9010/?configuration
-\end{verbatim}
-
-Among others, the following fields may be discerned from the URL:
-
-\begin{tabularx}{\textwidth}{lX}
-\label{s:findbroker}
-\texttt{msg\_brokers} & A list of messaging brokers that \LB server uses to deliver messages.\\
-\texttt{msg\_prefixes} & A list of permissible prefixes that must be used in messaging topics.\\
-\end{tabularx}
+\input{https_configuration}
 
 \subsection{Job state changes as an RSS feed}
 The \LB includes an RSS interface allowing users to keep trace of their jobs in a very simple way using an RSS reader. The parameters of the RSS feeds are predefined, so no configuration is required.

diff --git a/org.glite.lb.doc/src/https_configuration.tex b/org.glite.lb.doc/src/https_configuration.tex
new file mode 100644 (file)
index 0000000..53121ef
--- /dev/null
+++ b/org.glite.lb.doc/src/https_configuration.tex
@@ -0,0 +1,15 @@
+\subsubsection{Reading \LB Server Configuration over HTTPs}
+
+As of \LBver{3.0}, it is also possible to use the HTTPs interface to retrieve essential information on \LB Server configuration. For example:
+\begin{verbatim}
+  firefox https://pelargir.ics.muni.cz:9000/?configuration
+\end{verbatim}
+
+Among others, the following fields may be discerned from the URL:
+
+\begin{tabularx}{\textwidth}{lX}
+\label{s:findbroker}
+\texttt{msg\_brokers} & A list of messaging brokers that \LB server uses to deliver messages.\\
+\texttt{msg\_prefixes} & A list of permissible prefixes that must be used in messaging topics.\\
+\end{tabularx}
+