OTRS 2.4 - Manuelle Installation unter Windows mit Active Perl

Posted Thu, 24/09/2009 - 08:46 by andreas

OTRS-Version:

OTRS Version 2.x

Installation des Apache WebServers

Als erstes die aktuelle Version des Apache Webservers herunterladen unter: http://httpd.apache.org/download.cgi . Für die Installation ist die Windows-Installer Version inkl. OpenSSL erforderlich.
Dann das Setup aufrufen und zunächst die allgemeinen Serverinformationen ausfüllen (Network Domain, Server Name usw).
Einmal "Next" anklicken und bei "Setup-Type" den Punkt "Custom" auswählen.
Über die Schaltfläche "Change" den Installationspfad auf c:\otrs\apache ändern und die Installation dann abschließen

Konfiguration des Apache WebServers

Unter http://cpan.uwinnipeg.ca/PPMPackages/10xx/x86/mod_perl.so die Datei mod_perl.so herunterladen und in das Verzeichnis c:\otrs\apache\modules\ kopieren.
Die Apache Konfigurationsdatei öffnen unter: C:\otrs\apache\conf\httpd.conf
Den folgenden Code am Ende der Datei hinzufügen:

# ---
# OTRS configuration
# ---

# load mod_perl
LoadFile 'c:/otrs/perl/bin/perl510.dll'
LoadModule perl_module modules/mod_perl.so

# include the OTRS configuration
Include 'c:/otrs/otrs/scripts/apache2-httpd-new.include.conf'

Installation des Mysql Datenbankservers

Als erstes die aktuelle Version des Mysql-Community-Servers herunterladen unter: http://dev.mysql.com/downloads/ . Für die Installation die Windows-Installer Variante auswählen.
Dann das Setup aufrufen und als "Setup-Type" den Punkt "Custom" auswählen.
Über die Schaltfläche "Change" den Installationspfad auf c:\otrs\mysql ändern, dann "Next" und anschließend "Install" anklicken.
Zum Abschluß der Installation "Configure the MySQL Server now" auswählen und "Finish" anklicken.
Den Punkt "Detailed Configuration" ausgewählt lassen und "Next" anklicken
Bei der Konfiguration den Punkt "Server Machine" auswählen und "Next" anklicken.
Bei "Database usage" den Punkt "Non-Transactional Database Only" auswählen und "Next" anklicken.
Im nächsten Fenster kann die Anzahl der gleichzeitig erforderlichen Datenbankverbindungen eingestellt werden. Diese hängt von der Anzahl der Benutzer ab, die später OTRS nutzen werden.
Nach dem Wechsel mit "Next" folgt der Bildschirm zur Konfiguration der Netzwerk Optionen. Hier einfach die Standardeinstellung belassen und mit "Next" zum nächsten Bild springen.
Bei "Default character set" den Punkt "Best Support for Multilingualism" auswählen und mit "Next" bestätigen.
Bei "Windows Options" einen Haken setzen bei "Install As Windows Service" und bei "Include Bin Directory in Windows Path". Anschließend wieder "Next" anklicken.
Auf dem nächsten Bildschirm kann das Root-Passwort vergeben werden. Verwenden Sie ein langes, komplexes Kennwort (Buchstaben, Zahlen, Sonderzeichen)
Zum Abschluß noch einmal auf "Next", dann auf "Exceute" klicken, um die Konfiguration einzustellen und zum Abschluß auf "Finish" klicken.
Nach Abschluß der Installation müssen noch 2 Einträge in die Konfigurationsdatei des MySQL-Servers aufgenommen werden. Hierzu die folgende Datei mit einem Texteditor öffnen: C:\otrs\mysql\my.ini und folgende Zeilen an das Ende der Datei hinzufügen. Nach dem Speichern den MySQL Dienst unter Start / Einstellungen / Systemsteuerung / Verwaltung / Dienste noch einmal stoppen und starten.
max_allowed_packet = 10M
query_cache_size = 20M

OTRS Installation

Die OTRS Installation "OTRS 2.4.8 zip (win32 platform)" herunterladen unter: http://www.otrs.org/download
Die Zip-Datei so entpacken, dass sich OTRS anschließend in folgendem Pfad befindet c:\otrs\otrs

Perl-Installation

In diesem Beispiel wird die Perl-Distribution "ActivePerl 5.10" verwendet. Diese herunterladen unter: http://www.activestate.com/activeperl/
Bitte keine neuere Version als Perl 5.10 verwenden, da einige Perl Module noch nicht für die neue Perl Version zur Verfügung stehen!
Bei der Installation den Pfad c:\otrs\perl auswählen und ansonsten die Installation einfach durchklicken.

