Differences

This shows you the differences between two versions of the page.

--- infrastructure:services:zammad [2024-05-24 13:19 UTC] – Created from the form at infrastructure:services:form stb
+++ infrastructure:services:zammad [2024-11-19 09:40 UTC] (current) – [Deleting Users] stb
@@ Line 1: / Line 1: @@
 ====== zammad ======
 ---- dataentry service ----
-service-urls_urls:          https://zammad.hamburg.ccc.de
+service-urls_urls          : https://zammad.hamburg.ccc.de
-other-service-fqdns:        @@Other-Service-FQDNs@@
+other-service-fqdns        :
-host-fqdn:                  zammad-intern
+host-fqdn                  : zammad-intern
-netbox-link_url:            machines/52
+netbox-link_url            : https://netbox.hamburg.ccc.de/virtualization/virtual-machines/52/
-server_page:                infrastructure:servers:chaosknoten
+server_page                : infrastructure:servers:chaosknoten
-maintainers:                stb
+maintainers                : stb
-ccchh-id-integration_yesno: true
+ccchh-id-integration_yesno : true
 ----
 ===== Description =====
-what does this service do?\\
+For Easterhegg or the Junghacker*innentag we offer people to send us email with questions or requests.
-what do I need to know as a user?\\
+[[https://zammad.org|Zammad]] allows us to organize these emails in ticket queues and work on them together.
 ===== Configuration =====
-how is this service configured? (especially: what interesting specific configuration choices were made?)
+Ansible and Docker Compose.
+===== Maintainance =====
+==== Scheduled Tasks ====
+  * **Delete Closed Tickets Not Touched in 12 Months**: will delete all tickets that are closed and have not been touched in a year.
+  * **Delete Customer Accounts Without Any Tickets**: Start a Data Privacy task for all users that are neither admins nor agents (so they only are customers) that don't have any tickets. **N.B.** this will delete all SSO accounts that have not been upgraded to admin or agent. However, those accounts can be re-created simply by logging in again through Keycloak.
+==== Deleting Users ====
+Deleting users from Zammad can be difficult; we had problems removing them through the data privacy cleanup job (see https://zammad.hamburg.ccc.de/#system/data_privacy)
+Instead, you can remove users through the [[https://docs.zammad.org/en/latest/admin/console/dangerzone-for-experts.html|command line]]:
+  # docker exec zammad-docker-compose-zammad-railsserver-1 /docker-entrypoint.sh rails console
+  > user = User.find_by(login: "hans.acker@example.com")
+  => #<User:0x00007fc29284eed0
+   id: 69,
+   organization_id: nil,
+  ...
+  > user.destroy
+  => #<User:0x00007fc29284eed0
+   id: 69,
+   organization_id: nil,
+  ...
+==== Running maintainance tasks manually ====
+Zammad apparently sometimes needs some handholding, which can be accomplished by running a rake task or two. Available tasks:
+  root@zammad:/ansible_docker_compose# docker exec ansible_docker_compose-zammad-railsserver-1 /docker-entrypoint.sh rake --tasks
+Rebuilding the search indices:
+  root@zammad:/ansible_docker_compose# docker exec ansible_docker_compose-zammad-railsserver-1 /docker-entrypoint.sh rake rake zammad:searchindex:rebuild