3.2. Manuelle Installation (Linux, Unix)

3.2.1. Vorbereiten der manuellen Installation

Wenn Sie OTRS manuell über die Quellen installieren möchten oder müssen, laden Sie sich zuerst das aktuelle Archiv herunter. Sie finden die entsprechenden .tar.gz- oder .tar.bz2-Dateien im Downloadbereich auf http://www.otrs.org

Entpacken Sie das Archiv mit Hilfe von tar z. B. in das Verzeichnis /opt:

linux:/opt# tar xf /tmp/otrs-2.0.0.tar.gz
linux:/opt# ls
otrs
linux:/opt#

Da die Skripte von OTRS später nicht mit root-Rechten laufen sollen, muss im nächsten Schritt ein Benutzer für OTRS im System angelegt werden. Dieser Benutzer sollte als Homeverzeichnis das Verzeichnis erhalten, in das gerade die Quellen von OTRS entpackt wurden, also /opt/otrs. Wird der Webserver unter einem anderen Benutzer als dem OTRS-User betrieben, so muss der neue OTRS-Benutzer noch zur Gruppe des Webserver-Users hinzugefügt werden.

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

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

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#

Zum Abschluss der Vorbereitungen werden noch die richtigen Zugriffsrechte für die Dateien des Ticket Systems gesetzt. Dazu kann das Skript SetPermissions.sh verwendet werden, das sich im Verzeichnis bin innerhalb des Homeverzeichnisses des OTRS-Benutzers befindet. Das Skript kann mit folgenden Parametern aufgerufen werden:

SetPermissions.sh { Homedirectory des OTRS Benutzers } { OTRS Benutzer } { Webserver Benutzer } [ Gruppe des OTRS Benutzers ] [ Gruppe des Webserver Benutzers ]

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

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

3.2.2. Installation der für OTRS benötigten Perl-Module

Für den Betrieb von OTRS werden einige Perl-Module benötigt. Wenn Sie OTRS manuell einrichten, müssen Sie wahrscheinlich einige dieser Module per Hand nachinstallieren. Dies können Sie entweder über den Paketmanager ihrer Distribution erledigen (yast, apt-get), oder, wie in diesem Kapitel beschrieben, direkt über die Shell von Perl und CPAN.

Die folgenden Perl-Module werden von OTRS benötigt.

Um eines der oben aufgeführten Module mit Hilfe von CPAN zu installieren, geben Sie als root das Kommando perl -e shell -MCPAN ein. Perl wird im interaktiven Modus gestartet und das CPAN Modul wird geladen. Ist CPAN bereits ordentlich konfiguriert, können Sie die für OTRS benötigten Module mit Hilfe des Kommandos install gefolgt vom Modulnamen einrichten. CPAN weist darauf hin, wenn Abhängigkeiten zwischen einzelnen Modulen nicht erfüllt sind und schlägt automatisch die zusätzlich benötigten Module für die Installation vor.

Nachdem Sie alle Perl-Module installiert haben, können Sie mit Hilfe des Skriptes otrs.checkModules überprüfen, ob OTRS wirklich alle benötigten Module finden und verwenden kann. Das Skript finden sie im Verzeichnis bin innerhalb des Homeverzeichnisses des OTRS Benutzers.

linux:~# cd /opt/otrs/bin/
linux:/opt/otrs/bin# ./otrs.checkModules

                  CGI ... ok
          Date::Pcalc ... ok
         Date::Format ... ok
                  DBI ... ok
           DBD::mysql ... ok
          Digest::MD5 ... ok
     Crypt::PasswdMD5 ... 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
            PDF::API2 ... not installed! (for PDF output - not required)
       Compress::Zlib ... ok
linux:/opt/otrs/bin#

Führen Sie weiterhin die beiden Befehle perl -cw bin/cgi-bin/index.pl und perl -cw bin/PostMaster.pl aus, nach dem Sie in das Verzeichnis /opt/otrs gewechselt sind. Wird bei beiden Befehlen die Meldung "syntax OK" angezeigt, verfügt Ihre Perl-Installation über alle von OTRS benötigten Module und Sie können im nächsten Schritt mit der Einrichtung des Webservers beginnen.

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#

3.2.3. Konfiguration des apache Webservers

In diesem Abschnitt wird beschrieben, wie der apache Webserver grundlegend für OTRS eingerichtet werden muss. Der Webserver solte cgi- bzw. Perl-Skripte ausführen können, anderenfalls ist kein Betrieb von OTRS möglich. Überprüfen Sie die Konfigurationsdateien Ihres Webservers und stellen Sie fest, ob das cgi-Modul geladen wird: Wenn Ihr Webserver die Ausführung von cgi-Skripten unterstützt, sollte eine Zeile ähnlich der folgenden zu finden sein.

LoadModule cgi_module /usr/lib/apache2/modules/mod_cgi.so