Perl-Module installieren

Zur Installation der Perl-Module kann der Perl Paket Manager genutzt werden.

Perl Package Manager starten über: Windows-Startbutton / dann "Ausführen" anklicken / ppm in das Feld "Öffnen:" eintragen und mit "OK" bestätigen
Im Packeage Manager dann den Punkt "Edit" / "Prefereces" anklicken (siehe Screenshot)

Im Perl Package Manager auf die Registerkarte "Repositories" klicken und folgende Repositories hinzufügen:
- http://cpan.uwinnipeg.ca/PPMPackages/10xx/package.xml
- http://trouchelle.com/ppm10/package.xml
Nach dem Klicken auf "Add" nimmt das Hinzufügen einen Moment Zeit in Anspruch. Danach einfach mit "OK" bestätigen.

Anschließend im Package Manager die Ansicht umstellen. Dazu das Menü "View" anklicken und den Punkt "All Packages" anklicken auswählen.
Die Installation der Module funktioniert folgendermaßen. In das Textfeld (siehe Screenshot) den Namen des Moduls eingeben und im Ergebnisfenster erscheinen die Module. Das Modul, dass installiert werden soll mit der rechten Maustaste anklicken und "Install" auswählen. Die Installation kann dann über das Menü "File" und "Run marked actions" gestartet werden.
Folgende Module müssen über diesen Weg installiert werden:
- TimeDate
- Date-Pcalc
- Encode-HanExtra
- MIME-Tools
- Compress-Zlib
- DBD-mysql
- Net-DNS
- SOAP-Lite
- PDF-API2
- Net-SSLeay
- Net-IMAP-Simple-SSL
- perl-ldap
- NET-SMTP-SSL
- mod_perl (eingeben und hinunterscrollen in der Trefferliste, um das Modul zu finden)
- Authen-SASL
- Apache-DBI
Nach Abschluß der Installation der Module kann mit Hilfe eines Scripts geprüft werden, ob alle Module korrekt installiert sind. Hierzu die Datei c:\otrs\otrs\bin\otrs.checkmodules kopieren und die kopierte Datei umbenennen in otrs.checkmodules.pl
Anschließend die Kommandozeile öffnen und folgendes eingeben: c:\otrs\otrs\bin\otrs.checkmodules.pl
Das Script zeigt im Ergebnisbericht an, ob alle Module korrekt installiert sind.
Zum Abschluß müssen noch 2 Dateien manuell ergänzt werden. Hierzu das Modul Apache-Reload unter der folgenden Adresse herunterladen: http://search.cpan.org/~phred/Apache-Reload-0.10/
Die Datei entpacken und die Datei lib\Apache\Reload.pm kopieren nach C:\otrs\perl\site\lib\Apache und lib\Apache2\Reload.pm kopieren nach C:\otrs\perl\site\lib\Apache2

Konfiguration von OTRS

Config.pm anpassen

Die Datei C:\otrs\otrs\Kernel\config.pm.dist umbenennen in config.pm
Die Datei config.pm mit einem Texteditor öffnen.
Die Zeile $Self->{Home} = '/opt/otrs'; suchen und den mit der folgenden Zeile ersetzen:

$Self->{Home} = 'c:/otrs/otrs';

Unterhalb dieser Zeile die folgenden Zeile einfügen und die Datei speichern.

$Self->{LogModule} = 'Kernel::System::Log::File';

$Self->{'LogModule::LogFile'} = 'C:/OTRS/OTRS/var/log/otrs.log';

Apache2-httpd-new.include anpassen

Die folgende Datei im Texteditor öffnen: C:\otrs\otrs\scripts\apache2-httpd-new.include
Die folgenden Zeilen durch Eingabe des Zeichens # auskommentieren:
vorher:
PerlModule Apache2::Reload
PerlInitHandler Apache2::Reload

nachher:
#PerlModule Apache2::Reload
#PerlInitHandler Apache2::Reload
Die folgenden Zeilen suchen und ersetzen:
vorher: ScriptAlias /otrs/ "/opt/otrs/bin/cgi-bin/"
nachher: ScriptAlias /otrs/ "c:/otrs/otrs/bin/cgi-bin/"

vorher: Alias /otrs-web/ "/opt/otrs/var/httpd/htdocs/"
nachher: Alias /otrs-web/ "c:/otrs/otrs/var/httpd/htdocs/"

vorher: Perlrequire /opt/otrs/scripts/apache2-perl-startup.pl
nachher: Perlrequire c:/otrs/otrs/scripts/apache2-perl-startup.pl

