<?xml version='1.0' encoding='ISO-8859-1'?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<!-- $Id: installation-and-basic-configuration.xml,v 1.13 2006/08/16 14:04:18 cs Exp $ -->

<chapter id="installation-and-basic-configuration">
<title>Installation des OTRS Framework</title>

<abstract>
<para>
Dieser Abschnitt beschreibt die Installation und die grundlegende
Einrichtung des zentralen OTRS Frameworks. Dabei wird auf die Installation
von bereits fertigen Paketen fr die Betriebssysteme Linux und
Microsoft Windows eingegangen, aber auch die manuelle Installation direkt
ber die Quellen erklrt, wodurch eine Installation auch auf
anderen, hier nicht nher beschriebenen, Betriebssystemen
bertragbar sein sollte.
</para>

<para>
Die Einrichtung des Web- und Datenbankservers,
die Schnittstelle zwischen OTRS und der Datenbank, das Einspielen
einzelner perl-Module, das Setzen der richtigen Berechtigungen, die
Einrichtung der OTRS-eigenen cron-Jobs sowie grundlegende Einstellungen
in den OTRS-Konfigurationsdateien, sind in diesem Kapitel zu finden.
</para>

<para>
Am Ende dieses Abschnitts sollte ein lauffhiges OTRS auf Ihrem
Betriebssystem installiert sein, an dessen Weboberflche Sie sich
bereits als OTRS-Administrator anmelden knnen.
</para>
</abstract>

<sect1 id="installation-of-prepared-packages">
<title>Der einfache Weg - Installation fertiger Pakete</title>

<para>
Der einfachste und komfortableste Weg ein lauffhiges OTRS zu
installieren ist sicherlich, auf bereits vorgefertigte Pakete zurck
zu greifen. Viele bereits vorgefertigte Installations-Pakete sind im
Download-Bereich unter

<ulink url="http://www.otrs.org">
<citetitle>http://www.otrs.org</citetitle>
</ulink>

zu finden. Da der Aufwand viel zu gro wre, die Installation
aller dort aufgefhrten Pakete in dieser Dokumentation anzufhren,
soll im Folgenden nur nher auf die Installation von OTRS unter SUSE
Linux, debian und Microsoft Windows eingegangen werden. Sehen Sie unter
der o.g. URL nach, ob auch fr Ihr Betriebssystem ein fertiges
Installations-Paket vorhanden ist und greifen Sie nur auf die manuelle
Installation zurck, wenn Sie keine andere Mglichkeit haben.
</para>

<sect2 id="installation-on-suse">
<title>Installation des rpm-Softwarepackets auf einer SUSE Linux
Distribution</title>

<para>
Dieser Abschnitt beinhaltet die Anleitung fr die Installation von OTRS
unter SUSE Linux. Getestet wurden die Versionen bis SUSE Linux 9.3.
Bevor Sie mit der Installation beginnen, sehen Sie bitte unter

<ulink url="http://www.otrs.org/">
<citetitle>http://www.otrs.org</citetitle>
</ulink>

nach, ob eine aktuellere Version von OTRS als .rpm-Datei vorliegt.
Sollte dies der Fall sein, verwenden Sie bitte diese neuere Version.
</para>

<para>
Installieren Sie OTRS mittels <application>yast</application> (yast2)
oder der Kommandozeile und <command>rpm</command>, je nach
Vorliebe. Beachten Sie jedoch, dass OTRS einige perl-Module
bentigt, die nicht standardmig in einer typischen
SUSE-Installation enthalten sind. <application>yast</application> sollte
die bessere Wahl sein, da es alle Abhngikeiten automatisch
beachtet und auflsen kann.
</para>

<para>
Sollten Sie den Weg ber die Kommandozeile mit
<command>rpm</command> bevorzugen, so mssen Sie die
perl-Module manuell vor Beginn der Installation von
OTRS installieren. Angenommen Sie haben die Datei
<filename>otrs.rpm</filename> im Verzeichnis <filename>/tmp</filename>
gespeichert, dann geben Sie zur Installation von OTRS folgenden Befehl ein.
</para>

<para>
<screen>
linux:~ # rpm -ivh /tmp/otrs.rpm
otrs                        ##################################################
Check OTRS user (/etc/passwd)... otrs exists.

Next steps:

[SuSEconfig]
 Execute 'SuSEconfig' to configure the webserver.

[start Apache and MySQL]
 Execute 'rcapache restart' and 'rcmysql start' in case they don't run.

[install the OTRS database]
 Use a webbrowser and open this link:
 http://localhost/otrs/installer.pl

[OTRS services]
 Start OTRS 'rcotrs start-force' (rcotrs {start|stop|status|restart|start-force|stop-force}).

Have fun!

 Your OTRS Team
 http://otrs.org/

linux:~ #
</screen>
</para>

<para>
Nach der Installation des rpm's ist es notwendig
<application>SuSEconfig</application> zu starten. Geben Sie hierzu
Folgendes ein.
</para>

<para>
<screen>
linux:~ # SuSEconfig
Starting SuSEconfig, the SuSE Configuration Tool...
Running in full featured mode.
Reading /etc/sysconfig and updating the system...
Executing /sbin/conf.d/SuSEconfig.aaa_at_first...
Executing /sbin/conf.d/SuSEconfig.apache...
Including /opt/otrs/scripts/apache-httpd.include.conf
Executing /sbin/conf.d/SuSEconfig.bootsplash...
Executing /sbin/conf.d/SuSEconfig.doublecheck...
Executing /sbin/conf.d/SuSEconfig.guile...
Executing /sbin/conf.d/SuSEconfig.hostname...
Executing /sbin/conf.d/SuSEconfig.ispell...
Executing /sbin/conf.d/SuSEconfig.perl...
Executing /sbin/conf.d/SuSEconfig.permissions...
Executing /sbin/conf.d/SuSEconfig.postfix...
Setting up postfix local as MDA...
Setting SPAM protection to "off"...
Executing /sbin/conf.d/SuSEconfig.profiles...
Finished.
linux:~ #
</screen>
</para>

<para>
Die Installation des OTRS-rpm ist abgeschlossen. Starten Sie nun
Ihren Webserver neu, um die nderungen in der Konfiguration zu
bernehmen.
</para>

<para>
<screen>
linux:~ # rcapache restart
Shutting down httpd                                         done
Starting httpd [ PERL ]                                     done
linux:~ #
</screen>
</para>

<para>
Der nchste Schritt ist das Aufsetzen der Datenbank.
Wenn sie <application>MySQL</application> als Datenbankserver verwenden,
knnen Sie hierzu den Webinstaller von OTRS benutzen. Geben Sie
dazu folgende Adresse in Ihrem Browser ein.
</para>

<para>
<ulink url="http://localhost/otrs/installer.pl">
<citetitle>http://localhost/otrs/installer.pl</citetitle>
</ulink>
</para>