Um die Oberfläche von OTRS bequem erreichen zu können, wird ein Alias- und ein ScriptAlias-Eintrag angelegt. Für die meisten Installationen des apache Webservers gilt, dass ein Verzeichnis mit dem Namen conf.d vorhanden ist, unter Linux ist es meist unterhalb des Verzeichnisses /etc/apache bzw. /etc/apache2 zu finden. Wechseln Sie als root in dieses Verzeichnis und öffnen Sie die Datei otrs.conf mit einem Editor bzw. legen Sie diese Datei an. Tragen Sie die folgenden Zeilen in die Datei ein.

#
# 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
#
<Directory "/opt/otrs/bin/cgi-bin/">
    AllowOverride None
    Options +ExecCGI -Includes
    Order allow,deny
    Allow from all
</Directory>
<Directory "/opt/otrs/var/httpd/htdocs/">
    AllowOverride None
    Order allow,deny
    Allow from all
</Directory>

Speichern Sie die Datei, schließen Sie den Editor und starten Sie Ihren Webserver neu, um die neue Konfiguration zu laden. Auf den meisten Systemen lässt sich der Webserver über den Befehl /etc/init.d/apache restart bzw. /etc/init.d/apache2 restart neu starten.

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

Das war bereits die grundlegende Konfiguration des Webservers für OTRS. Im nächsten Schritt kann die Datenbank eingerichtet werden.

3.2.4. Einrichten der Datenbank

3.2.4.1. Einrichtung der Datenbank mit Hilfe des Webinstallers (nur für MySQL)

Wenn Sie MySQL als Datenbankserver einsetzen, können 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:

http://localhost/otrs/installer.pl

Der Webinstaller wird gestartet. Folgen Sie den Anweisungen auf dem Bildschirm.

Es ist niemals eine gute Idee, Standardpasswörter zu verwenden! Bitte ändern Sie deshalb unbedingt das von OTRS standardmäßig gesetzte Passwort!

Die OTRS Datenbank wurde aufgesetzt. Im nächsten Schritt werden die cron-Jobs eingerichtet, die von OTRS benötigt werden.

linux:~# cd /opt/otrs/scripts/database/
linux:/opt/otrs/scripts/database# ls
otrs-initial_insert.db2.sql         otrs-schema.mysql.sql
otrs-initial_insert.maxdb.sql       otrs-schema.oracle.sql
otrs-initial_insert.mssql.sql       otrs-schema-post.db2.sql
otrs-initial_insert.mysql.sql       otrs-schema.postgresql.sql
otrs-initial_insert.oracle.sql      otrs-schema-post.maxdb.sql
otrs-initial_insert.postgresql.sql  otrs-schema-post.mssql.sql
otrs-initial_insert.xml             otrs-schema-post.mysql.sql
otrs-schema.db2.sql                 otrs-schema-post.oracle.sql
otrs-schema.maxdb.sql               otrs-schema-post.postgresql.sql
otrs-schema.mssql.sql               otrs-schema.xml
linux:/opt/otrs/scripts/database#

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

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

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

3.2.5. Einrichten der von OTRS benötigten cron-Jobs

Damit OTRS voll funktioniert, werden einige cron-Jobs benötigt. Die cron-Jobs sollten mit denselben Benutzerrechten ausgeführt werden, die auch für die restlichen OTRS-Skripte vergeben wurden, d.h. die cronJobs sollten in die crontab des OTRS-Benutzers eingetragen werden. Alle Skripte für die verschiedenen cron-Jobs befinden sich im Verzeichnis var/cron innerhalb des Homeverzeichnisses des OTRS-Benutzers.

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#

Alle Skripte tragen die Endung .dist und sollten zunächst so umkopiert werden, dass keine Endung mehr vorhanden ist.

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#

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.

Für die Einrichtung aller cron-Jobs kann das Skript Cron.sh verwendet werden, das sich im Verzeichnis bin 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 zulässig.

Cron.sh { start } { stop } { restart } [ OTRS-Benutzer ]

Da die cron-Jobs für den OTRS-Benutzer angelegt werden sollen, muss das Skript von diesem Benutzer ausgeführt werden. Sind Sie z. B. als Benutzer root am System angemeldet, können Sie mit Hilfe des Kommandos su otrs zum OTRS-Benutzer wechseln. Nehmen Sie also die Installation wie folgt vor.

Bitte beachten Sie, dass durch die Verwendung von Cron.sh evtl. andere Cron-Jobs des OTRS-Benutzers überschrieben bzw. gelöscht werden. Um weitere, nicht von OTRS benötigte Cron-Jobs für den OTRS-Benutzer zu installieren, erweitern Sie bitte Cron.sh dementsprechent.

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 - <$Revision: 1.21.2.2 $>
Copyright (c) 2002 Martin Edenhofer <martin@otrs.org>
(using /opt/otrs) done
linux:~/bin$ exit
exit
linux:/opt/otrs/bin#

Mit Hilfe des Kommandos crontab -l -u otrs, das Sie als root ausführen können, wird die crontab-Datei des OTRS-Benutzers angezeigt und Sie können überprüfen, ob alle Einträge vorhanden sind.

