Book:OTRS 3.0 - Admin Manual (de)/Chapter 3/2

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/downloads.

Entpacken Sie das Archiv mit Hilfe von tar z. B. in das Verzeichnis  und benennen Sie das entpackte Verzeichnis von 'otrs-3.0.x' in 'otrs' um:

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. 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.

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  bzw. und haben die Endung .dist.

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:



Läuft Ihr Webserver mit den Benutzerrechten des Benutzers 'otrs', dann lautet das Kommando also otrs.SetPermissions.pl /opt/otrs --otrs-user=otrs --web-user=otrs. Unter SUSE Linux wird der Webserver mit dem Benutzer wwwrun betrieben. Auf Debian-basierten Systemen ist dies www-data. Geben Sie hier das Komando otrs.SetPermissions.pl /opt/otrs --otrs-user=otrs --web-user=wwwrun --otrs-group=nogroup --web-group=www ein, um die korrekten Zugriffsrechte zu setzen.

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. Wir empfehlen die Verwendung des Paketmanagers, wenn möglich.

Sie können herausfinden, welche Module noch zu installieren sind, indem Sie das Skript otrs.checkModules verwenden. Das Skript finden sie im Verzeichnis bin innerhalb des Homeverzeichnisses des Benutzers 'otrs'.

Beachten Sie, dass einige Module optional sind.

Wenn möglich, sollten Sie die fehlenden Module über das Paketsystem Ihrer Linux-Distribution installieren. Dadurch werden die Pakete automatisch aktualisiert, wenn neue Versionen verfügbar sind oder Sicherheitslücken geschlossen wurden. Bitte schauen Sie dazu in die Dokumentation Ihrer Distribution. Wenn ihr Paket nicht (in der korrekten Version) im Paketsystem nicht verfügbar ist, können Sie es über das CPAN installeren, das Comprehensive Perl Archive Network.

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.

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  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.

Konfiguration des Apache-Webservers
In diesem Abschnitt wird beschrieben, wie der Apache-Webserver grundlegend für OTRS eingerichtet werden muss. Der Webserver sollte cgi- bzw. Perl-Skripte ausführen können, andernfalls 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  bzw. zu finden. Wechseln Sie als root in dieses Verzeichnis und kopieren Sie die passende Konfigurationsvorlage in  in die Datei.

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/apache2 restart neu starten.

Das war bereits die grundlegende Konfiguration des Webservers für OTRS.

Zur Verbesserung der Performance können sie mod_cgi deaktivieren und den Apache-Webserver stattdessen für die Benutzung von mod_perl konfigurieren.

Stellen Sie bitte sicher, daß mod_perl installiert und geladen ist. Andernfalls wird der Webserver-Dienst trotzdem starten, in diesem Fall wird jedoch mod_cgi verwendet, wenn es noch aktiviert ist (Deaktivierung wird empfohlen).

Suchen Sie im Verzeichnis /etc/apache* nach mod_perl.so (siehe Skript 3.12 unten) um herauszufinden, ob es bereits geladen wird, oder nicht.

Wenn Sie das o. a. geeignete Startskipt verwenden, und mod_perl geladen wird, kann das Skript /opt/otrs/scripts/apache2-perl-startup.pl verwendet werden, um die Perl-Module bereits beim Start des Webservers einmalig vorzuladen. Damit werden die Antwortzeiten kürzer, was die Performance insgesamt verbessert.

Der einfache Weg - Einrichtung der Datenbank mit Hilfe des Webinstallers (nur für MySQL)
Wenn Sie MySQL als Datenbank-Backend verwenden, können Sie den Web-Installer von OTRS verwenden: http://localhost/otrs/installer.pl.

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

  Lesen Sie die Informationen über die OTRS-Niederlassungen und klicken Sie auf "Weiter".



 Lesen Sie die GNU Affero General Public License und akzeptieren Sie sie durch Klick auf "Akzeptieren".



 Geben Sie Benutzernamen und Passwort für den Administrator an, den DNS-Namen des Servers, auf dem OTRS läuft, und den zu verwendenden Datenbanktyp. Prüfen Sie danach die Einstellungen.

Wenn die Prüfung erfolgreich war, erhalten Sie einen Hinweis. Drücken Sie "Ok" zum Fortfahren.



 Erstellen Sie einen neuen Datenbankbenutzer, wählen Sie einen Namen für die Datenbank und klicken Sie auf "Weiter".