<para>
Der Webinstaller wird gestartet. Folgen Sie den Anweisungen auf dem
Bildschirm.
</para>

<para>
<screenshot>
<screeninfo>installer.pl screen - Lizenz (1/4)</screeninfo>
<graphic srccredit="installer.pl - screenshot" scale="40" fileref="screenshots/installer.png"></graphic>
</screenshot>
</para>

<para>
<screenshot>
<screeninfo>installer.pl screen - Datenbank erstellen (2/4)</screeninfo>
<graphic srccredit="installer.pl - screenshot" scale="40" fileref="screenshots/installer1.png"></graphic>
</screenshot>
</para>

<warning>
<para>
Es ist niemals eine gute Idee, Standardpasswrter zu
verwenden! Bitte ndern Sie deshalb unbedingt das von OTRS
standardmig gesetzte Passwort!
</para>
</warning>

<para>
<screenshot>
<screeninfo>installer.pl screen - Datenbank erstellen (2/4)</screeninfo>
<graphic srccredit="installer.pl - screenshot" scale="40" fileref="screenshots/installer2.png"></graphic>
</screenshot>
</para>

<para>
<screenshot>
<screeninfo>installer.pl screen - System einstellungen (3/4)</screeninfo>
<graphic srccredit="installer.pl - screenshot" scale="40" fileref="screenshots/installer3.png"></graphic>
</screenshot>
</para>

<para>
<screenshot>
<screeninfo>installer.pl screen - Fertig (4/4)</screeninfo>
<graphic srccredit="installer.pl - screenshot" scale="40" fileref="screenshots/installer4.png"></graphic>
</screenshot>
</para>

<para>
Nachdem alle Einstellungen vorgenommenw urden, kann OTRS nun gestartet
werden.
</para>

<para>
<screen>
linux:~ # rcotrs restart-force
Shutting down OTRS
 Disable /opt/otrs/bin/PostMaster.pl ... done.
no crontab for otrs
 Shutting down cronjobs ... failed!
Shutting down OTRS (completely)
 Shutting down Apache ... done.
 Shutting down MySQL ... done.
                                                                     done
Starting OTRS (completely)
 Starting Apache ... done.
 Starting MySQL ... done.