linux:/opt/otrs/bin# crontab -l -u otrs
# --
# cron/aaa_base - base crontab package
# Copyright (C) 2001-2008 OTRS AG, http://otrs.org/
# --
# $Id: installation-and-basic-configuration.xml,v 1.21.2.2 2008/10/29 10:01:47 ub 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) 2001-2008 OTRS AG, http://otrs.org/
# --
# $Id: installation-and-basic-configuration.xml,v 1.21.2.2 2008/10/29 10:01:47 ub Exp $
# This software comes with ABSOLUTELY NO WARRANTY.
# --
# fetch every 5 minutes emails via fetchmail
#*/5 * * * * /usr/bin/fetchmail -a >> /dev/null

# --
# cron/generic_agent - GenericAgent.pl cron of the OTRS
# Copyright (C) 2001-2008 OTRS AG, http://otrs.org/
# --
# $Id: installation-and-basic-configuration.xml,v 1.21.2.2 2008/10/29 10:01:47 ub Exp $
# --
# This software comes with ABSOLUTELY NO WARRANTY.
# --
# start generic agent every 20 minutes
*/20 * * * * $HOME/bin/GenericAgent.pl >> /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" >> /dev/null
# --
# cron/generic_agent - GenericAgent.pl cron of the OTRS
# Copyright (C) 2001-2008 OTRS AG, http://otrs.org/
# --
# $Id: installation-and-basic-configuration.xml,v 1.21.2.2 2008/10/29 10:01:47 ub Exp $
# --
# This software comes with ABSOLUTELY NO WARRANTY.
# --
# start generic agent every 10 minutes
*/10 * * * * $HOME/bin/GenericAgent.pl -c db >> /dev/null
# --
# cron/pending_jobs - pending_jobs cron of the OTRS
# Copyright (C) 2001-2008 OTRS AG, http://otrs.org/
# --
# $Id: installation-and-basic-configuration.xml,v 1.21.2.2 2008/10/29 10:01:47 ub Exp $
# --
# This software comes with ABSOLUTELY NO WARRANTY.
# --
# check every 120 min the pending jobs
45 */2 * * * $HOME/bin/PendingJobs.pl >> /dev/null
# --
# cron/postmaster - postmaster cron of the OTRS
# Copyright (C) 2001-2008 OTRS AG, http://otrs.org/
# --
# $Id: installation-and-basic-configuration.xml,v 1.21.2.2 2008/10/29 10:01:47 ub Exp $
# --
# This software comes with ABSOLUTELY NO WARRANTY.
# --
# check daily the spool directory of OTRS
#10 0 * * * * test -e /etc/init.d/otrs & /etc/init.d/otrs cleanup >> /dev/null; test -e /etc/rc.d/init.d/otrs && /etc/rc.d/init.d/otrs cleanup >> /dev/null
10 0 * * * $HOME/bin/otrs.cleanup >> /dev/null
# --
# cron/postmaster_pop3 - postmaster_pop3 cron of the OTRS
# Copyright (C) 2001-2008 OTRS AG, http://otrs.org/
# --
# $Id: installation-and-basic-configuration.xml,v 1.21.2.2 2008/10/29 10:01:47 ub Exp $
# --
# This software comes with ABSOLUTELY NO WARRANTY.
# --
# fetch emails every 10 minutes
*/10 * * * * $HOME/bin/PostMasterPOP3.pl >> /dev/null
# --
# cron/rebuild_ticket_index - rebuild ticket index for OTRS
# Copyright (C) 2001-2008 OTRS AG, http://otrs.org/
# --
# $Id: installation-and-basic-configuration.xml,v 1.21.2.2 2008/10/29 10:01:47 ub Exp $
# This software comes with ABSOLUTELY NO WARRANTY.
# --
# just every day
01 01 * * * $HOME/bin/RebuildTicketIndex.pl >> /dev/null

# --
# cron/session - delete old session ids of the OTRS
# Copyright (C) 2001-2008 OTRS AG, http://otrs.org/
# --
# $Id: installation-and-basic-configuration.xml,v 1.21.2.2 2008/10/29 10:01:47 ub Exp $
# This software comes with ABSOLUTELY NO WARRANTY.
# --
# delete every 120 minutes old/idle session ids
55 */2 * * * $HOME/bin/DeleteSessionIDs.pl --expired >> /dev/null

# --
# cron/unlock - unlock old locked ticket of the OTRS
# Copyright (C) 2001-2008 OTRS AG, http://otrs.org/
# --
# $Id: installation-and-basic-configuration.xml,v 1.21.2.2 2008/10/29 10:01:47 ub Exp $
# This software comes with ABSOLUTELY NO WARRANTY.
# --
# unlock every hour old locked tickets
35 * * * * $HOME/bin/UnlockTickets.pl --timeout >> /dev/null

linux:/opt/otrs/bin#

Nach der Einrichtung der Cron-Jobs ist die Installation von OTRS abgeschlossen, Sie können das System nun über dessen Weboberfläche weiter an Ihre Bedürfnisse anpassen und benutzen.