open source Ticketsystem OFORK Installation

open source Ticketsystem OFORK Installation

Hinweis: Wenn Ihr System SELinux verwendet, sollten Sie es deaktivieren, sonst wird OFORK nicht korrekt funktionieren.

So deaktivieren Sie SELinux für RHEL / CentOS / Fedora:

1. Konfigurieren Sie SELINUX=disabled in der Datei /etc/selinux/config.

# This file controls the state of SELinux on the system.
# SELINUX= can take one of these three values:
#       enforcing - SELinux security policy is enforced.
#       permissive - SELinux prints warnings instead of enforcing.
#       disabled - No SELinux policy is loaded.
SELINUX=disabled
# SELINUXTYPE= can take one of these two values:
#       targeted - Targeted processes are protected,
#       mls - Multi Level Security protection.
SELINUXTYPE=targeted

2. Starten Sie Ihr System neu. Bestätigen Sie nach dem Neustart, dass der Befehl getenforce den Wert Disabled zurückgibt.

shell> getenforce
Disabled

Schritt 1: Installieren Sie OFORK mit ofork-12.0.3.tar.gz

Laden Sie zunächst das Quellarchiv als .tar.gz herunter: OFORK 12 Patch Level 3 tar.gz

Entpacken Sie das Archiv, zum Beispiel mit tar, in das Verzeichnis /opt und benennen Sie das Verzeichnis von ofork-12.0.3 in ofork um.

shell> cd /opt
shell> wget https://ftp.o-fork.de/ofork-12.0.3.tar.gz
shell> tar xzf ofork-12.0.3.tar.gz
shell> mv ofork-12.0.3 ofork

Schritt 2: Installieren Sie zusätzliche Perl-Module

Verwenden Sie das folgende Skript, um einen Überblick über alle installierten und erforderlichen CPAN-Module zu erhalten.

shell> perl /opt/ofork/bin/ofork.CheckModules.pl
o CGI..............................ok (v3.60)
o Crypt::PasswdMD5.................ok (v1.3)
o Crypt::SSLeay....................Not installed! (Optional - Required for Generic Interface SOAP SSL connections.)
o CSS::Minifier....................ok (v0.01)
o Date::Format.....................ok (v2.22)
o Date::Pcalc......................ok (v1.2)

Hinweis: Bitte beachten Sie, dass OFORK eine funktionierende Perl-Installation mit allen Kern-Modulen benötigt. Diese Module werden nicht explizit vom Skript überprüft. Möglicherweise müssen Sie auf einigen Systemen wie RHEL ein Perl-Core-Paket installieren. Die Perl-Kernpakete werden nicht standardmäßig installiert.

Um fehlende Perl-Module zu installieren, haben Sie folgende Möglichkeiten.

a) Installation über den Paketmanager Ihrer Linux-Distribution

Für Red Hat, CentOS, Fedora oder kompatible Systeme:

shell> yum install "perl(Digest::MD5)"

Für SUSE Linux Enterprise Server, openSUSE oder kompatible Systeme:

Bestimmen Sie zunächst den Namen des Pakets, in dem das Modul geliefert wird. Normalerweise würde das Paket für My::Module den Namen perl-My-Module haben.

shell> zypper search Digest::MD5

Dann installieren:

shell> zypper install perl-Digest-MD5

Für Debian, Ubuntu oder kompatible Systeme:

Bestimmen Sie zunächst den Namen des Pakets, in dem das Modul geliefert wird. Normalerweise würde das Paket für My::Module den Namen libmy-modul-perl haben.

shell> apt-cache search Digest::MD5

Dann installieren:

shell> apt-get install libdigest-md5-perl

Beachten Sie, dass Sie möglicherweise nicht alle Module oder die erforderlichen Versionen in Ihrem Distributions-Repository finden können. In diesem Fall können Sie diese Module über CPAN installieren.

b) Installation der benötigten Module über die CPAN-Shell

Beachten Sie, dass Sie unter Linux CPAN als root ausführen sollten, da auf die Module sowohl von OFORK als auch vom Webserver zugegriffen wird.

shell> perl -MCPAN -e shell;
...
install Digest::MD5
install Crypt::PasswdMD5
...

Hinweis: Es kann vorkommen, dass folgende Perl-Module zusätzlich installiert werden müssen.

cpan install Moo
cpan install Types::Standard

Oder:

sudo apt-get install -y libtypes-path-tiny-perl
sudo apt-get install -y libmoo-perl

Schritt 3: Erstellen Sie den OFORK-Benutzer

Benutzer erstellen:

shell> useradd -d /opt/ofork -c 'OFORK user' ofork

Benutzer zur Webserver-Gruppe hinzufügen, wenn der Webserver nicht als OFORK-Benutzer ausgeführt wird:

shell> usermod -G www ofork

Gruppen je nach Distribution:

Distribution	Webserver-Gruppe
SUSE	www
Red Hat / CentOS / Fedora	apache
Debian / Ubuntu	www-data

Schritt 4: Überprüfen Sie, ob alle benötigten Module installiert sind

shell> perl -cw /opt/ofork/bin/cgi-bin/index.pl
/opt/ofork/bin/cgi-bin/index.pl syntax OK