Wenn der Datenbankbenutzer und die Datenbank erfolgreich angelegt wurden, erhalten Sie eine Bestätigung. Klicken Sie auf 'Weiter', um fortzufahren.



 Geben Sie alle benötigten Systemeinstellungen an und klicken Sie "Weiter".



 Wenn Sie wollen, können Sie an dieser Stelle eingehende und ausgehende E-Mail-Verbindungen einrichten, oder diesen Schritt überspringen.



 Starten Sie den OTRS-Dienst neu, damit die neuen Konfigurationseinstellungen verwendet werden.

Herzlichen Glückwunsch! Die Installation ist abgeschlossen, jetzt können Sie mit dem System arbeiten. Um sich anzumelden, verwenden Sie bitte die Adresse http://localhost/otrs/index.pl in ihrem Webbrowser. Melden Sie sich als Administrator and, mit dem Benutzernamen 'root@localhost' und dem Passwort 'root'. Anschließend können Sie das System gemäß Ihrer Anforderungen konfigurieren.

Manuelle Installation der OTRS Datenbank
Wenn Sie den Webinstaller nicht einsetzen können, kann die Datenbank für OTRS auch manuell eingerichtet werden. Skripte mit dem Datenbankschema und den SQL-Statements finden Sie im Verzeichnis scripts/database innerhalb des Homeverzeichnisses des Benutzers 'otrs'.

Für die verschiedenen Datenbanktypen sind mehrere .sql-Dateien vorhanden, die nacheinander abgearbeitet werden müssen.

Die OTRS-Datenbank manuell Schritt für Schritt anlegen
 * 1) Anlegen der Datenbank für OTRS: Legen Sie mit Hilfe Ihres Datenbankinterfaces bzw. Ihrer Datenbankoberfläche die Datenbank an, die später von OTRS verwendet werden soll.
 * 2) Erstellen der Tabellen: Mit Hilfe der otrs-schema.Datenbanktyp.sql-Dateien (z. B. otrs-schema.oracle.sql, otrs-schema.postgresql.sql, usw.) können Sie die Tabellen innerhalb der OTRS Datenbank erzeugen.
 * 3) Einfügen der vom System benötigten Daten: Damit OTRS richtig funktioniert, müssen einige Daten in verschiedene Tabellen geschrieben werden (z. B. die verschiedenen Ticketstatus, Ticket- und Benachrichtigungstypen, etc.). Verwenden Sie entweder die Dateiotrs-initial_insert.mysql.sql, otrs-initial_insert.db2.sql, otrs-initial_insert.oracle.sql, otrs-initial_insert.postgresql.sql oder otrs-initial_insert.mssql.sql zum Einspielen der Daten, je nachdem welche Datenbank verwendet wird.
 * 4) Erzeugen von "foreign keys" auf andere Tabellen: Abschließend müssen noch die "foreign keys" erstellt werden, über die die verschiedenen Tabellen in der OTRS Datenbank voneinander abhängen. Dies kann mit Hilfe der otrs-schema-post.Datenbanktyp.sql-Dateien erreicht werden (z. B. otrs-schema-oracle.post.sql, otrs-schema-post.postgresql.sql, usw.).

Nachdem Sie die Datenbank angelegt haben, sollten Sie die Zugriffsrechte dafür 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 möglich sein dies mit Hilfe Ihres Datenbankinterfaces bzw. Ihrer Datenbankoberfläche zu erledigen.

Wurden die nötigen Einstellungen für die Datenbank vorgenommen, muss nun noch dem Ticket-System mitgeteilt werden, welche Datenbank es verwenden soll. Öffnen Sie die Datei Kernel/Config.pm innerhalb des Homeverzeichnisses des OTRS Benutzers und passen Sie die dafür vorgesehenen Parameter an.

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 cron-Jobs sollten in die crontab des Benutzers 'otrs' eingetragen werden.

Alle Skripte für die verschiedenen cron-Jobs befinden sich im Verzeichnis var/cron innerhalb des Homeverzeichnisses des Benutzers 'otrs'.

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

Die folgende Tabelle gibt eine kurze Übersicht über die Aufgabe der verschiedenen Skripte.

Für die Einrichtung aller cron-Jobs kann das Skript bin/Cron.sh verwendet werden, das sich im Homeverzeichnis des OTRS-Benutzers befindet. Dem 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:

Da die cron-Jobs für den Benutzer 'otrs' 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.

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