Inhaltsverzeichnis

Zammad

Verantwortung Malte
Container zammad
W. Ports keine
OS Debian 12.8
Server magrathea
Zustand Produktiv

Hier findet sich die technische Dokumentation des Chaotikum Ticketsystems. Die Nutzungshinweise finden sich hier..

TODO

Der Updater von Postgres behauptet, die aktuelle Version 13 ist obsolet und muss manuell aktualisiert werden:

DONE Die Release Notes von Zammad 6 behaupten, wir brauchen andere Websocket-Weiterleitungs-Dinge im Reverse-Proxy. Brauchen wir das wirklich?

Services

Serviceübersicht Version
Elasticsearch 7.17.25
Zammad 6.4.0-1731532686.9edee425.bullseye

Setup von gruppen

Wir nutzen grundsätzlich Mailinglisten auf denen die für eine zammad Gruppe genutzte mail Adresse ein subscriber ist. So können Die Mails z.B. sowohl vom Dienst als auch von anderen Personen auf der Liste gelesen werden. Das hat verschiedene Vorteile, z.b. kann das später entkoppelt werden o.ä. ohne mail Adressen zu ändern. Zudem kann auf der Mailinglisten Seite für gute Datenschutz übersicht dokumntiert werden, welche Listen dazu führen, dass man Mails an zammad schreibt.

Wer also eine Zammad Gruppe aufsetzt, setzt einen LDAP-Account als Service Account (das sind die kursiven, an denen kann man sich orientieren) auf auf, der die Mail-Adresse erzeugt. Dann über mlmmj eine Mailingliste auf welche dieser account und ggf. weitere kommen.

Das ist leider aktuell glaube ich nicht zu 100% umgesetzt, sollte aber zukünftig immer so gemacht werden.

Spam

Es gibt ein Makro zum schließen von Spam, bitte das nutzen.

Update

Beim Update hängt sich manchmal das Elasticsearch auf, weil nach dem Update das Plugin ingest-attachment nicht mehr dazu passt. Dann muss man das neu installieren:

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

Installation Protocol

# Anleitung Zammad https://docs.zammad.org/en/latest/install/package.html
# Additional software dependencies
apt install curl apt-transport-https gnupg

# Anleitung Elasticsearch https://docs.zammad.org/en/latest/install/elasticsearch.html
apt install apt-transport-https wget curl gnupg
echo "deb [signed-by=/etc/apt/trusted.gpg.d/elasticsearch.gpg] https://artifacts.elastic.co/packages/7.x/apt stable main" | tee -a /etc/apt/sources.list.d/elastic-7.x.list > /dev/null
curl -fsSL https://artifacts.elastic.co/GPG-KEY-elasticsearch | gpg --dearmor | tee /etc/apt/trusted.gpg.d/elasticsearch.gpg> /dev/null
apt update
apt install elasticsearch
/usr/share/elasticsearch/bin/elasticsearch-plugin install ingest-attachment

# RAM für Elasticsearch begrenzen
# WICHTIG! Sonst verwendet das alles an RAM, was es finden kann
echo "-Xms500m" > /etc/elasticsearch/jvm.options.d/heapsize.options
echo "-Xmx500m" >> /etc/elasticsearch/jvm.options.d/heapsize.options

# Service aktivieren und starten
systemctl daemon-reload
systemctl enable elasticsearch.service

# Settings in /etc/elasticsearch/elasticsearch.yml ergänzen:
# # recommended settings from https://docs.zammad.org/en/latest/install/elasticsearch.html
# # Tickets above this size (articles + attachments + metadata)
# # may fail to be properly indexed (Default: 100mb).
# #
# # When Zammad sends tickets to Elasticsearch for indexing,
# # it bundles together all the data on each individual ticket
# # and issues a single HTTP request for it.
# # Payloads exceeding this threshold will be truncated.
# #
# # Performance may suffer if it is set too high.
# http.max_content_length: 400mb
#
# # Allows the engine to generate larger (more complex) search queries.
# # Elasticsearch will raise an error or deprecation notice if this value is too low,
# # but setting it too high can overload system resources (Default: 1024).
# #
# # Available in version 6.6+ only.
# indices.query.bool.max_clause_count: 2000

# Install Zammad
curl -fsSL https://dl.packager.io/srv/zammad/zammad/key | gpg --dearmor | tee /etc/apt/trusted.gpg.d/pkgr-zammad.gpg> /dev/null
echo "deb [signed-by=/etc/apt/trusted.gpg.d/pkgr-zammad.gpg] https://dl.packager.io/srv/deb/zammad/zammad/stable/debian 11 main"| tee /etc/apt/sources.list.d/zammad.list > /dev/null
apt update
apt install zammad

