Server-Backup: Wiederherstellungspunkte für Kage und Discord

Das Server-Backup legt Wiederherstellungspunkte an: eine Momentaufnahme deiner Kage-Einstellungen und, wenn du willst, der Discord-Grundstruktur aus Kategorien, Kanälen und Rollen. Aus einem Wiederherstellungspunkt kannst du später Einstellungen zurückholen oder fehlende Kanäle und Rollen neu anlegen lassen.

Eine kurze Anleitung findest du im Ratgeber Server sichern.

Was ein Backup enthält und was nicht

Gesichert wird bei der Struktur:

• Rollen: Name, Farbe, getrennte Anzeige, Erwähnbarkeit, Rechte und Position. Rollen, die eine Integration oder ein Bot verwaltet, und @everyone fehlen.
• Kategorien: Name, Position und die Berechtigungen für Rollen.
• Kanäle: Name, Typ (Text oder Sprache), Kategorie, Position und die Berechtigungen für Rollen. Bei Textkanälen kommt das Thema dazu.

Nicht gesichert werden Nachrichten, Mitglieder und ihre Rollenzuweisungen, Berechtigungen einzelner Mitglieder, Emojis, Sticker, Threads und Webhooks. Auch Daten wie XP-Stände, Guthaben der Economy oder Verwarnungen gehören nicht dazu: Bei der Konfiguration sichert Kage nur die Einstellungen der Module.

Voraussetzungen

• Zugriff auf das Modul: Du meldest dich im Dashboard mit Discord an und brauchst das Recht Server verwalten (oder einen für dieses Modul freigegebenen Zugriff).
• Für Befehle: Du brauchst das Recht Administrator.
• Rechte von Kage: zum Sichern der Struktur muss Kage die Kanäle und Rollen sehen. Zum Wiederherstellen braucht Kage Kanäle verwalten und Rollen verwalten.
• Tarif: Welchen Tarif das Modul braucht, zeigt der Tarifhinweis oben auf dieser Seite.

Ein Backup erstellen

Im Dashboard: Öffne Server-Backup, wähle den Typ, gib optional eine Bezeichnung ein und klicke Backup erstellen.

Per Befehl: /backup create type:<Typ> label:<Bezeichnung>. Ohne Typ sichert Kage Konfiguration und Struktur.

Die Liste der Wiederherstellungspunkte zeigt Typ, Bezeichnung, Inhalt (Zahl der Module, Rollen, Kategorien und Kanäle) und Erstellungszeit. Kage legt keine automatischen Backups an, du löst jedes selbst aus.

Limit

Kage behält nur eine begrenzte Zahl an Wiederherstellungspunkten. Ist das Limit erreicht, löscht das nächste Backup den ältesten Punkt.

Backups, die du per Befehl erstellst, kürzt Kage unabhängig vom Tarif auf die neuesten 20. Erstellst du viele Punkte per Befehl, kann das ältere Punkte löschen, die dein Tarif sonst behalten würde.

Wiederherstellen

Im Dashboard: Klicke bei einem Punkt auf Wiederherstellen und bestätige.

Per Befehl: /backup list zeigt die letzten Punkte mit ihrer Nummer. /backup restore id:<Nummer> fragt mit einem Knopf nach. Nur wer den Befehl eingegeben hat, kann bestätigen, und die Abfrage verfällt nach zwei Minuten.

Konfiguration

Kage schreibt die gesicherten Einstellungen jedes im Backup enthaltenen Moduls zurück, auch ob es an oder aus war. Aktuelle Einstellungen dieser Module werden überschrieben. Module, die nicht im Backup stehen, bleiben unverändert. Module, die es nicht mehr gibt, überspringt Kage.

