Kapitel 3. Installation des OTRS Framework

Inhaltsverzeichnis

Der einfache Weg - Installation fertiger Pakete
Installation des rpm-Softwarepackets auf einer SUSE Linux Distribution
Installation des rpm-Softwarepackets auf einer Red Hat Enterprise 4 (RHEL4) Distribution
Installation von OTRS auf einer Debian-Distribution
Installation von OTRS unter Microsoft Windows
Manuelle Installation (Linux, Unix)
Vorbereiten der manuellen Installation
Installation der für OTRS benötigten perl-Module
Konfiguration des apache Webservers
Einrichten der Datenbank
Einrichten der von OTRS benötigten cron-Jobs

Zusammenfassung

Dieser Abschnitt beschreibt die Installation und die grundlegende Einrichtung des zentralen OTRS Frameworks. Dabei wird auf die Installation von bereits fertigen Paketen für die Betriebssysteme Linux und Microsoft Windows eingegangen, aber auch die manuelle Installation direkt über die Quellen erklärt, wodurch eine Installation auch auf anderen, hier nicht näher beschriebenen, Betriebssystemen übertragbar sein sollte.

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.

Am Ende dieses Abschnitts sollte ein lauffähiges OTRS auf Ihrem Betriebssystem installiert sein, an dessen Weboberfläche Sie sich bereits als OTRS-Administrator anmelden können.

Der einfache Weg - Installation fertiger Pakete

Der einfachste und komfortableste Weg ein lauffähiges OTRS zu installieren ist sicherlich, auf bereits vorgefertigte Pakete zurück zu greifen. Viele bereits vorgefertigte Installations-Pakete sind im Download-Bereich unter http://www.otrs.org zu finden. Da der Aufwand viel zu groß wäre, die Installation aller dort aufgeführten Pakete in dieser Dokumentation anzuführen, soll im Folgenden nur näher auf die Installation von OTRS unter SUSE Linux, Debian und Microsoft Windows eingegangen werden. Sehen Sie unter der o.g. URL nach, ob auch für Ihr Betriebssystem ein fertiges Installations-Paket vorhanden ist und greifen Sie nur auf die manuelle Installation zurück, wenn Sie keine andere Möglichkeit haben.

Installation des rpm-Softwarepackets auf einer SUSE Linux Distribution

Dieser Abschnitt beinhaltet die Anleitung für 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 http://www.otrs.org nach, ob eine aktuellere Version von OTRS als .rpm-Datei vorliegt. Sollte dies der Fall sein, verwenden Sie bitte diese neuere Version.

Installieren Sie OTRS mittels yast (yast2) oder der Kommandozeile und rpm, je nach Vorliebe. Beachten Sie jedoch, dass OTRS einige perl-Module benötigt, die nicht standardmäßig in einer typischen SUSE-Installation enthalten sind. yast sollte die bessere Wahl sein, da es alle Abhängikeiten automatisch beachtet und auflösen kann.

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

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:~ #

Nach der Installation des rpm's ist es notwendig SuSEconfig zu starten. Geben Sie hierzu Folgendes ein.

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:~ #

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

linux:~ # rcapache restart
Shutting down httpd                                         done
Starting httpd [ PERL ]                                     done
linux:~ #

Der nächste Schritt ist das Aufsetzen der Datenbank. Wenn sie MySQL als Datenbankserver verwenden, können Sie hierzu den Webinstaller von OTRS benutzen. Geben Sie dazu folgende Adresse in Ihrem Browser ein.

http://localhost/otrs/installer.pl

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

Warnung

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

Nachdem alle Einstellungen vorgenommenw urden, kann OTRS nun gestartet werden.

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 <<--
                                                                     done
                                                                     done
linux:~ #

Die Installation von OTRS ist beendet, Sie sollten das System nun verwenden können. Um sich in die Weboberfläche des Trouble Ticket Systems einloggen zu können, geben sie die Adresse http://localhost/otrs/index.pl in Ihrem Browser ein. Melden sie sich als OTRS-Administrator an und konfigurieren Sie das System Ihren Wünschen entsprechend. Als Benutzername verwenden Sie root@localhost, das Passwort lautet root.

Warnung

Bitte ändern Sie auch dieses Passwort schnellstmöglich! Es handelt sich auch hier um ein Standardpasswort!

Installation des rpm-Softwarepackets auf einer Red Hat Enterprise 4 (RHEL4) Distribution

Dieser Abschnitt beinhaltet die Anleitung für die Installation von OTRS auf RHEL4. Als DB-Backend wird MySQL verwendet. Es wird davon ausgegangen, dass sowohl MySQL als auch der Apache-Webserver soweit installiert und eingerichtet sind, dass beide Services automatisch starten und funktionieren.

Damit OTRS problemlos auf RHEL4 funktioniert, schalten Sie bitte zuerst selinux für das System ab. Dazu muss in der Datei /etc/sysconfig/selinux der Konfigurationsparameter "SELINUX" von "enforcing" auf "disabled" gesetzt werden. Starten Sie nach dieser Änderung den Rechner komplett neu, damit selinux auf jeden Fall deaktiviert ist.

