HowtoForge

So installierst du das Zammad Ticketing System unter Ubuntu 22.04

von ·

Zammad ist eine kostenlose, quelloffene und webbasierte Support-/Ticketing-Lösung, die für die Verwaltung der Kundenkommunikation verwendet wird. Du kannst sie über verschiedene Kanäle wie E-Mail, Chat, Telefon, Twitter oder Facebook nutzen. Sie ist in den Programmiersprachen JavaScript und Ruby geschrieben. Es unterstützt die REST-API, die dir hilft, andere Programme einfach zu verknüpfen und Echtzeitinformationen über all deine Kanäle und Vorgänge zu erhalten. Zammad bietet sehr nützliche Funktionen, darunter LDAP-Integration, Zeiterfassung, Slack-Integration, SSO, Mehrsprachigkeit und vieles mehr.

In diesem Beitrag zeigen wir dir, wie du das Zammad Ticketing System auf einem Ubuntu 22.04 Server installierst.

Voraussetzungen

  • Ein Server, auf dem Ubuntu 22.04 läuft.
  • Ein Root-Passwort ist auf deinem Server eingerichtet.

Aktualisiere das System

Als erstes musst du alle Systempakete auf die neueste Version aktualisieren und upgraden. Du kannst alle Pakete aktualisieren, indem du den folgenden Befehl ausführst.

apt update -y 
apt upgrade -y

Wenn alle Systempakete auf dem neuesten Stand sind, kannst du mit dem nächsten Schritt fortfahren.

Java JDK installieren

Zuerst musst du Java OpenJDK auf deinem Server installieren. Du kannst es mit dem folgenden Befehl installieren.

apt install openjdk-17-jdk -y

Sobald Java installiert ist, kannst du die Java-Version mit dem folgenden Befehl überprüfen.

java -version

Du solltest die Java-Version in der folgenden Ausgabe sehen.

openjdk version "17.0.5" 2022-10-18
OpenJDK Runtime Environment (build 17.0.5+8-Ubuntu-2ubuntu122.04)
OpenJDK 64-Bit Server VM (build 17.0.5+8-Ubuntu-2ubuntu122.04, mixed mode, sharing)

Sobald Java installiert ist, kannst du mit der Installation von ElasticSearch fortfahren.

ElasticSearch installieren

Zammad nutzt ElasticSearch, um Suchfunktionen bereitzustellen. Daher musst du ElasticSearch auf deinem Server installieren. Standardmäßig ist das ElasticSearch-Paket nicht im Standard-Repository von Ubuntu enthalten. Du musst also das ElasticSearch-Repository zu deinem Server hinzufügen.

Installiere zunächst die erforderlichen Abhängigkeiten mit dem folgenden Befehl.

apt install gnupg2 curl -y

Dann fügst du den ElasticSearch GPG-Schlüssel und das Repository mit folgendem Befehl zur APT hinzu.

curl -fsSL https://artifacts.elastic.co/GPG-KEY-elasticsearch | gpg --dearmor -o /usr/share/keyrings/elastic.gpg
echo "deb [signed-by=/usr/share/keyrings/elastic.gpg] https://artifacts.elastic.co/packages/7.x/apt stable main" | tee -a /etc/apt/sources.list.d/elastic-7.x.list

Aktualisiere den Cache des Repositorys mit dem folgenden Befehl.

apt update -y

Schließlich installierst du das ElasticSearch-Paket mit dem folgenden Befehl.

apt install elasticsearch -y

Sobald ElasticSearch installiert ist, starte und aktiviere den ElasticSearch-Dienst mit dem folgenden Befehl.

systemctl enable elasticsearch.service
systemctl start elasticsearch.service

Nun kannst du ElasticSearch mit folgendem Befehl verifizieren.

curl -X GET 'http://localhost:9200'

Wenn alles in Ordnung ist, erhältst du die folgende Ausgabe.

{
  "name" : "ubuntu2204",
  "cluster_name" : "elasticsearch",
  "cluster_uuid" : "V4bBWciDSSWmI-QcwvJdGA",
  "version" : {
    "number" : "7.17.8",
    "build_flavor" : "default",
    "build_type" : "deb",
    "build_hash" : "120eabe1c8a0cb2ae87cffc109a5b65d213e9df1",
    "build_date" : "2022-12-02T17:33:09.727072865Z",
    "build_snapshot" : false,
    "lucene_version" : "8.11.1",
    "minimum_wire_compatibility_version" : "6.8.0",
    "minimum_index_compatibility_version" : "6.0.0-beta1"
  },
  "tagline" : "You Know, for Search"
}

Du musst auch das ingest-attachment Plugin installieren. Du kannst es mit dem folgenden Befehl installieren.

/usr/share/elasticsearch/bin/elasticsearch-plugin install ingest-attachment

Du erhältst dann die folgende Ausgabe.

-> Installing ingest-attachment
-> Downloading ingest-attachment from elastic
[=================================================] 100%   
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@     WARNING: plugin requires additional permissions     @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
* java.lang.RuntimePermission accessClassInPackage.sun.java2d.cmm.kcms
* java.lang.RuntimePermission accessDeclaredMembers
* java.lang.RuntimePermission getClassLoader
* java.lang.reflect.ReflectPermission suppressAccessChecks
* java.security.SecurityPermission createAccessControlContext
See https://docs.oracle.com/javase/8/docs/technotes/guides/security/permissions.html
for descriptions of what these permissions allow and the associated risks.

