Installationsanleitung für Znuny 7 unter Debian/Ubuntu

Die Installation von Znuny 7 unterscheidet sich in Details von der Installation älterer Znuny Versionen. Diese Anleitung berücksichtigt die Unterschiede. Wenn Sie eine ältere Znuny Version installieren möchten, finden Sie alle nötigen Informationen in unser Installationsanleitung für Znuny 6.x für Debian/Ubuntu.

Hinweis: Die Befehle in den grauen Befehlsboxen werden mit einem Klick in die Box markiert und kopiert.

Schritt 1: Das System vorbereiten

Wechseln Sie zum root user, wenn Sie nicht als root eingelogged sind:

su -

Bringen Sie das System auf den neusten Stand:

apt update -y apt upgrade -y

Schritt 2: Linux Pakete installieren

Installieren Sie den Apache-Server:

apt install -y apache2

Installieren Sie den MariaDB-Client und den MySQL Server MariaDB mit:

apt install -y mariadb-client mariadb-server

Installieren Sie cpanminus:

apt install -y cpanminus

Zur einfacheren Verwaltung der Firewall-Regeln (UFW – Uncomplicated Firewall):

apt install -y ufw

Schritt 3: Datenbank Konfiguration

Erstellen Sie eine Datenbank-Konfigurationsdatei:

nano /etc/mysql/mariadb.conf.d/50-znuny.cnf

Fügen Sie die folgenden Zeilen hinzu:

[mysqld] character-set-server = utf8 collation-server = utf8_general_ci max_allowed_packet = 256M innodb_log_file_size = 256M innodb_file_per_table [client] max_allowed_packet = 256M

Mit der Tastenkombination Strg+O speichern Sie die Datei. Anschließend können Sie den Editor mit Strg+X beenden.

Starten Sie die Einrichtung von MariaDB und folgen Sie den Anweisungen

mysql_secure_installation

Die Anmeldung als DB-User root ist seit MariaDB v10.4.3 nur noch in der Shell und als Superuser möglich. Aus diesem Grund müssen Sie die Znuny-Datenbank per Hand erstellen.

mysql -p -u root

Erstellen Sie die Znuny-Datenbank:

CREATE DATABASE znunydb CHARACTER SET utf8;

Setzen Sie den Besitzer und das Passwort für die erstellte Datenbank. Das Passwort im unten genannten Befehl müssen Sie an Ihr gewünschtes Passwort anpassen.

GRANT ALL PRIVILEGES ON znunydb.* TO znuny@localhost IDENTIFIED BY "PASSWORD" WITH GRANT OPTION;

Übernehmen Sie die Konfigurationen:

FLUSH PRIVILEGES;

Verlassen Sie die MySQL-Shell:

exit;

Schritt 4: Znuny vorbereiten

Laden Sie die neuste Znuny-Version herunter.

wget https://download.znuny.org/releases/znuny-latest.tar.gz

Entpacken Sie das heruntergeladene Archiv nach /opt/.

tar xzf znuny-latest.tar.gz -C /opt/

Legen Sie einen symbolischen Link zu /opt/znuny an. Durch die Verwendung eines symbolischen Links wird es in Zukunft einfacher, Updates durchzuführen oder von diesen wieder auf eine frühere Version zurückzugreifen. Passen Sie hier die Versionsnummer im Verzeichnisnamen der Version an, die Sie heruntergeladen haben.

ln -s /opt/znuny-7.0.3 /opt/znuny

Aktivieren Sie die Config-Datei, indem Sie eine Kopie ohne die Endung .dist erstellen:

cp /opt/znuny/Kernel/Config.pm.dist /opt/znuny/Kernel/Config.pm

Schritt 5: Pakete und Module installieren

Installieren Sie die Pakete, die für den Betrieb benötigt werden.

apt install -y libarchive-zip-perl libauthen-sasl-perl libdatetime-perl libnet-dns-perl libtemplate-perl libxml-libxml-perl libyaml-libyaml-perl libcrypt-eksblowfish-perl libhash-merge-perl libapache2-mod-perl2 libdata-uuid-perl libdbd-mysql-perl libmail-imapclient-perl libical-parser-perl

