OTRS Ticketsystem auf Ubuntu 18.04 mit Maria DB Installieren

Aus Agilos Wiki
Zur Navigation springen Zur Suche springen

[category:OTRS] Dieser Artikel beschreibt die Installation des OTRS-Ticketsystems auf Ubuntu 18.04 mit einer Maria DB Datenbank

Benötigte Pakete

Folgende Pakete müssen schon auf dem Server vorhanden sein oder ggf. nachinstalliert werden:

  • MariaDB

Siehe Installation MariaDB

  • Apache web server mit dem Apache Perl Modul
sudo apt-get install  apache2 libapache2-mod-perl2
  • weitere Perl Module:
sudo apt-get install libdatetime-perl libcrypt-eksblowfish-perl libcrypt-ssleay-perl libgd-graph-perl libapache-dbi-perl libsoap-lite-perl 
libarchive-zip-perl libgd-text-perl libnet-dns-perl libpdf-api2-perl libauthen-ntlm-perl libdbd-odbc-perl libjson-xs-perl libyaml-libyaml-perl 
libxml-libxml-perl libencode-hanextra-perl libxml-libxslt-perl libpdf-api2-simple-perl libmail-imapclient-perl libtemplate-perl 
libtext-csv-xs-perl libdbd-pg-perl libapache2-mod-perl2 libtemplate-perl libnet-dns-perl libnet-ldap-perl libio-socket-ssl-perl

Mit folgendem Befehl wird überprüft, ob das Perl-Modul richtig geladen wurde:

$ sudo apachectl -M | grep perl
perl_module (shared)

Sollte das Modul nicht richtig geladen worden sein wird das Modul manuell geladen und der Apache Server neugestartet:

sudo a2enmod perl
sudo systemctl restart apache2

Konfigfile der Datenbank bearbeiten

Zuerst muss die /etc/mysql/mariadb.cnf Datei angepasst werden:

[mysqld]
max_allowed_packet=64M
query_cache_size=36M
innodb_log_file_size=256M
character_set_server=utf8

Erstellung der Datenbank

Zuerst loggen wir und mit folgendem Befehl in MariaDB ein:

$ mysql -u root -p

Dann legen wir eine Datenbank für das Ticketsystem an:

MariaDB [(none)]> CREATE DATABASE otrs CHARACTER SET utf8 COLLATE utf8_general_ci;
Query OK, 1 row affected (0.01 sec)

Und fügen einen Nutzer hinzu, welcher auf diese zugreifen kann:

MariaDB [(none)]> GRANT ALL PRIVILEGES ON otrs.* TO 'otrs_user'@'localhost' \
IDENTIFIED BY 'strongpassword';
Query OK, 0 rows affected (0.00 sec)

MariaDB [(none)]> FLUSH PRIVILEGES;
Query OK, 0 rows affected (0.00 sec)

Mit dem Befehl „quit“ wird der MariaDB Client verlassen.

Systemuser für OTRS erstellen

Für OTRS wird ein Systemnutzer erstellt, welcher keinen Zugang zur Shell erhält. Dieser wird dann der Gruppe "www-data" hinzugefügt:

$ sudo useradd -d /opt/otrs -c 'OTRS user' otrs 
$ usermod -aG www-data otrs

Installation

Sind alle vorbereitungen abgeschlossen kann mit der eigentlichen Installation begonnen werden.

Download des Paketes

Per wget wird das OTRS Paket heruntergeladen und per tar in den Ordner "otrs" entpackt, welcher nach /opt/ verschoben wird:

$ wget http://ftp.otrs.org/pub/otrs/otrs-latest.tar.gz
$ tar xvf otrs-latest.tar.gz
$ mv otrs-6.0.10/ otrs
$ mv otrs /opt

Dann wird überprüft, ob alle Perl Module installiert wurden:

# /opt/otrs/bin/otrs.CheckModules.pl

Einrichtung auf dem System

Konfigfiles Bearbeiten

Wurde alles korrekt installiert werden verschiedene Configfiles bearbeitet.

Config.pm

Aus einer im Paket mitgelieferten Vorlage wird die algemeine Config-File erstellt und im Texteditor geöffnet:

sudo cp /opt/otrs/Kernel/Config.pm.dist /opt/otrs/Kernel/Config.pm
sudo nano /opt/otrs/Kernel/Config.pm

In dieser Configfile werden die Verbindungsdaten zur Datenbank eingetragen(fett gedruckt):

# ---------------------------------------------------- #
# database settings #
# ---------------------------------------------------- #

# The database host
$Self->{DatabaseHost} = '127.0.0.1';

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

# The database user
$Self->{DatabaseUser} = 'otrs_user';

# The password of database user. You also can use bin/otrs.Console.pl Maint::Database::PasswordCrypt
# for crypted passwords
$Self->{DatabasePw} = 'strongpassword';

# The database DSN for MySQL ==> more: "perldoc DBD::mysql"
$Self->{DatabaseDSN} = "DBI:mysql:database=$Self->{Database};host=$Self->{DatabaseHost};";

Das MySQL Perl-Modul auswählen

Das MySQL Perl-Modul wird in der Datei /opt/otrs/scripts/apache2-perl-startup.pl ausgewählt:

# enable this if you use mysql
use DBD::mysql ();
use Kernel::System::DB::mysql;

Für den Ordner, in dem sich diese Dateien befinden wird dann die Berechtigung angepasst:

$ sudo /opt/otrs/bin/otrs.SetPermissions.pl --web-group=www-data
Setting permissions on /opt/otrs

OTRS Apache V-Host einrichten

Zuerst wird ein Symlink zur mitgelieferten Configfile erstellt:

sudo ln -s /opt/otrs/scripts/apache2-httpd.include.conf /etc/apache2/sites-enabled/otrs.conf

Dann überprüfen wir, ob alle benötigten Module funktionieren:

# perl -cw /opt/otrs/bin/cgi-bin/index.pl
/opt/otrs/bin/cgi-bin/index.pl syntax OK

# perl -cw /opt/otrs/bin/cgi-bin/customer.pl
/opt/otrs/bin/cgi-bin/customer.pl syntax OK

# perl -cw /opt/otrs/bin/otrs.Console.pl
/opt/otrs/bin/otrs.Console.pl syntax OK

Ist alles korrekt wird der Apache-Dienst neugestartet:

sudo systemctl restart apache2

Damit auf das Web-Interface zugegriffen werden kann müssen in der Firewall Port 80 geöffnet sein!

Die Installation per Web-Interface starten

Mit der URL http://<ip_einsetzen>/otrs/installer.pl wird das Webinterface zur Installation aufgerufen.

Auf dem Webinterface werden dann die Daten zur Datenbankverbindung eingetragen:


Die E-Mail Einstellungnen kann man auch später durchführen.


Dann erhalten wir auf der "Finnish" Seite den Link zu unserem Ticketsystem sowie den Rootnutzernamen und dessen default Passwort:


Über den Link nach "Start Page" gelangt man zum Admin Dashboard. Wird dieses angezeigt, war die Installation erfolgreich.


Wenn alles funktioniert hat werden die OTRS Dienste und Cronjobs auf dem System gestartet:

sudo su - otrs -c "/opt/otrs/bin/otrs.Daemon.pl start"
sudo su - otrs -c "/opt/otrs/bin/Cron.sh start"

Quellen