%
% mod_jk.tex
% Last Update: $Id: apache2_webalizer.tex 48100 2017-12-22 08:26:10Z hbfl $
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Kapitel mod_jk %%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\chapter{mod\_jk}
\emph{Ab Version 1.0.0 - Stand 16.09.2009\\
(c) Sebastian Scholze  <sebastian(at)eisfair(dot)org>}

\section{Allgemeines}
Mit Hilfe von mod\_jk ist es m"oglich, Anfragen von einem Apache httpd Server
an einen Tomcat Server weiterzuleiten.
Somit ist es mit einer Kombination von httpd, tomcat und mod\_jk m"oglich, das
ein httpd Server beispielsweise weiterhin statische Web-Seiten ausliefert und
nur Anfragen f"ur eine bestimmte Web-Applikation bzw. f"ur JSP-Seiten werden an
den Tomcat Server weitergeleitet.

Weitere Informationen zu mod\_jk finden sich auf der offiziellen Web-
Seite des Projekts ''http://tomcat.apache.org/connectors-doc/''.

\section{Voraussetzungen}
    Das Mod\_jk-Paket ben"otigt die folgenden Pakete:\\
        \begin{itemize}
            \item apache2
        \end{itemize}

\section{Installation}
    Das mod\_jk-Paket wird "uber das Setup-Men"u im Untermen"u ''Package
    administration'' installiert. Wird eine "altere Paketversion vorgefunden,
    so wird deren Konfiguration gesichert und das alte Paket deinstalliert bevor
    die neuen Programmdateien installiert werden und die Konfiguration "ubernommen
    wird.\\
    Bei einer Neuinstallation wird automatisch die
    \textbf{default}-Konfiguration erstellt. Nach Beendigung diese
    Schrittes werden die Konfigurationsdateien generiert und der httpd
    Daemon gestartet.

\section{Men"u im Setup-Programm}
    Das Men"u des clamav Paketes im Setup-Programm ist wie folgt aufgebaut:

\section{"Anderung der Konfiguration}
    Die Konfiguration von mod\_jk unter eisfair erfolgt "uber den Men"upunkt
    ''Edit configuration'' im Paketmen"u. Die vorgenommenen "Anderungen werden nach
    Beenden des Editors automatisch "ubernommen.

\section{Die Konfigurationsdatei}
    In der Konfigurationsdatei, die "uber das Men"u zug"anglich ist, sind
    die in den folgenden Unterabschnitten beschriebenen Parameter vorhanden.

    \subsection{Allgemeine Einstellungen}
        \begin{description}
        \config{JK\_TOMCAT\_HOST}{JK\_TOMCAT\_HOST}{JKTOMCATHOST}
            Wird dieser Wert auf ''yes'' gestellt, dann wird der \hbox{ClamAV} Dienst
            automatisch beim Start des Rechners mitgestartet. Anderenfalls ist das
            Starten und Beenden des Dienstes "uber das Paketmen"u jederzeit m"oglich.

            G"ultige Werte: \emph{''yes'', ''no''}

            Standardeinstellung: \emph{JK\_TOMCAT\_HOST='yes'}
        \end{description}

\subsection{Einstellungen f"ur automatische Updates}
\begin{description}
\config{JK\_TOMCAT\_PORT}{JK\_TOMCAT\_PORT}{JKTOMCATPORT}
    Um die Last, die auf den Update-Servern f"ur die Virendefinitionsdatenbanken
    liegt, zu verteilen, ist es m"oglich, regionale Update-Server zu verwenden.
    Mit dieser Option kann die Benutzung optionaler Update-Server eingeschaltet
    werden.

    G"ultige Werte: \emph{''yes'', ''no''}

    Standardeinstellung: \emph{JK\_TOMCAT\_PORT='yes'}
\config{JK\_LOG\_LEVEL}{JK\_LOG\_LEVEL}{JKLOGLEVEL}
    "uber diesen Wert wird festgelegt, welche Region f"ur die Updates verwendet
    werden soll.

	G"ultige Werte: \emph{''debug'', ''info'', ''error''}

    Standardeinstellung: \emph{JK\_LOG\_LEVEL='info'}
\config{JK\_MOUNT\_N}{JK\_MOUNT\_N}{JKMOUNTN}
    Um die Virussignaturen von ClamAV automatisch zu aktualisieren, muss
    hier der Wert auf yes gesetzt werden.

    G"ultige Werte: \emph{''yes'', ''no''}

    Standardeinstellung: \emph{JK\_MOUNT\_N='3'}
\end{description}

\subsection{Einstellungen f"ur die Priorit"at con ClamAV}
\begin{description}
\config{JK\_MOUNT\_\%\_ACTIVE}{JK\_MOUNT\_\%\_ACTIVE}{JKMOUNT\%ACTIVE}
Hier wird festgelegt zu welchem Zeitpunkt bzw. in welchem Intervall die
    Aktualisierung der Virussignaturen durchgef"uhrt werden soll, die
    Wildcard-TLDs darstellen. Diese Funktion ist nur verf"ugbar, wenn der
    Parameter CLAMAV\_UPDATE\_CRON\_USE='yes' gesetzt wurde. Die f"unf
    Teilparameter haben dabei folgende Bedeutung:
    	\begin{itemize}
          \item 1 - Minuten,\\
          \item 2 - Stunden,\\
          \item 3 - Tag des Monats,\\
          \item 4 - Monat,\\
          \item 5 - Wochentag.\\
        \end{itemize}
	D.h. bei Verwendung der Standardeinstellung wird jeden Tag um 00:25h
	die Liste aktualisiert. Wer N"aheres "uber die verwendete Befehlsyntax
	erfahren m"ochte, sollte "uber eine Internet-Suchmaschine nach 'man'
    und 'crontab' suchen.

    G"ultige Werte: \emph{Crontab-spezifischer Parametereintrag}

    Standardeinstellung: \emph{JK\_MOUNT\_\%\_ACTIVE='no'}
\config{JK\_MOUNT\_\%\_URL}{JK\_MOUNT\_\%\_URL}{JKMOUNT\%URL}
"Uber diese Variable l"a"st sich einstellen, ob und wann Mails nach einem
    Update(-Versuch) verschickt werden sollen.
    	\begin{itemize}
    	\item 0 = keine Mails\\
        \item 1 = bei updates\\
        \item 2 = bei updates und bei warnungen\\
        \item 3 = immer\\
        \item 4 = nur warnungen\\
        \end{itemize}

    G"ultige Werte: \emph{''0'', ''1'', ''2'', ''3'', ''4''}

    Standardeinstellung: \emph{CLAMAV\_UPDATE\_CRON\_MAIL\_LEVEL='0'}

\config{JK\_STATUS}{JK\_STATUS}{JKSTATUS}
    Mit dieser Variablen k"onnen Sie den Nice-Wert anpassen, mit dem ClamAV
    ausgef"uhrt wird. Der Wert der Variablen wird zum aktuellen Nice-Wert
    hinzugef"ugt.\\
    "uber den Nice-Wert kann die Scheduler Priorit"at eines auszuf"uhrenden
    Programmes gesteuert werden.

    G"ultige Werte: \emph{Nummerischer Wert}

    Standardeinstellung: \emph{JK\_STATUS='no'}
\end{description}

