Migrate Zammad to new host

Dies ist nur eine Beschreibung der grundlegenden Schritte zur Durchführung einer Migration auf einen neuen Host. Ihre Umgebung kann anders sein, daher sollten Sie dies nur als Anhaltspunkt betrachten. Wenn etwas schief geht, wenden Sie sich bitte an die Zammad Community oder ziehen Sie bezahlte Support-Optionen in Betracht.

Die auf dieser Seite beschriebenen Schritte sind eine Ergänzung zur Anleitung zur Sicherung und Wiederherstellung. Sie sind nicht dazu gedacht, für sich allein zu stehen - wir verlinken und vermerken dies an den entsprechenden Stellen.

TIP

Migration von Zammad SaaS? Springen Sie zu Schritt 7. Zur Wiederherstellung haben Sie einen Anhangs-Dump erhalten!

Step 1: Note down your environmental adjustments

Falls Sie Umgebungsvariablen oder ähnliches gesetzt haben, sollten Sie diese nun sichern.

Step 2: Install Zammad on the destination host

Um die Wiederherstellung so einfach wie möglich zu gestalten, installieren Sie bitte die gleiche Version wie Ihre Ursprungsinstanz. Sie können ggf. erwägen, die alte Instanz vor der Migration zu aktualisieren. Die folgende Anleitung geht davon aus, dass Sie die gleiche Version von Zammad auf Ihrem alten und neuen Host haben.

Step 3: Activate maintenance mode

Dadurch werden alle Sitzungen von Agenten und Kunden beendet. Aktivieren Sie es in Zammads Admin Bereich unter System > Wartung.

Step 4: Disable your communication channels

Das Wiederherstellungsskript startet Zammad automatisch. Das Deaktivieren trägt dazu bei, Datenverluste und Inkonsistenzen zu vermeiden.

Step 5: Stop and disable Zammad

Stellen Sie sicher, dass keine Daten vor der Sicherung geändert werden.

sudo systemctl disable zammad

sudo systemctl stop zammad

Schritt 6: Sicherung

Folgen Sie der Backup Anleitung, um Ihre Sicherung zu erstellen.

Merken Sie sich, ob Sie ein vollständigen Dateisystem-Dump erstellt oder nur Ihre Daten gesichert haben. Dies ist für die Wiederherstellung wichtig.

Wenn Sie den einfachsten Weg gehen wollen, erwägen Sie nur Ihre Daten zu sichern.

Step 7: Transfer your backup files

Speichern Sie Ihre Sicherungsdateien in einem Verzeichnis und geben Sie den Pfad in der Datei config an. Unter Backup-Konfiguration erfahren Sie, wie Sie die Konfigurationsdatei an Ihre Bedürfnisse anpassen können.

Step 8: Restore your backup

Folgen Sie der Wiederherstellungsanleitung bis einschließlich "Backup wiederherstellen", um die Sicherung auf dem neuen Host wiederherzustellen.

Stellen Sie sicher, dass Sie Zammad nach Abschluss der Wiederherstellung beenden.

Step 9: Run required maintenance tasks after restoring

Nach erfolgreicher Wiederherstellung fahren Sie bitte unten fort, abhängig davon, ob Sie nur Ihre Daten gesichert haben oder eine vollständige Dateisystem-Sicherung haben.

Data dump

Schritt 9.1: Löschen Sie den Cache

zammad run rails r "Rails.cache.clear"

Full filesystem dump

INFO

Dieser Schritt ist nur erforderlich, wenn einer der folgenden Punkte erfüllt ist:

• Die Quell- und Zielversion von Zammad sind nicht identisch
• Die Zammad-Installation ist keine Quellcode-Installation
• Das Zammad-Backup ist kein Export von unserer gehosteten Installation

Vollständige Sicherungen für Quellcode-Installationen sind jedoch nicht abgedeckt, Grundsätzlich gilt für Sie das Gleiche wie unten: Sie müssen sicherstellen, dass die Umgebungen und Anwendungsdateien mit der neuen / richtigen Version überschrieben werden.

Zammad-Dateien sind distributions- und versionsspezifisch!

Step 9.1: Uninstall and reinstall Zammad without resolving dependencies

sudo dpkg -r --force-depends zammad

sudo apt install zammad

TIP

Sie sind sich nicht sicher, ob die oben genannten Maßnahmen wirklich erforderlich sind oder eine einfache Neuinstallation ausreicht? Wenn Sie einen Installationsbefehl für Zammad ausführen und die folgende Meldung erhalten, müssen Sie unbedingt den obigen Befehl ausführen, um Ihre Installation zu reparieren.

root@zammad:/# apt update && apt install zammad
  Reading package lists... Done
  Building dependency tree
  Reading state information... Done
  zammad is already the newest version (x.x.x-xxxxxx.xxxxxx.xxx).
  0 upgraded, 0 newly installed, 0 to remove and 0 not upgraded.

Step 9.2: Clear the cache

zammad run rails r "Rails.cache.clear"

Step 9.3: Ensure Zammad is running

sudo systemctl status zammad

Wenn Zammad nicht läuft, führen Sie aus:

sudo systemctl start zammad

TIP

Von Zammad SaaS migriert oder den Anbieter gewechselt?

Bitte stellen Sie sicher, dass Ihr E-Mail-Benachrichtigungskanal und Ihre FQDN-Konfiguration korrekt sind.

Step 10: Apply missing environmental settings

Wenn Sie irgendwelche Umgebungseinstellungen vorgenommen haben, wenden Sie diese jetzt wieder an. Sie haben diese in Schritt 1 gesichert.

Falls noch nicht geschehen, installieren Sie Elasticsearch und führen Sie nach der Installation die Schritte für verbinden und konfigurieren von Elasticsearch aus.

Step 11: Re-enable channels and deactivate maintenance mode

Setzen Sie die zuvor deaktivierten Kanäle wieder auf aktiv, wenn Sie sicher sind, dass alles erfolgreich war. An diesem Punkt beginnt Zammad damit Daten zu ändern!

Nachdem Sie die Funktionalität Ihrer Kanäle überprüft haben, erlauben Sie Ihren Agenten und Kunden, sich wieder anzumelden, indem Sie den Wartungsmodus deaktivieren.