vorher: <Directory "/opt/otrs/bin/cgi-bin/">
nachher: <Directory "c:/otrs/otrs/bin/cgi-bin/">

vorher: <Directory "/opt/otrs/var/httpd/htdocs/">
nachher: <Directory "c:/otrs/otrs/var/httpd/htdocs/">

apache2-perl-startup.pl anpassen

Die folgende Datei im Texteditor öffnen: C:\otrs\otrs\scripts\apache2-per-startup.pl
Die folgenden beiden Zeilen ersetzen und die Datei speichern:
vorher:
use lib "/opt/otrs/";
use lib "/opt/otrs/Kernel/cpan-lib";

nachher:
use lib "c:/otrs/otrs/";
use lib "c:/otrs/otrs/Kernel/cpan-lib";
Anschließend nach den folgenden zwei Zeilein suchen:
#use Apache::DBI ();
#Apache::DBI->connect_on_init('DBI:mysql:otrs', 'otrs', 'some-pass');

Bei diesen Zeilen die führenden # Zeichen entfernen, damit die Zeilen aktiviert werden. Anschließend bei "some-pass" das Paswort eintragen, dass Sie dem Datenbankbenutzer namens OTRS im späteren Verlauf der Installation noch geben werden (möglichst komplettes Passwort).

Der erste Start von OTRS

Den Apache Webserver über die Dienste zunächst einmal stoppen und neu starten.
Auf dem OTRS Server den OTRS-Installer aufrufen über: http://localhost/otrs/installer.pl
Hier zunächst die Lizenzbedingungen akzeptieren und auf der Seite bezüglich der Datenbankeinstellungen (siehe Screenshot) ebenfalls durch Anklicken der Schaltfläche "Weiter" bestätigen. An dieser Stelle das Admin-Passwort für die Datenbank, dass bereits bei der MySQL Server Installaton gesetzt wurde, eintragen. Auch dem "Datenbankbenutzer (Neu)" sollte an dieser Stelle ein komplexes Passwort vergeben werden.
Auch auf der nächsten Bildschirmseite "Datenbank erstellen (2/4)" einfach "Weiter" anklicken.
Auf der folgenden Seite den System FQDN, die Admin E-Mail und ggf. den Organisationsnamen eingeben (siehe Screenshot).
Die Installation durch Anklicken der Schaltfläche "Weiter" abschließen.
Danach die folgende Datei im Texteditor öffnen: C:\otrs\otrs\scripts\apache2-httpd-new.include und die# Zeichen vor den folgenden beiden Zeilen wieder entfernen:
PerlModule Apache2::Reload
PerlInitHandler Apache2::Reload
Anschließend den Apache-Weberserver stoppen und neu starten. Fertig. Jetzt steht OTRS zur Verfügung:
URL zur Startseite: http://localhost/otrs/index.pl
Benutzer: root@localhost
Passwort: root

Einrichtung von Jobs im Zeitplaner

Für den Betrieb von OTRS müssen noch Jobs eingerichtet werden, die über einen Zeitplaner gesteuert aufgerufen werden. Der E-Mail Import ist z.B. ein Job, der regelmäßig z.B. alle 10 Min. die neuen E-Mails in OTRS importieren soll. Im folgenden wird kurz beschrieben wie Jobs angelegt werden. Eine Übersicht der notwendigen Jobs und deren Befehlszeilen für diese Installation ist am Ende des Absatzes zu finden.
Bei dieser Installation wird der in Windows integrierte Zeitplaner verwendet. Dieser kann aufgrufen werden über: Start / Einstellungen / Systemsteuerung / geplante Tasks
Nach dem Aufruf von "geplante Tasks" kann anschließend über "Geplanten Task hinzufügen" ein neuer Job hinzugefügt werden.
Bei Anwendung "Command Prompt" auswählen und "Weiter" anklicken (siehe Screenshot)
Anschließend einen Namen für den Job vergeben z.B. DeleteExpiredSessions
Anschließend eine Startzeit festlegen und "Weiter" anklicken
Dann einen Benutzer, der lokale Administratorrechte auf dem Server hat, eintragen (siehe Screenshot) und mit "Weiter" bestätigen.
Anschließend einen Haken setzen bei "Erweiterte Eigenschaften..." (siehe Screenshot) und "Fertigstellen" anklicken.
In das Feld "Ausführen" die gewünschte Befehlszeile (siehe Befehlszeilen der einzelnen Jobs unterhalb dieses Artikels) eingeben
Über die Registerkarte "Zeitplan" kann mit Klick auf die Schaltfläche "Erweitert" ein erweiterter Zeitplan und ein Wiederholungsrhythmus für den Job festgelegt werden (siehe Screenshot)