Starting OTRS
 Checking Apache ... done.
 Checking MySQL ... done.
 Checking database connect... (It looks Ok!).
 Enable /opt/otrs/bin/PostMaster.pl ... done.
 Checking otrs spool dir...  done.
 Creating cronjobs (source /opt/otrs/var/cron/*) ... done.

  -->> http://linux.example.com/otrs/index.pl &lt;&lt;--
                                                                     done
                                                                     done
linux:~ #
</screen>
</para>

<para>
Die Installation von OTRS ist beendet, Sie sollten das System nun
verwenden knnen. Um sich in die Weboberflche des
Trouble Ticket Systems einloggen zu knnen, geben sie die Adresse

<ulink url="http://localhost/otrs/index.pl">
<citetitle>http://localhost/otrs/index.pl</citetitle>
</ulink>

in Ihrem Browser ein. Melden sie sich als OTRS-Administrator an und
konfigurieren Sie das System Ihren Wnschen entsprechend.
Als Benutzername verwenden Sie root@localhost, das Passwort lautet
root.
</para>

<warning>
<para>
Bitte ndern Sie auch dieses Passwort schnellstmglich! Es
handelt sich auch hier um ein Standardpasswort!
</para>
</warning>

</sect2>

<sect2 id="installation-on-debian">
<title>Installation von OTRS auf einer debian-Distribution</title>

<para>
Dieser Abschnitt beinhaltet die Anleitung fr die Installation von OTRS
unter debian 3.1 (sarge).
</para>

<para>
Installieren Sie OTRS mittels <application>apt-get</application>
ber die Kommandozeile. Ggf. werden von OTRS einige perl-Module
bentigt, die nicht standardmig in einer typischen
debian-Installation enthalten sind. Lassen Sie
<application>apt-get</application> diese Abhngigkeiten selbst
auflsen und alle weiteren Pakete automatisch installieren.
Bringen Sie weiterhin vor der Installation Ihre Paketlisten durch ein
<command>apt-get update</command> auf den aktuellsten Stand, so
erhalten Sie immer die neusten Versionen der installierbaren Pakete.
Geben Sie zur Installation von OTRS folgenden Befehl ein.
</para>

<para>
<screen>
linux:~# apt-get install otrs
Reading Package Lists... Done
Building Dependency Tree... Done
Suggested packages:
  otrs-doc
The following NEW packages will be installed:
  otrs
0 upgraded, 1 newly installed, 0 to remove and 0 not upgraded.
Need to get 947kB of archives.
After unpacking 6132kB of additional disk space will be used.
Get:1 ftp://ftp.uni-erlangen.de sarge/main otrs 1.3.2p01-5 [947kB]
Fetched 947kB in 10s (93.7kB/s)
Selecting previously deselected package otrs.
(Reading database ... 73351 files and directories currently installed.)
Unpacking otrs (from .../otrs_1.3.2p01-5_all.deb) ...
Setting up otrs (1.3.2p01-5) ...
Adding system user `otrs'...
Adding new user `otrs' (105) with group `www-data'.
Not creating home directory.
SetPermissions.sh &lt;$Revision: 1.13 $&gt; - set OTRS file permissions
Copyright (c) 2001-2003 Martin Edenhofer &lt;martin@otrs.org&gt;
Setting file permissions...
chown -R 0:0 /usr/share/otrs
chown otrs:www-data /usr/share/otrs
chown -R otrs:www-data /usr/share/otrs/var/
chown -R www-data:www-data /usr/share/otrs/var/sessions/
touch &amp;&amp; chown otrs:www-data
/usr/share/otrs/var/log/TicketCounter.log
chmod -R 755 /usr/share/otrs/bin/
(chown &amp;&amp; chmod 700) otrs:0
/usr/share/otrs/bin/DeleteSessionIDs.pl
(chown &amp;&amp; chmod 700) otrs:0 /usr/share/otrs/bin/UnlockTickets.pl
(chown &amp;&amp; chmod 700) otrs:0 /usr/share/otrs/bin/otrs.getConfig

linux:~#
</screen>
</para>

<para>
Nach der Installation des OTRS Frameworks muss zunchst der Webserver
grundlegend fr OTRS konfiguriert werden (unter debian geschieht
das leider nicht automatisch).
</para>

<important>
<para>
In der folgenden Beschreibung wird davon ausgegangen, dass
<application>apache</application> 2.x als Webserver eingesetzt wird. Gehen
Sie fr <application>apache</application> 1.3.x analog
vor. Die entsprechenden Verzeichnisse fr
<application>apache</application> 1.3.x befinden sich unter
<filename>/etc/apache</filename>.
</para>
</important>

<para>
Erstellen Sie die Datei <filename>otrs.conf</filename> mit folgendem
Inhalt und speichern Sie diese im Verzeichnis
<filename>/etc/apache2/conf.d</filename>.
</para>

<para>
<programlisting id="basic-apache-config-under-debian">
#
# Basic apache configuration file for OTRS
#
# agent, admin and customer frontend
#
ScriptAlias /otrs/ "/usr/share/otrs/bin/cgi-bin/"
Alias /otrs-web/ "/usr/share/otrs/var/httpd/htdocs/"

# directory settings
&lt;Directory "/usr/share/otrs/bin/cgi-bin/"&gt;
    AllowOverride None
    Options +ExecCGI -Includes
    Order allow,deny
    Allow from all
&lt;/Directory&gt;
&lt;Directory "/usr/share/otrs/var/httpd/htdocs/"&gt;
    AllowOverride None
    Order allow,deny
    Allow from all
&lt;/Directory&gt;
</programlisting>
</para>

<para>
Starten Sie nun Ihren Webserver neu, um die nderungen in der
Konfiguration zu bernehmen.
</para>

<para>
<screen>
linux:~# /etc/init.d/apache2 restart
Forcing reload of web server: Apache2.
linux:~#
</screen>
</para>

<para>
Der nchste Schritt ist das Aufsetzen der Datenbank fr OTRS.
Wenn sie <application>MySQL</application> als Datenbankserver verwenden,
knnen Sie hierzu den Webinstaller von OTRS benutzen. Geben
Sie dazu folgende Adresse in Ihrem Browser ein:
</para>

<para>
<ulink url="http://localhost/otrs/installer.pl">
<citetitle>http://localhost/otrs/installer.pl</citetitle>
</ulink>
</para>

<para>
Der Webinstaller wird gestartet. Folgen Sie den Anweisungen auf dem
Bildschirm.
</para>

<para>
<screenshot>
<screeninfo>installer.pl screen - Lizenz (1/4)</screeninfo>
<graphic srccredit="installer.pl - screenshot" scale="40" fileref="screenshots/installer.png"></graphic>
</screenshot>
</para>

<para>
<screenshot>
<screeninfo>installer.pl screen - Datenbank erstellen (2/4)</screeninfo>
<graphic srccredit="installer.pl - screenshot" scale="40" fileref="screenshots/installer1.png"></graphic>
</screenshot>
</para>

<warning>
<para>
Es ist niemals eine gute Idee, Standardpasswrter zu
verwenden! Bitte ndern Sie deshalb unbedingt das von OTRS
standardmig gesetzte Passwort!
</para>
</warning>

<para>
<screenshot>
<screeninfo>installer.pl screen - Datenbank erstellen (2/4)</screeninfo>
<graphic srccredit="installer.pl - screenshot" scale="40" fileref="screenshots/installer2.png"></graphic>
</screenshot>
</para>

<para>
<screenshot>
<screeninfo>installer.pl screen - System einstellungen (3/4)</screeninfo>
<graphic srccredit="installer.pl - screenshot" scale="40" fileref="screenshots/installer3.png"></graphic>
</screenshot>
</para>

<para>
<screenshot>
<screeninfo>installer.pl screen - Fertig (4/4)</screeninfo>
<graphic srccredit="installer.pl - screenshot" scale="40" fileref="screenshots/installer4.png"></graphic>
</screenshot>
</para>

<para>
Die Installation von OTRS ist beendet. Sie sollten das System nun
verwenden knnen. Auch die cron-Jobs, die fr den Betrieb von OTRS
bentigt werden, wurden bei der Installation des .deb-Pakets mit
eingerichtet. Um sich in die Weboberflche des
Trouble Ticket Systems einlogen zu knnen, geben sie die Adresse

<ulink url="http://localhost/otrs/index.pl">
<citetitle>http://localhost/otrs/index.pl</citetitle>
</ulink>

in Ihrem Browser ein. Melden sie sich als OTRS-Administrator an und
konfigurieren Sie das System weiter Ihren Wnschen entsprechend.
Als Benutzername verwenden Sie root@localhost, das Passwort lautet
root.
</para>

<warning>
<para>
Bitte ndern Sie auch dieses Passwort schnellstmglich! Es
handelt sich auch hierbei um ein Standardpasswort!
</para>
</warning>

</sect2>

<sect2 id="installation-on-windows">
<title>Installation von OTRS unter Microsoft Windows</title>

<para>
Die Installation von OTRS unter Microsoft Windows ist denkbar einfach.
Laden Sie den auf

<ulink url="http://www.otrs.org/">
<citetitle>http://www.otrs.org</citetitle>
</ulink>

bereit gestellten Installer herunter und speichern Sie die Datei.
Anschlieend fhren Sie den Installer einfach aus und folgen
den einzelnen Installationsschritten.
</para>

<important>
<para>
Der Windows-Installer fr OTRS beinhaltet bereits alle Komponenten,
die fr den Betrieb von OTRS bentigt werden. D.h., es wird
zustzlich zum eigentlichen OTRS der <application>apache2</application>
Webserver, <application>MySQL</application>, <application>perl</application>
mit den fr OTRS bentigten Modulen und
<application>cron</application> fr Windows installiert. Aus diesem
Grund ist es empfehlenswert OTRS ber den Installer nur auf solchen
Windowssystemen zu installieren, auf denen noch kein
<application>apache2</application> bzw. ein anderer Webserver und
<application>MySQL</application> luft.
</para>
</important>

</sect2>

</sect1>

<sect1 id="manual-installation-of-otrs">
<title>Manuelle Installation (Linux, Unix)</title>

<sect2 id="preparing-manual-installation">
<title>Vorbereiten der manuellen Installation</title>

<para>
Wenn Sie OTRS manuell ber die Quellen installieren mchten oder
mssen, laden Sie sich zuerst das aktuelle Archiv herunter. Sie finden
die entsprechenden .tar.gz- oder .tar.bz2-Dateien im Downloadbereich auf

<ulink url="http://www.otrs.org/">
<citetitle>http://www.otrs.org</citetitle>
</ulink>

</para>

<para>
Entpacken Sie das Archiv mit Hilfe von <command>tar</command> z. B. in das
Verzeichnis <filename>/opt</filename>:
</para>

<para>
<screen>
linux:/opt# tar xf /tmp/otrs-2.0.0.tar.gz
linux:/opt# ls
otrs
linux:/opt#
</screen>
</para>

<para>
Da die Skripte von OTRS spter nicht mit root-Rechten laufen sollen, muss
im nchsten Schritt ein Benutzer fr OTRS im System angelegt
werden. Dieser Benutzer sollte als Homeverzeichnis das Verzeichnis erhalten,
in das gerade die Quellen von OTRS entpackt wurden, also
<filename>/opt/otrs</filename>. Wird der Webserver unter einem anderen
Benutzer als dem OTRS-User betrieben, so muss der neue OTRS-Benutzer
noch zur Gruppe des Webserver-Users hinzugefgt werden.
</para>

<para>
<screen>
linux:/opt# useradd -d /opt/otrs/ -c 'OTRS user' otrs
linux:/opt# usermod -G nogroup otrs
linux:/opt#
</screen>
</para>

<para>
Im nchsten Schritt werden einige Demo-Konfigurationsdateien
innerhalb der entpackten Quelldateien bzw. innerhalb des Homeverzeichnisses
des OTRS-Benutzers kopiert. Die Dateien befinden sich in den Verzeichnissen
<filename>/opt/otrs/Kernel</filename> bzw.
<filename>/opt/otrs/Kernel/Config</filename> und haben die Endung .dist.
</para>

<para>
<screen>
linux:/opt# cd otrs/Kernel/
linux:/opt/otrs/Kernel# cp Config.pm.dist Config.pm
linux:/opt/otrs/Kernel# cd Config
linux:/opt/otrs/Kernel/Config# for foo in *.dist; do cp $foo `basename
$foo .dist`; done
linux:/opt/otrs/Kernel/Config#
</screen>
</para>

<para>
Zum Abschluss der Vorbereitungen werden noch die richtigen
Zugriffsrechte fr die Dateien des Ticket Systems gesetzt. Dazu kann
das Skript <command>SetPermissions.sh</command> verwendet werden, das sich
im Verzeichnis <filename>bin</filename> innerhalb des Homeverzeichnisses des
OTRS-Benutzers befindet. Das Skript kann mit folgenden Parametern
aufgerufen werden:
</para>

<para>
<cmdsynopsis>
  <command>SetPermissions.sh</command>
    <arg choice='req'>
      <replaceable>Homedirectory des OTRS Benutzers</replaceable>
    </arg>
    <arg choice='req'>
      <replaceable>OTRS Benutzer</replaceable>
    </arg>
    <arg choice='req'>
      <replaceable>Webserver Benutzer</replaceable>
    </arg>
    <arg choice='opt'>
      <replaceable>Gruppe des OTRS Benutzers</replaceable>
    </arg>
    <arg choice='opt'>
      <replaceable>Gruppe des Webserver Benutzers</replaceable>
    </arg>
  </cmdsynopsis>
</para>

<para>
Luft Ihr Webserver mit den Benutzerrechten des OTRS Benutzers, dann
lautet das Kommando also
<command>SetPermissions.sh /opt/otrs otrs otrs</command>. Unter SUSE Linux
wird der Webserver mit dem Benutzer wwwrun betrieben. Geben Sie hier
das Komando <command>SetPermissions.sh /opt/otrs otrs wwwrun</command> ein.
</para>

<para>
Nach diesen Schritten ist die Vorbereitung zur Installation des Ticket
Systems abgeschlossen und es kann der Webserver auf die Verwendung von OTRS
vorbereitet werden.
</para>

</sect2>

<sect2 id="installation-of-needed-perl-modules">
<title>Installation der fr OTRS bentigten perl-Module</title>

<para>
Fr den Betrieb von OTRS werden einige perl-Module bentigt. Wenn
Sie OTRS manuell einrichten, mssen Sie wahrscheinlich einige
dieser Module per Hand nachinstallieren. Dies knnen Sie entweder
ber den Paketmanager ihrer Distribution erledigen (<application>yast</application>,
<application>apt-get</application>), oder, wie in diesem Kapitel
beschrieben,  direkt ber die Shell von <application>perl</application>
und CPAN.
</para>

<para>
Die folgenden perl-Module werden von OTRS
bentigt.
</para>

<para>

<table id="table-of-needed-perl-modules">
<title>Die von OTRS bentigten perl-Module</title>
  <tgroup cols="2">
    <thead>
      <row>
        <entry>
          Name
        </entry>
        <entry>
          Beschreibung
        </entry>
      </row>
    </thead>
    <tbody>
      <row>
        <entry>
          CGI
        </entry>
        <entry>
          Mit diesem Modul wird die Darstellung der OTRS-Oberflche
          als Webinterface ermglicht.
        </entry>
      </row>
      <row>
        <entry>
          Date::Pcalc
        </entry>
        <entry>
          Dieses Modul enthlt Berechnungsgrundlagen zum
          gregorianischen Kalender und wird in OTRS z. B. fr die
          zeitspezifischen Berechnungen auf Tickets bentigt.
        </entry>
      </row>
      <row>
        <entry>
          DBI
        </entry>
        <entry>
          Dieses Modul wird von OTRS fr die Verbindung zum
          Datenbank-Backend bentigt.
        </entry>
      </row>
      <row>
        <entry>
          DBD::mysql
        </entry>
        <entry>
          Modul zum Verbindungsaufbau zum MySQL-Datenbank-Backend.
        </entry>
      </row>
      <row>
        <entry>
          Digest::MD5
        </entry>
        <entry>
          Ermglicht die Verwendung des md5-Algorithmus.
        </entry>
      </row>
      <row>
        <entry>
          LWP::UserAgent
        </entry>
        <entry>
          Modul zur Verarbeitung von http-Anfragen.
        </entry>
      </row>
      <row>
        <entry>
          MIME::Base64
        </entry>
        <entry>
          En- und Decodierung von Base64-Strings.
        </entry>
      </row>
      <row>
        <entry>
          MIME::Tools
        </entry>
        <entry>
          Modul mit verschiedenen Werkzeugen fr die Verarbeitung von
          Nachrichten mit MIME-Teil.
        </entry>
      </row>
      <row>
        <entry>
          Mail::Internet
        </entry>
        <entry>
          Modul fr die Bearbeitung von Emails nach RFC 822
        </entry>
      </row>
      <row>
        <entry>
          Net::DNS
        </entry>
        <entry>
          Schnittstelle zum Domain Name System (DNS).
        </entry>
      </row>
      <row>
        <entry>
          Net::POP3
        </entry>
        <entry>
          Modul mit Funktionen fr den Zugriff auf einen
          POP3-Server.
        </entry>
      </row>
      <row>
        <entry>
          Net::LDAP
        </entry>
        <entry>
          Modul zur Verarbeitung von Anfragen an ein LDAP-Directory. Dieses
          Modul wird nur bentigt, wenn OTRS mit einem LDAP-Directory
          betrieben werden soll, z. B. fuer die Abfrage von Kundendaten.
        </entry>
      </row>
      <row>
        <entry>
          Net::SMTP
        </entry>
        <entry>
          Modul mit Funktionen zum Versenden von Mails.
        </entry>
      </row>
      <row>
        <entry>
          Authen::SASL
        </entry>
        <entry>
          SASL Authentication Framework, wird z. B. fr die Anmeldung
          an Mailservern bentigt.
        </entry>
      </row>
      <row>
        <entry>
          GD
        </entry>
        <entry>
          Schnittstelle zur Gd Graphics Library. Wird nur
          bentigt, wenn das Statistikmodul von OTRS verwendet
          werden soll.
        </entry>
      </row>
      <row>
        <entry>
          GD::Text, GD::Graph, GD::Graph::lines, GD::Text::Align
        </entry>
        <entry>
          Text- und Grafikwerkzeuge fr die Benutzung zusammen mit der
          GD Graphics Library. Diese Komponenten werden nur bentigt,
          wenn das Statistikmodul von OTRS verwendet werden soll.
        </entry>
      </row>
      <row>
        <entry>
          XML::Parser
        </entry>
        <entry>
          Dieses Modul wird bentigt, um Konfigurationsparameter
          aus XML-Files auszulesen bzw. Konfigurationen in XML-Dateien zu
          schreiben. Die grafische Administrations-Oberflche von OTRS
          greift auf diese Mechanissmen zurck.
        </entry>
      </row>
    </tbody>
  </tgroup>
</table>

</para>

<para>
Um eines der oben aufgefhrten Module mit Hilfe von CPAN zu
installieren, geben Sie als root das Kommando
<command>perl -e shell -MCPAN</command> ein. perl wird im interaktiven
Modus gestartet und das CPAN Modul wird geladen. Ist CPAN bereits
ordentlich konfiguriert, knnen Sie die fr OTRS bentigten
Module mit Hilfe des Kommandos <command>install</command> gefolgt vom
Modulnamen einrichten. CPAN weist darauf hin, wenn Abhngigkeiten
zwischen einzelnen Modulen nicht erfllt sind und schlgt
automatisch die zustzlich bentigten Module fr die
Installation vor.
</para>

<para>
Nachdem Sie alle perl-Module installiert haben, knnen Sie mit Hilfe
des Skriptes <command>otrs.checkModules</command> berprfen, ob
OTRS wirklich alle bentigten Module finden und verwenden kann. Das
Skript finden sie im Verzeichnis <filename>bin</filename> innerhalb des
Homeverzeichnisses des OTRS Benutzers.
</para>

<para>
<screen>
linux:~# cd /opt/otrs/bin/
linux:/opt/otrs/bin# ./otrs.checkModules
                  CGI ... ok
          Date::Pcalc ... ok
                  DBI ... ok
           DBD::mysql ... ok
          Digest::MD5 ... ok
       LWP::UserAgent ... ok
           IO::Scalar ... ok
             IO::Wrap ... ok
         MIME::Base64 ... ok
          MIME::Tools ... ok
       Mail::Internet ... ok
             Net::DNS ... ok
            Net::POP3 ... ok
            Net::LDAP ... ok
            Net::SMTP ... ok
         Authen::SASL ... ok
                   GD ... ok
             GD::Text ... ok
            GD::Graph ... ok
     GD::Graph::lines ... ok
      GD::Text::Align ... ok
          XML::Parser ... ok
linux:/opt/otrs/bin#
</screen>
</para>

<para>
Fhren Sie weiterhin die beiden Befehle
<command>perl -cw bin/cgi-bin/index.pl</command> und
<command>perl -cw bin/PostMaster.pl</command> aus, nach dem Sie in das
Verzeichnis <filename>/opt/otrs</filename> gewechselt sind. Wird bei
beiden Befehlen die Meldung "syntax OK" angezeigt, verfgt Ihre
perl-Installation ber alle von OTRS bentigten Module und Sie
knnen im nchsten Schritt mit der Einrichtung des Webservers
beginnen.
</para>

<para>
<screen>
linux:~# cd /opt/otrs
linux:/opt/otrs# perl -cw cgi-bin/installer.pl
cgi-bin/installer.pl syntax OK
linux:/opt/otrs# perl -cw PostMaster.pl
PostMaster.pl syntax OK
linux:/opt/otrs#
</screen>
</para>

</sect2>

<sect2 id="webserver-configuration">
<title>Konfiguration des apache Webservers</title>

<para>
In diesem Abschnitt wird beschrieben, wie der
<application>apache</application> Webserver grundlegend fr OTRS
eingerichtet werden muss. Der Webserver solte cgi- bzw. perl-Skripte
ausfhren knnen, anderenfalls ist kein Betrieb von
OTRS mglich. berprfen Sie die Konfigurationsdateien Ihres
Webservers und stellen Sie fest, ob das cgi-Modul geladen wird: Wenn Ihr
Webserver die Ausfhrung von cgi-Skripten untersttzt, sollte
eine Zeile hnlich der folgenden zu finden sein.
</para>

<para>
<programlisting id="load-cgi-module">
LoadModule cgi_module /usr/lib/apache2/modules/mod_cgi.so
</programlisting>
</para>

<para>
Um die Oberflche von OTRS bequem erreichen zu knnen, wird ein
Alias- und ein ScriptAlias-Eintrag angelegt. Fr die meisten
Installationen des <application>apache</application> Webservers gilt, dass
ein Verzeichnis mit dem Namen <filename>conf.d</filename> vorhanden ist,
unter Linux ist es meist unterhalb des Verzeichnisses
<filename>/etc/apache</filename> bzw. <filename>/etc/apache2</filename> zu
finden. Wechseln Sie als root in dieses Verzeichnis und ffnen
Sie die Datei <filename>otrs.conf</filename> mit einem Editor bzw. legen
Sie diese Datei an. Tragen Sie die folgenden Zeilen in die Datei ein.
</para>

<para>
<programlisting id="basic-apache-configuration-for-otrs">
#
# Basic apache configuration for OTRS
#
# agent, admin and customer frontend
#
ScriptAlias /otrs/ "/opt/otrs/bin/cgi-bin/"
Alias /otrs-web/ "/opt/otrs/var/httpd/htdocs/"
#
# directory settings
#
&lt;Directory "/opt/otrs/bin/cgi-bin/"&gt;
    AllowOverride None
    Options +ExecCGI -Includes
    Order allow,deny
    Allow from all
&lt;/Directory&gt;
&lt;Directory "/opt/otrs/var/httpd/htdocs/"&gt;
    AllowOverride None
    Order allow,deny
    Allow from all
&lt;/Directory&gt;
</programlisting>
</para>

<para>
Speichern Sie die Datei, schlieen Sie den Editor und starten Sie Ihren
Webserver neu, um die neue Konfiguration zu laden. Auf den meisten Systemen
lsst sich der Webserver ber den Befehl
<command>/etc/init.d/apache restart</command> bzw.
<command>/etc/init.d/apache2 restart</command> neu starten.
</para>

<para>
<screen>
linux:/etc/apache2/conf.d# /etc/init.d/apache2 restart
Forcing reload of web server: Apache2.
linux:/etc/apache2/conf.d#
</screen>
</para>

<para>
Das war bereits die grundlegende Konfiguration des Webservers fr
OTRS. Im nchsten Schritt kann die Datenbank eingerichtet werden.
</para>
</sect2>

<sect2 id="database-configuration">
<title>Einrichten der Datenbank</title>

<sect3 id="installation-of-database-with-the-webinstaller">
<title>Einrichtung der Datenbank mit Hilfe des Webinstallers (nur fr
<application>MySQL</application>)</title>

<para>
Wenn Sie <application>MySQL</application> als Datenbankserver einsetzen,
knnen Sie die OTRS Datenbank leicht und bequem mit Hilfe des
Webinstallers einrichten. Geben Sie folgende Adresse in Ihrem Browser ein,
um den Webinstaller zu starten:
</para>

<para>
<ulink url="http://localhost/otrs/installer.pl">
<citetitle>http://localhost/otrs/installer.pl</citetitle>
</ulink>
</para>

<para>
Der Webinstaller wird gestartet. Folgen Sie den Anweisungen auf dem
Bildschirm.
</para>

<para>
<screenshot>
<screeninfo>installer.pl screen - Lizenz (1/4)</screeninfo>
<graphic srccredit="installer.pl - screenshot" scale="40" fileref="screenshots/installer.png"></graphic>
</screenshot>
</para>

<para>
<screenshot>
<screeninfo>installer.pl screen - Datenbank erstellen (2/4)</screeninfo>
<graphic srccredit="installer.pl - screenshot" scale="40" fileref="screenshots/installer1.png"></graphic>
</screenshot>
</para>

<warning>
<para>
Es ist niemals eine gute Idee, Standardpasswrter zu
verwenden! Bitte ndern Sie deshalb unbedingt das von OTRS
standardmig gesetzte Passwort!
</para>
</warning>

<para>
<screenshot>
<screeninfo>installer.pl screen - Datenbank erstellen (2/4)</screeninfo>
<graphic srccredit="installer.pl - screenshot" scale="40" fileref="screenshots/installer2.png"></graphic>
</screenshot>
</para>

<para>
<screenshot>
<screeninfo>installer.pl screen - System einstellungen (3/4)</screeninfo>
<graphic srccredit="installer.pl - screenshot" scale="40" fileref="screenshots/installer3.png"></graphic>
</screenshot>
</para>

<para>
<screenshot>
<screeninfo>installer.pl screen - Fertig (4/4)</screeninfo>
<graphic srccredit="installer.pl - screenshot" scale="40" fileref="screenshots/installer4.png"></graphic>
</screenshot>
</para>

<para>
Die OTRS Datenbank wurde aufgesetzt. Im nchsten Schritt werden die
cron-Jobs eingerichtet, die von OTRS bentigt werden.
</para>

</sect3>

<sect3 id="manual-installation-of-database">
<title>Manuelle Installation der OTRS Datenbank</title>

<para>
Wenn Sie den Webinstaller nicht einsetzen knnen, kann die Datenbank
fr OTRS auch manuell eingerichtet werden. Skripte mit dem
Datenbankschema und den SQL-Statements finden Sie im Verzeichnis
<filename>scripts/database</filename> innerhalb des Homeverzeichnisses des
OTRS Benutzers.
</para>

<para>
<screen>
linux:~# cd /opt/otrs/scripts/database/
linux:/opt/otrs/scripts/database# ls
initial_insert.sapdb.sql    otrs-schema-post.maxdb.sql
initial_insert.sql          otrs-schema-post.mysql.sql
otrs-schema.maxdb.sql       otrs-schema-post.oracle.sql
otrs-schema.mysql.sql       otrs-schema-post.postgresql.sql
otrs-schema.oracle.sql      otrs-schema.xml
otrs-schema.postgresql.sql
linux:/opt/otrs/scripts/database#
</screen>
</para>

<para>
Fr die verschiedenen Datenbanktypen sind mehrere .sql-Dateien
vorhanden, die nacheinander abgearbeitet werden mssen. Um die Datenbank
anzulegen, gehen Sie folgendermaen vor:
</para>

<para>
<orderedlist numeration="arabic">
<title>Die verschiedenen Schritte fr die manuelle Erstellung der
Datenbank</title>
<listitem>
<para>
Anlegen der Datenbank fr OTRS: Legen Sie mit Hilfe Ihres
Datenbankinterfaces bzw. Ihrer Datenbankoberflche die Datenbank
an, die spter von OTRS verwendet werden soll.
</para>
</listitem>
<listitem>
<para>
Erstellen der Tabellen: Mit Hilfe der otrs-schema.Datenbanktyp.sql-Dateien
(z. B. <filename>otrs-schema.oracle.sql</filename>,
<filename>otrs-schema.postgresql.sql</filename>, usw.) knnen Sie die
Tabellen innerhalb der OTRS Datenbank erzeugen.
</para>
</listitem>
<listitem>
<para>
Einfgen der vom System bentigten Daten: Damit OTRS richtig
funktioniert, mssen einige Daten in verschiedene Tabellen geschrieben
werden (z. B. die verschiedenen Ticketstatus, Ticket- und
Benachrichtigungstypen, etc.). Verwenden Sie entweder die Datei
<filename>initial_insert.sql</filename> oder
<filename>initial_insert.sapdb.sql</filename> zum Einspielen der Daten,
je nachdem welche Datenbank verwendet wird.
</para>
</listitem>
<listitem>
<para>
Erzeugen von "foreign keys" auf andere Tabellen: Abschlieend
mssen noch die "foreign keys" erstellt werden, ber die die
verschiedenen Tabellen in der OTRS Datenbank voneinander abhngen.
Dies kann mit Hilfe der otrs-schema-post.Datenbanktyp.sql-Dateien erreicht
werden (z. B. <filename>otrs-schema-oracle.post.sql</filename>,
<filename>otrs-schema-post.postgresql.sql</filename>, usw.).
</para>
</listitem>
</orderedlist>
</para>

<para>
Nachdem Sie die Datenbank angelegt haben, sollten Sie die Zugriffsrechte
dafr setzen und z. B. sicherstellen, dass nur ein bestimmter
Benutzer ohne Datenbank-Administrationsrechte Zugriff auf die OTRS
Datenbank hat. Je nachdem, welche Datenbank Sie einsetzen, unterscheiden
sich hier die Vorgehensweisen, es sollte jedoch mglich sein dies mit
Hilfe Ihres Datenbankinterfaces bzw. Ihrer Datenbankoberflche zu
erledigen.
</para>

<para>
Wurden die ntigen Einstellungen fr die Datenbank vorgenommen,
muss nun noch dem Ticket System mitgeteilt werden, welche Datenbank es
verwenden soll. ffnen Sie die Datei
<filename>Kernel/Config.pm</filename> innerhalb des Homeverzeichnisses des
OTRS Benutzers und passen Sie die dafr vorgesehenen Parameter an. Am
wichtigsten sind die folgenden Parameter.
</para>

<para>
<programlisting>

    # Database
    # (The database name.)
    $Self->{Database} = 'otrs';

    # DatabaseUser
    # (The database user.)
    $Self->{DatabaseUser} = 'otrs';

    # DatabasePw
    # (The password of database user.)
    $Self->{DatabasePw} = 'some-pass';

</programlisting>
</para>

<para>
Nachdem nun die Verbindung zur Datenbank steht, knnen im
nchsten Schritt die verschiedenen cron-Jobs fr OTRS
eingerichtet werden.
</para>

</sect3>

</sect2>

<sect2 id="cronjobs">
<title>Einrichten der von OTRS bentigten cron-Jobs</title>

<para>
Damit OTRS voll funktioniert, werden einige cron-Jobs bentigt. Die
cron-Jobs sollten mit denselben Benutzerrechten ausgefhrt werden,
die auch fr die restlichen OTRS-Skripte vergeben wurden, d.h. die
cronJobs sollten in die crontab des OTRS-Benutzers eingetragen werden. Alle
Skripte fr die verschiedenen cron-Jobs befinden sich im Verzeichnis
<filename>var/cron</filename> innerhalb des Homeverzeichnisses des
OTRS-Benutzers.
</para>

<para>
<screen>
linux:~# cd /opt/otrs/var/cron
linux:/opt/otrs/var/cron# ls
aaa_base.dist                pending_jobs.dist          session.dist
fetchmail.dist               postmaster.dist            unlock.dist
generic_agent-database.dist  postmaster_pop3.dist
generic_agent.dist           rebuild_ticket_index.dist
linux:/opt/otrs/var/cron#
</screen>
</para>

<para>
Alle Skripte tragen die Endung .dist und sollten zunchst so
umkopiert werden, dass keine Endung mehr vorhanden ist.
</para>

<para>
<screen>
linux:/opt/otrs/var/cron# for foo in `ls -1 *.dist` ; do cp $foo
`basename $foo .dist`; done
linux:/opt/otrs/var/cron# ls
aaa_base                     generic_agent.dist    rebuild_ticket_index
aaa_base.dist                pending_jobs
rebuild_ticket_index.dist
fetchmail                    pending_jobs.dist     session
fetchmail.dist               postmaster            session.dist
generic_agent                postmaster.dist       unlock
generic_agent-database       postmaster_pop3       unlock.dist
generic_agent-database.dist  postmaster_pop3.dist
linux:/opt/otrs/var/cron#
</screen>
</para>

<para>
Die folgende Tabelle gibt eine kurze bersicht ber die Aufgabe
der verschiedenen Skripte, die als cron-Job in der crontab des
OTRS-Benutzers installiert werden sollten.
</para>

<para>
<table id="table-of-cronjobs-for-otrs">
<title>Die verschiedenen Skripte fr die cron-Jobs von OTRS</title>
  <tgroup cols="2">
    <thead>
      <row>
        <entry>
          Skript
        </entry>
        <entry>
          Aufgabe
        </entry>
      </row>
    </thead>
    <tbody>
      <row>
        <entry>
          aaa_base
        </entry>
        <entry>
          ber dieses Skript werden die grundlegenden Einstellungen
          fr die crontab des OTRS-Benutzers festgelegt.
        </entry>
      </row>
      <row>
        <entry>
          fetchmail
        </entry>
        <entry>
          Falls Nachrichten mit Hilfe von fetchmail in das System
          eingespeit werden sollen, kann dieses Skript verwendet werden.
        </entry>
      </row>
      <row>
        <entry>
          generic_agent
        </entry>
        <entry>
          Mit Hilfe dieses Skripts werden die Jobs des GenericAgents
          ausgefhrt, die ber eigene Konfigurationsdateien
          festgelegt wurden.
        </entry>
      </row>
      <row>
        <entry>
          generic_agent-database
        </entry>
        <entry>
          Mit Hilfe dieses Skripts werden die Jobs des GenericAgents
          ausgefhrt, die ber dem Administrations-Bereich
          innerhalb von "GenericAgent" angelegt wurden.
        </entry>
      </row>
      <row>
        <entry>
          pending_jobs
        </entry>
        <entry>
          Mit Hilfe dieses Skripts wird das System auf "wartende" (pending)
          Tickets berprft.
        </entry>
      </row>
      <row>
        <entry>
          postmaster
        </entry>
        <entry>
          Mit Hilfe dieses Skripts wird die Nachrichten-Warteschlange von
          OTRS berprft und noch nicht verarbeitete Nachrichten
          werden im System gespeichert bzw. zugestellt..
        </entry>
      </row>
      <row>
        <entry>
          postmaster_pop3
        </entry>
        <entry>
          Mit Hilfe dieses Skripts werden die verschiedenen pop3-Konten
          abgefragt, die im Administrations-Bereich innerhalb von
          "PostMaster POP3 Account" eingerichtet wurden.
        </entry>
      </row>
      <row>
        <entry>
          rebuild_ticket_index
        </entry>
        <entry>
          Mit Hilfe dieses Skripts wird der Ticket-Index fr die
          Queue-Ansicht neu erzeugt, wodurch die Anzeige beschleunigt wird.
        </entry>
      </row>
      <row>
        <entry>
          session
        </entry>
        <entry>
          ber dieses Skript werden alte und nicht mehr gltige
          Session-IDs entfernt.
        </entry>
      </row>
      <row>
        <entry>
          unlock
        </entry>
        <entry>
          Mit Hilfe dieses Skripts wird die Freigabe von Tickets innerhalb
          des Systems ermglicht.
        </entry>
      </row>
    </tbody>
  </tgroup>
</table>
</para>

<para>
Fr die Einrichtung aller cron-Jobs kann das Skript
<filename>Cron.sh</filename> verwendet werden, das sich im Verzeichnis
<filename>bin</filename> innerhalb des Homeverzeichnisses des
OTRS-Benutzers befindet. Dem Cron.sh Skript muss beim Aufruf ein
Parameter bergeben werden. Dieser Parameter legt fest, ob die
cron-Jobs installiert, deinstalliert oder neu gestartet werden. Es sind
folgende Parameter zulssig.
</para>

<para>
<cmdsynopsis>
  <command>Cron.sh</command>
    <arg choice='req'>
      <replaceable>start</replaceable>
    </arg>
    <arg choice='req'>
      <replaceable>stop</replaceable>
    </arg>
    <arg choice='req'>
      <replaceable>restart</replaceable>
    </arg>
    <arg choice='opt'>
      <replaceable>OTRS-Benutzer</replaceable>
    </arg>
  </cmdsynopsis>
</para>

<para>
Da die cron-Jobs fr den OTRS-Benutzer angelegt werden sollen,
muss das Skript von diesem Benutzer ausgefhrt werden. Sind Sie z. B.
als Benutzer root am System angemeldet, knnen Sie mit Hilfe des
Kommandos <command>su otrs</command> zum OTRS-Benutzer wechseln. Nehmen Sie
also die Installation wie folgt vor.
</para>

<warning>
<para>
Bitte beachten Sie, dass durch die Verwendung von
<filename>Cron.sh</filename> evtl. andere Cron-Jobs des OTRS-Benutzers
berschrieben bzw. gelscht werden. Um weitere, nicht von OTRS bentigte
Cron-Jobs fr den OTRS-Benutzer zu installieren, erweitern Sie bitte
<filename>Cron.sh</filename> dementsprechent.
</para>
</warning>

<para>
<screen>
linux:/opt/otrs/var/cron# cd /opt/otrs/bin/
linux:/opt/otrs/bin# su otrs
linux:~/bin$ ./Cron.sh start
Cron.sh - start/stop OTRS cronjobs - &lt;$Revision: 1.13 $&gt;
Copyright (c) 2002 Martin Edenhofer &lt;martin@otrs.org&gt;
(using /opt/otrs) done
linux:~/bin$ exit
exit
linux:/opt/otrs/bin#
</screen>
</para>

<para>
Mit Hilfe des Kommandos <command>crontab -l -u otrs</command>, das Sie als
root ausfhren knnen, wird die crontab-Datei des OTRS-Benutzers
angezeigt und Sie knnen berprfen, ob alle Eintrge
vorhanden sind.
</para>

<para>
<screen>
linux:/opt/otrs/bin# crontab -l -u otrs
# --
# cron/aaa_base - base crontab package
# Copyright (C) 2002-2003 Martin Edenhofer &lt;martin+code@otrs.org&gt;
# --
# $Id: installation-and-basic-configuration.xml,v 1.13 2006/08/16 14:04:18 cs Exp $
# This software comes with ABSOLUTELY NO WARRANTY.
# --
# Who gets the cron emails?
MAILTO="root@localhost"

# --
# cron/fetchmail - fetchmail cron of the OTRS
# Copyright (C) 2002-2003 Martin Edenhofer &lt;martin+code@otrs.org&gt;
# --
# $Id: installation-and-basic-configuration.xml,v 1.13 2006/08/16 14:04:18 cs Exp $
# This software comes with ABSOLUTELY NO WARRANTY.
# --
# fetch every 5 minutes emails via fetchmail
#*/5 * * * * /usr/bin/fetchmail -a &gt;&gt; /dev/null

# --
# cron/generic_agent - GenericAgent.pl cron of the OTRS
# Copyright (C) 2002-2003 Martin Edenhofer &lt;martin+code@otrs.org&gt;
# --
# $Id: installation-and-basic-configuration.xml,v 1.13 2006/08/16 14:04:18 cs Exp $
# --
# This software comes with ABSOLUTELY NO WARRANTY.
# --
# start generic agent every 20 minutes
*/20 * * * * $HOME/bin/GenericAgent.pl &gt;&gt; /dev/null
# example to execute GenericAgent.pl on 23:00 with
# Kernel::Config::GenericAgentMove job file
#0 23 * * * $HOME/bin/GenericAgent.pl -c "Kernel::Config::GenericAgentMove" &gt;&gt; /dev/null
# --
# cron/generic_agent - GenericAgent.pl cron of the OTRS
# Copyright (C) 2001-2004 Martin Edenhofer &lt;martin+code@otrs.org&gt;
# --
# $Id: installation-and-basic-configuration.xml,v 1.13 2006/08/16 14:04:18 cs Exp $
# --
# This software comes with ABSOLUTELY NO WARRANTY.
# --
# start generic agent every 10 minutes
*/10 * * * * $HOME/bin/GenericAgent.pl -c db &gt;&gt; /dev/null
# --
# cron/pending_jobs - pending_jobs cron of the OTRS
# Copyright (C) 2002-2003 Martin Edenhofer &lt;martin+code@otrs.org&gt;
# --
# $Id: installation-and-basic-configuration.xml,v 1.13 2006/08/16 14:04:18 cs Exp $
# --
# This software comes with ABSOLUTELY NO WARRANTY.
# --
# check every 120 min the pending jobs
45 */2 * * * $HOME/bin/PendingJobs.pl &gt;&gt; /dev/null
# --
# cron/postmaster - postmaster cron of the OTRS
# Copyright (C) 2002-2003 Martin Edenhofer &lt;martin+code@otrs.org&gt;
# --
# $Id: installation-and-basic-configuration.xml,v 1.13 2006/08/16 14:04:18 cs Exp $
# --
# This software comes with ABSOLUTELY NO WARRANTY.
# --
# check daily the spool directory of OTRS
#10 0 * * * * test -e /etc/init.d/otrs &amp; /etc/init.d/otrs cleanup &gt;&gt; /dev/null; test -e /etc/rc.d/init.d/otrs &amp;&amp; /etc/rc.d/init.d/otrs cleanup &gt;&gt; /dev/null
10 0 * * * $HOME/bin/otrs.cleanup &gt;&gt; /dev/null
# --
# cron/postmaster_pop3 - postmaster_pop3 cron of the OTRS
# Copyright (C) 2002-2003 Martin Edenhofer &lt;martin+code@otrs.org&gt;
# --
# $Id: installation-and-basic-configuration.xml,v 1.13 2006/08/16 14:04:18 cs Exp $
# --
# This software comes with ABSOLUTELY NO WARRANTY.
# --
# fetch emails every 10 minutes
*/10 * * * * $HOME/bin/PostMasterPOP3.pl &gt;&gt; /dev/null
# --
# cron/rebuild_ticket_index - rebuild ticket index for OTRS
# Copyright (C) 2002-2003 Martin Edenhofer &lt;martin+code@otrs.org&gt;
# --
# $Id: installation-and-basic-configuration.xml,v 1.13 2006/08/16 14:04:18 cs Exp $
# This software comes with ABSOLUTELY NO WARRANTY.
# --
# just every day
01 01 * * * $HOME/bin/RebuildTicketIndex.pl &gt;&gt; /dev/null

# --
# cron/session - delete old session ids of the OTRS
# Copyright (C) 2001-2004 Martin Edenhofer &lt;martin+code@otrs.org&gt;
# --
# $Id: installation-and-basic-configuration.xml,v 1.13 2006/08/16 14:04:18 cs Exp $
# This software comes with ABSOLUTELY NO WARRANTY.
# --
# delete every 120 minutes old/idle session ids
55 */2 * * * $HOME/bin/DeleteSessionIDs.pl --expired &gt;&gt; /dev/null

# --
# cron/unlock - unlock old locked ticket of the OTRS
# Copyright (C) 2002-2003 Martin Edenhofer &lt;martin+code@otrs.org&gt;
# --
# $Id: installation-and-basic-configuration.xml,v 1.13 2006/08/16 14:04:18 cs Exp $
# This software comes with ABSOLUTELY NO WARRANTY.
# --
# unlock every hour old locked tickets
35 * * * * $HOME/bin/UnlockTickets.pl --timeout &gt;&gt; /dev/null

linux:/opt/otrs/bin#
</screen>
</para>

<para>
Nach der Einrichtung der Cron-Jobs ist die Installation von OTRS
abgeschlossen, Sie knnen das System nun ber dessen Weboberflche weiter
an Ihre Bedrfnisse anpassen und benutzen.
</para>

</sect2>

</sect1>

</chapter>