Achtung: Die Einstellungen verweisen auf Kanäle und Rollen über ihre ID. Legt die Wiederherstellung einen gelöschten Kanal neu an, bekommt er eine neue ID. Eine Einstellung, die auf den alten Kanal zeigt, verweist danach ins Leere, bis du den Kanal im Modul neu auswählst. Das Dashboard und die Überwachung weisen auf solche Lücken hin.

Struktur

Die Wiederherstellung der Struktur ist rein additiv:

• Kage legt nur an, was fehlt. Der Abgleich läuft über den Namen. Gibt es eine Rolle, eine Kategorie oder einen Kanal mit diesem Namen schon, lässt Kage ihn unverändert. Bei Kanälen zählt jeder gleichnamige Kanal, egal in welcher Kategorie.
• Nichts wird gelöscht oder überschrieben.
• Neu angelegte Rollen, Kategorien und Kanäle bekommen ihre gesicherte Position und die Berechtigungen für Rollen zurück. Die Zuordnung der Rollen läuft ebenfalls über den Namen.
• Die Reihenfolge der Rollen stellt Kage nach bestem Können her. Discord erlaubt keine Positionen auf oder über Kages höchster Rolle, dann bleibt die Rolle dort, wo Discord sie einsortiert.
• Kann Discord etwas nicht anlegen, zum Beispiel eine Rolle mit Rechten, die Kage selbst nicht besitzt, überspringt Kage es und macht mit dem Rest weiter.
• Kanäle, die per Befehl gesichert wurden und Stage- oder Forum-Kanäle waren, legt Kage als Textkanäle neu an.

Nach der Wiederherstellung zeigt Kage, wie viele Module wiederhergestellt und wie viele Rollen, Kategorien und Kanäle neu angelegt wurden, oder dass nichts zu tun war.

Wiederherstellungspunkt löschen

Mit Löschen entfernst du einen Punkt endgültig. Das lässt sich nicht rückgängig machen. Deine aktuelle Konfiguration und dein Discord-Server bleiben dabei unverändert.

Einstellungen im Überblick

Das Modul hat keine eigenen Einstellungen. Es besteht aus der Liste der Wiederherstellungspunkte und den Befehlen:

Befehle protokolliert Kage im Reiter Logs, ebenso das Löschen im Dashboard.

Ergebnis überprüfen

1. Sichern: Erstelle ein Backup vom Typ „Konfiguration + Struktur“. Es erscheint in der Liste mit Zahl der Module, Rollen, Kategorien und Kanäle.
2. Test-Kanal: Lege in Discord einen Testkanal an, sichere erneut, lösche den Kanal und stelle den neuen Punkt wieder her.
3. Ergebnis: Der Kanal ist wieder da, alle anderen Kanäle sind unverändert.

Fehlerbehebung

„Discord-Struktur konnte nicht gelesen werden“

Kage kann Kanäle oder Rollen deines Servers gerade nicht lesen. Versuche es erneut. Bleibt es dabei, prüfe Kages Rechte.

Nach der Wiederherstellung zeigt ein Modul auf einen fehlenden Kanal

Der Kanal wurde neu angelegt und hat eine neue ID. Wähle ihn im Modul neu aus.

Eine Rolle oder ein Kanal wurde nicht neu angelegt

Gab es schon etwas mit gleichem Namen, lässt Kage es unverändert. Sonst fehlen Kage Rechte, oder Discord hat die Rolle abgelehnt, weil sie Rechte enthält, die Kage selbst nicht hat.

Die Rolle steht an einer anderen Stelle

Discord erlaubt Positionen nur unterhalb von Kages höchster Rolle. Verschiebe die Rolle von Hand.

Der Wiederherstellungs-Knopf reagiert nicht

Die Abfrage gilt nur für die Person, die /backup restore eingegeben hat, und nur zwei Minuten. Gib den Befehl erneut ein.

Ein älterer Punkt ist verschwunden

Das Limit wurde erreicht und der älteste Punkt gelöscht, siehe „Limit“.

Weiterführend

Probleme automatisch melden: Überwachung.