Ob alle benötigten Pakete installiert sind, können Sie mit dem folgenden Befehl überprüfen:

perl /opt/znuny/bin/znuny.CheckModules.pl

Prüfen Sie die Liste der benötigten und optionalen Module, die Sie einrichten möchten. Um sie mit apt zu installieren, können Sie den jeweils angegebenen Befehl hinter dem Modul verwenden.Installieren Sie nun jedes erforderliche und optionale Modul das Sie benötigen.

Hier ein Beispiel:

apt install -y libnet-dns-perl

Schritt 6: Znuny User und Rechtevergabe

Legen Sie den Znuny-User an

useradd -M -N -d /opt/znuny -c "Znuny user" znuny

Fügen sie den Znuny-User zur Apache-Gruppe hinzu

usermod -G www-data znuny

Dieser Befehl setzt die Zugriffsrechte auf Znuny-Dateien und -Verzeichnisse:

perl /opt/znuny/bin/znuny.SetPermissions.pl

Schritt 7: Webserver Konfiguration

Legen Sie einen SymLink von der Apache-Konfigurationsdatei im zugehörigen Apache-Ordner an und benennen Sie diese in „zzz_znuny.conf“ um, um sicherzustellen, dass die Datei nach allen anderen Konfigurationsdateien geladen wird.

ln -s /opt/znuny/scripts/apache2-httpd.include.conf /etc/apache2/conf-available/zzz_znuny.conf

Aktivieren Sie die benötigten Apache-Module:

a2dismod mpm_event a2enmod perl headers deflate filter cgi a2enmod mpm_prefork a2enconf zzz_znuny

Damit die Konfigurationen übernommen werden, laden Sie Apache neu:

systemctl reload apache2 systemctl restart apache2

Schritt 8: System vorbereiten

Öffnen Sie die Firewall für http und https Zugriffe:

ufw allow http ufw allow https

Setzen Sie Apache in den Autostart:

systemctl enable apache2

Starten Sie den Apache-Server neu:

systemctl restart apache2

MariaDB-Server in den Autostart setzen:

systemctl enable mariadb

Führen Sie einen Neustart für MariaDB durch:

systemctl restart mariadb

Bevor Sie die Installation abschließen können Sie mit folgenden Befehlen überprüfen, ob alle erforderlichen Module korrekt installiert wurden:

perl -cw /opt/znuny/bin/cgi-bin/index.pl perl -cw /opt/znuny/bin/cgi-bin/customer.pl perl -cw /opt/znuny/bin/cgi-bin/installer.pl

Schritt 9: Installation abschließen

Öffnen Sie das Installations-Skript im Browser, um die abschließenden Konfigurationen durchzuführen. Tauschen Sie dabei „localhost“ durch Ihren eigenen Hostnamen oder Ihre IP-Adresse aus.

http://localhost/znuny/installer.pl

Befolgen Sie die Anweisungen auf der Webseite. Verwenden Sie zur Herstellung einer Verbindung mit der Datenbank den Benutzernamen „znuny“ und das von Ihnen bei der Datenbankerstellung gewählte Passwort. Wählen Sie die vorhandene Datenbank „znunydb“ aus.

Schritt 10: Daemon einrichten

Dieser Befehl startet den Daemon als Znuny-User

su -c "/opt/znuny/bin/znuny.Daemon.pl start" -s /bin/bash znuny

Es gibt zwei Cron-Dateien, die umbenannt werden müssen:

cp /opt/znuny/var/cron/aaa_base.dist /opt/znuny/var/cron/aaa_base cp /opt/znuny/var/cron/znuny_daemon.dist /opt/znuny/var/cron/znuny_daemon

um sie in die crontab des Znuny-Users einzutragen:

su -c "/opt/znuny/bin/Cron.sh start" -s /bin/bash znuny