Continue with installation? [y/N]y
-> Installed ingest-attachment
-> Please restart Elasticsearch

Starte anschließend den ElasticSearch-Dienst neu, um die Änderungen zu übernehmen.

systemctl restart elasticsearch

Wenn du damit fertig bist, kannst du mit der Installation von Apache und anderen Abhängigkeiten fortfahren.

Installation von Apache und anderen Abhängigkeiten

Installiere zunächst das Apache-Webserverpaket mit dem folgenden Befehl.

apt install apache2 -y

Als nächstes musst du auch libssl auf deinem Server installieren. Füge zunächst das Focal Security Repository mit dem folgenden Befehl hinzu.

echo "deb http://security.ubuntu.com/ubuntu focal-security main" | tee /etc/apt/sources.list.d/focal-security.list

Anschließend aktualisierst du das Repository und installierst das libssl-Paket mit dem folgenden Befehl.

apt update -y
apt install libssl1.1

Wenn du damit fertig bist, kannst du im nächsten Schritt mit der Installation von Zammad fortfahren.

Zammad Ticketing System installieren

Standardmäßig ist das Zammad-Paket nicht im Ubuntu-Repository enthalten. Daher musst du das Zammad-Repository zu deinem Server hinzufügen.

Füge zunächst den Zammad-GPG-Schlüssel mit dem folgenden Befehl hinzu.

curl -fsSL https://dl.packager.io/srv/zammad/zammad/key | gpg --dearmor | tee /etc/apt/trusted.gpg.d/pkgr-zammad.gpg> /dev/null

Dann fügst du das Zammad-Repository mit dem folgenden Befehl zur APT hinzu.

echo "deb [signed-by=/etc/apt/trusted.gpg.d/pkgr-zammad.gpg] https://dl.packager.io/srv/deb/zammad/zammad/stable/ubuntu 22.04 main"| tee /etc/apt/sources.list.d/zammad.list

Aktualisiere den Cache des Repositorys mit dem folgenden Befehl.

apt update -y

Installiere nun das Zammad-Paket mit dem folgenden Befehl.

apt install zammad -y

Sobald Zammad installiert ist, kannst du mit dem nächsten Schritt fortfahren.

Apache für Zammad konfigurieren

Zammad erstellt automatisch eine Apache-Konfigurationsdatei im Apache-Konfigurationsverzeichnis. Du musst jedoch die Zammad-Konfigurationsdatei bearbeiten und sie nach deinen Bedürfnissen anpassen.

nano /etc/apache2/sites-available/zammad.conf

Ändere die folgenden Zeilen.

#ServerTokens Prod
    ServerName your-server-ip
    #RequestHeader unset X-Forwarded-User

Speichere und schließe die Datei und deaktiviere die Standard-Apache-Konfigurationsdatei.

a2dissite 000-default.conf

Starte anschließend den Apache-Dienst neu, um die Änderungen zu übernehmen.

systemctl restart apache2

Du kannst nun den Status des Apache mit dem folgenden Befehl überprüfen.

systemctl status apache2

Du solltest die folgende Ausgabe erhalten.

? apache2.service - The Apache HTTP Server
     Loaded: loaded (/lib/systemd/system/apache2.service; enabled; vendor preset: enabled)
     Active: active (running) since Fri 2022-12-30 02:49:21 UTC; 8s ago
       Docs: https://httpd.apache.org/docs/2.4/
    Process: 13887 ExecStart=/usr/sbin/apachectl start (code=exited, status=0/SUCCESS)
   Main PID: 13891 (apache2)
      Tasks: 55 (limit: 4579)
     Memory: 5.1M
        CPU: 53ms
     CGroup: /system.slice/apache2.service
             ??13891 /usr/sbin/apache2 -k start
             ??13892 /usr/sbin/apache2 -k start
             ??13893 /usr/sbin/apache2 -k start

Dec 30 02:49:21 ubuntu2204 systemd[1]: Starting The Apache HTTP Server...

Wenn du damit fertig bist, kannst du auf die Zammad-Weboberfläche zugreifen.

Zugriff auf das Zammad Ticketing System

Zammad ist nun auf deinem Server installiert und konfiguriert. Du kannst es jetzt über die URL http://your-server-ip aufrufen . Du solltest die folgende Seite sehen.

Klicke auf die Seite Neues System einrichten. Du solltest die Seite mit den Einstellungen für das Administratorkonto sehen.

Gib deinen Namen, deine E-Mail-Adresse und dein Passwort ein und klicke auf die Schaltfläche Erstellen. Du solltest die folgende Seite sehen.

Gib deinen Firmennamen und die URL deiner Website an und klicke auf die Schaltfläche Weiter. Du solltest die Seite E-Mail-Benachrichtigung sehen.

Wähle deinen E-Mail-Anbieter und klicke auf die Schaltfläche Weiter. Du solltest die Seite mit den Kommunikationskanälen sehen.

Klicke auf die Schaltfläche Überspringen. Auf der folgenden Seite solltest du das Zammad-Dashboard sehen.

Fazit

Herzlichen Glückwunsch! Du hast das Zammad Ticketing System erfolgreich auf dem Ubuntu 22.04 Server installiert und konfiguriert. Jetzt kannst du Zammad in deiner Organisation einführen und mit Drittkanälen wie Facebook und Telefon verbinden. Wenn du noch Fragen hast, kannst du dich gerne an mich wenden.

Das könnte dich auch interessieren …