shell> perl -cw /opt/ofork/bin/cgi-bin/customer.pl
/opt/ofork/bin/cgi-bin/customer.pl syntax OK

shell> perl -cw /opt/ofork/bin/ofork.Console.pl
/opt/ofork/bin/ofork.Console.pl syntax OK

Schritt 5: Konfigurieren des Apache-Webservers

Zunächst sollten Sie den Apache2-Webserver und mod_perl installieren. Das erledigen Sie normalerweise über den Paketmanager Ihres Systems.

# RHEL / CentOS:
shell> yum install httpd mod_perl

# SuSE:
shell> zypper install apache2-mod_perl

# Debian/Ubuntu:
shell> apt-get install apache2 libapache2-mod-perl2

Die meisten Apache-Installationen haben ein conf.d-Verzeichnis. Auf Linux-Systemen finden Sie dieses Verzeichnis normalerweise unter /etc/apache oder /etc/apache2.

Melden Sie sich als root an, wechseln Sie in das entsprechende Konfigurationsverzeichnis und verknüpfen Sie die Vorlage /opt/ofork/scripts/apache2-httpd.include.conf in eine Datei namens zzz_ofork.conf im Apache-Konfigurationsverzeichnis. Dadurch wird sichergestellt, dass sie nach den anderen Konfigurationen geladen wird.

Für Debian/Ubuntu:

shell> ln -s /opt/ofork/scripts/apache2-httpd.include.conf /etc/apache2/sites-enabled/zzz_ofork.conf

OFORK erfordert, dass einige Apache-Module für einen optimalen Betrieb aktiv sind. Auf den meisten Plattformen können Sie mit a2enmod sicherstellen, dass sie aktiviert sind.

shell> a2enmod perl
shell> a2enmod version
shell> a2enmod deflate
shell> a2enmod filter
shell> a2enmod headers

Jetzt können Sie Ihren Webserver neu starten, um die neuen Konfigurationseinstellungen zu laden.

shell> systemctl restart apache2.service

Schritt 6: Dateiberechtigungen

Bitte führen Sie den folgenden Befehl als root-Benutzer aus, um die Datei- und Verzeichnisberechtigungen für OFORK festzulegen. Es wird versucht, die richtigen Benutzer- und Gruppeneinstellungen zu finden, die für Ihr Setup erforderlich sind.

shell> cd /opt/ofork/
shell> bin/ofork.SetPermissions.pl

Schritt 7: Datenbankeinrichtung und grundlegende Systemkonfiguration

Verwenden Sie das Web-Installationsprogramm unter http://localhost/ofork/installer.pl. Ersetzen Sie localhost durch Ihren OFORK-Hostnamen. Damit richten Sie Ihre Datenbank und grundlegende Systemeinstellungen wie E-Mail-Konten ein.

Hinweis: Die folgenden Konfigurationseinstellungen werden für MySQL-Setups empfohlen. Bitte fügen Sie die folgenden Zeilen zu /etc/my.cnf im Abschnitt [mysqld] hinzu.

max_allowed_packet   = 64M
query_cache_size     = 32M
innodb_log_file_size = 256M

Hinweis: Bitte beachten Sie, dass OFORK utf8 als Datenbankspeichercodierung benötigt.

Schritt 8: Erste Anmeldung

Jetzt können Sie sich bei Ihrem System anmelden:

http://localhost/ofork/index.pl

Verwenden Sie die Zugangsdaten, die Sie im Web-Installer konfiguriert haben. Der Benutzer lautet root@localhost.

Mit diesem Schritt ist die grundlegende Systemeinrichtung abgeschlossen.

Schritt 9: Starten Sie den OFORK-Daemon

Der OFORK-Daemon ist verantwortlich für die Behandlung von asynchronen und wiederkehrenden Aufgaben in OFORK. Der Daemon behandelt auch alle GenericAgent-Jobs und muss vom ofork-Benutzer gestartet werden.

shell> /opt/ofork/bin/ofork.Daemon.pl start

Schritt 10: Cron-Jobs für den OFORK-Benutzer

Es gibt zwei Standard-OFORK-Cron-Dateien in /opt/ofork/var/cron/*.dist, deren Zweck es ist, sicherzustellen, dass der OFORK-Daemon läuft. Sie müssen aktiviert werden, indem Sie sie ohne die Dateinamenerweiterung .dist kopieren.

shell> cd /opt/ofork/var/cron
shell> for foo in *.dist; do cp $foo `basename $foo .dist`; done

Um diese Cron-Jobs auf Ihrem System zu aktivieren, können Sie das Script Cron.sh mit dem ofork-Benutzer verwenden.

shell> /opt/ofork/bin/Cron.sh start

Das Stoppen der Cron-Jobs ist ebenfalls möglich und für Wartungsarbeiten nützlich.

shell> /opt/ofork/bin/Cron.sh stop

Hinweis: Wenn Sie Probleme mit der Installation haben, können Sie eine Nachricht an support@o-fork.de senden. Unsere professionellen Services unterstützen Sie gerne, OFORK schneller zu implementieren und OFORK optimal zu nutzen.