Damit OTRS auf RHEL4 funktioniert, müssen die folgenden zusätzlichen Pakete vor dem Einspielen des OTRS-RPMs installiert sein. Falls es neuere Versionen der entsprechenden Pakete gibt, verwenden Sie bitte diese:

  • mysql-4.1.7-4.RHEL4.1.i386.rpm

  • mysql-server-4.1.7-4.RHEL4.1.i386.rpm

  • perl-DBD-MySQL-2.9004-3.1.i386.rpm

  • zlib-devel-1.2.1.2-1.2.i386.rpm

  • libpng-devel-1.2.7-1el4.2.i386.rpm

  • libjpeg-devel-6b-33.i386.rpm

  • freetype-devel-2.1.9-1.i386.rpm

  • fontconfig-devel-2.2.3-7.i386.rpm

  • gd-2.0.33-2_11.el4.at.i386.rpm

  • libgd2-2.0.33-2_11.e14.at.i386.rpm

  • gd-devel-2.0.33-2_11.el4.at.i386.rpm

  • perl-Bit-Vector-6.3-3.i386.rpm

  • perl-Date-Calc-5.3-9.i386.rpm

  • Perl-Date-Lepyear-1.71.-1.2.el4.rf.noarch.rpm

  • perl-Date-ICal-1.72-1.2.el4.rf.noarch.rpm

  • perl-DBI-1.40-5.i386.rpm

  • perl-Digest-HMAC-1.01-13.noarch.rpm

  • perl-Digest-SHA1-2.07-5.i386.rpm

  • perl-Net-DNS-0.48-1.i386.rpm

Weiterhin werden die folgenden perl-Module benötigt. Da RHEL4 diese nicht direkt als RPM beinhaltet, müssen die Module über CPAN händisch nachinstalliert werden:

  • perl-GD

  • perl-GD-Graph3d

  • perl-GDGraph

  • Perl-GDTextUtil

  • PDF::API2

  • Compress::Zlib

Im Abschnitt zur Installation der für OTRS benötigten perl-Module wird die händische Installation von CPAN-Modulen näher beschrieben.

Nun, nachdem alle Vorbereitungen abgeschlossen sind, kann das OTRS-rpm eingespielt werden. Bevor Sie mit der Installation beginnen, sehen Sie bitte unter http://www.otrs.org nach, ob eine aktuellere Version von OTRS als .rpm-Datei vorliegt. Sollte dies der Fall sein, verwenden Sie bitte diese neuere Version. Für RHEL4 können die RPMs verwendet werden, welche für Red Hat Linux 8.0 bereit gestellt werden.

Installieren Sie OTRS nun über die Kommandozeile und rpm. Wurde das aktuelle OTRS-rpm in der Datei /tmp/otrs.rpm gespeichert, geschieht dies mit folgendem Befehl:

linux:~ # rpm -ivh /tmp/otrs.rpm --nodeps
linux:~ #

Um sicher zu gehen, dass für die OTRS-Installation die richtigen Zugriffsrechte gesetzt sind, sollte nun das Skript SetPermissions.sh folgendermaßen aufgerufen werden:

linux:~ # cd /opt/otrs/bin
linux:/opt/otrs/bin # ./SetPermissions.sh /opt/otrs otrs apache apache apache
[...]
linux:/opt/otrs/bin #

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

linux:~ # service httpd restart
linux:~ #

Der nächste Schritt ist das Aufsetzen der Datenbank. Wenn sie MySQL als Datenbankserver verwenden, können Sie hierzu den Webinstaller von OTRS benutzen. Geben Sie dazu folgende Adresse in Ihrem Browser ein.

http://localhost/otrs/installer.pl

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

Warnung

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

Nachdem alle Einstellungen vorgenommen wurden, kann der OTRS-Service nun eingerichtet und anschließend gestartet werden. Der erste Schritt ist die Aktivierung des OTRS-Services:

linux:~ # chkconfig otrs on
linux:~ #

Nun wird überprüft, in welchen Runleveln der Service aktiv ist:

linux:~ # chkconfig --list | grep otrs
otrs            0:off   1:off   2:on    3:on    4:on    5:on    6:off
linux:~ #

Mit folgendem Befehl kann der otrs-Service gestartet werden:

linux:~ # service otrs restart
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 <<--
                                                                     done
                                                                     done
linux:~ #

Die Installation von OTRS ist beendet, Sie sollten das System nun verwenden können. Um sich in die Weboberfläche des Trouble Ticket Systems einloggen zu können, geben sie die Adresse http://localhost/otrs/index.pl in Ihrem Browser ein. Melden sie sich als OTRS-Administrator an und konfigurieren Sie das System Ihren Wünschen entsprechend. Als Benutzername verwenden Sie root@localhost, das Passwort lautet root.

Warnung

Bitte ändern Sie auch dieses Passwort schnellstmöglich! Es handelt sich auch hier um ein Standardpasswort!

Installation von OTRS auf einer Debian-Distribution

Eine ausführliche Beschreibung zur Installation von OTRS auf Debian-Systemen wurde dankenswerter Weise vom Maintainer des OTRS-Pakets, Torsten Werner, bereit gestellt. Sie kann über den Link http://www.writely.com/View.aspx?docid=drm3kmx_0cbr3x9 eingesehen werden.

Installation von OTRS unter Microsoft Windows

Die Installation von OTRS unter Microsoft Windows ist denkbar einfach. Laden Sie den auf http://www.otrs.org bereit gestellten Installer herunter und speichern Sie die Datei. Anschließend führen Sie den Installer einfach aus und folgen den einzelnen Installationsschritten.

Wichtig

Der Windows-Installer für OTRS beinhaltet bereits alle Komponenten, die für den Betrieb von OTRS benötigt werden. D.h., es wird zusätzlich zum eigentlichen OTRS der apache2 Webserver, MySQL, perl mit den für OTRS benötigten Modulen und cron für Windows installiert. Aus diesem Grund ist es empfehlenswert OTRS über den Installer nur auf solchen Windowssystemen zu installieren, auf denen noch kein apache2 bzw. ein anderer Webserver und MySQL läuft.