# Set the Elasticsearch server address
$ zammad run rails r "Setting.set('es_url', 'http://localhost:9200')"

# Build the search index
$ zammad run rake zammad:searchindex:rebuild

# make nginx listen for remote connections
# edit /etc/nginx/sites-available/zammad.conf
# remove server_name localhost
# remove listen [::]:80
# remove listen :80
# add listen 192.168.1.59:80

SSO

Single Sign On (SSO) mit Keycloak kann in der Anwendung vom Admin Account konfiguriert werden. Zammad nutzt SAML.

Wartung

In das Textfeld einfach das Datum der Wartung eintragen, am besten in der Form yyyy-mm-dd.

Du besitzt nicht die Benutzerrechte um Seiten hinzuzufügen.
Wartung ZammadWartung Zammad Wann 23.10.2024 21:28 Warum Update System Zammad Ansprechperson Malte wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 09.10.2024 23:15 Warum Update System Zammad Ansprechperson schmitz wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 26.09.2024 12:57 Warum Update System Zammad Ansprechperson schmitz wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 17.09.2024 22:25 Warum Update System Zammad Ansprechperson schmitz wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 12.09.2024 16:50 Warum Update System Zammad Ansprechperson schmitz wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 22.08.2024 12:30 Warum Update System Zammad Ansprechperson schmitz wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 10.08.2024 11:40 Warum Update System Zammad Ansprechperson schmitz wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 07.08.2024 21:44 Warum Update System Zammad Ansprechperson schmitz wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 25.07.2024 10:56 Warum Update System Zammad Ansprechperson schmitz wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 10.07.2024 22:44 Warum Update System Zammad Ansprechperson Malte wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 26.06.2024 22:47 Warum Update System Zammad Ansprechperson schmitz wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 12.06.2024 22:00 Warum Update System Zammad Ansprechperson Malte wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 22.05.2024 20:22 Warum Update System Zammad Ansprechperson schmitz wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 08.05.2024 20:44 Warum Update System Zammad Ansprechperson schmitz wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 24.04.2024 22:34 Warum Update System Zammad Ansprechperson Malte wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 11.04.2024 10:34 Warum Update System Zammad Ansprechperson schmitz wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 28.03.2024 10:42 Warum Update System Zammad Ansprechperson schmitz wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 07.03.2024 01:17 Warum Update System Zammad Ansprechperson Malte wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 21.02.2024 21:31 Warum Update System Zammad Ansprechperson Malte wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 07.02.2024 20:13 Warum Update System Zammad Ansprechperson schmitz wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 25.01.2024 20:07 Warum Update System Zammad Ansprechperson schmitz wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 12.01.2024 01:16 Warum Update System Zammad Ansprechperson schmitz wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 17.12.2023 18:30 Warum Update System Zammad Ansprechperson schmitz wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 06.12.2023 12:06 Warum Update auf 6.2 System Zammad Ansprechperson schmitz wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 30.11.2023 22:15 Warum Update System Zammad Ansprechperson Malte wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 01.11.2023 21:48 Warum Update System Zammad Ansprechperson Malte wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 29.09.2023 00:00 Warum Update System Zammad Ansprechperson Malte wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 31.08.2023 23:10 Warum Update System Zammad Ansprechperson schmitz wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 01.08.2023 23:25 Warum Update System Zammad Ansprechperson Malte wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 05.07.2023 20:45 Warum Update System Zammad Ansprechperson Malte wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 29.06.2023 21:18 Warum Update System Zammad Ansprechperson Malte wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 23.05.2023 22:02 Warum Update System Zammad Ansprechperson Malte wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 11.05.2023 23:27 Warum Update System Zammad Ansprechperson schmitz wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 05.05.2023 17:28 Warum Update System Zammad Ansprechperson Malte wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 04.05.2023 16:18 Warum Update System Zammad Ansprechperson Malte wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 12.04.2023 09:00 Warum Sicherheitsupdate System Zammad Ansprechperson schmitz wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 31.03.2023 10:00 Warum Update System Zammad Ansprechperson Malte wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 15.03.2023 15:30 Warum Sicherheitsupdates System Zammad Ansprechperson Malte wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 03.03.2023 19:15 Warum Update System Zammad Ansprechperson Malte wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 15.02.2023 22:30 Warum Sicherheitsupdate System Zammad Ansprechperson Malte wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 31.01.2023 19:30 Warum Sicherheitsupdate System Zammad Ansprechperson Malte wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 10.01.2023 22:00 Warum Update System Zammad Ansprechperson Malte wartungsfenster zammad done
Wartung ZammadWartung Zammad Wann 02.11.2022 23:00 Warum Update System Zammad Ansprechperson schmitz wartungsfenster zammad done