{"meta":{"title":"Wiederherstellen aus einer Sicherung","intro":"Stellen Sie eine GitHub Enterprise Server Instanz mithilfe einer zuvor erstellten Sicherungsmomentaufnahme wieder her.","product":"Unternehmensadministratoren","breadcrumbs":[{"href":"/de/enterprise-server@3.17/admin","title":"Unternehmensadministratoren"},{"href":"/de/enterprise-server@3.17/admin/backing-up-and-restoring-your-instance","title":"Sichern und Wiederherstellen"},{"href":"/de/enterprise-server@3.17/admin/backing-up-and-restoring-your-instance/restoring-from-a-backup","title":"Wiederherstellen aus einer Sicherung"}],"documentType":"article"},"body":"# Wiederherstellen aus einer Sicherung\n\nStellen Sie eine GitHub Enterprise Server Instanz mithilfe einer zuvor erstellten Sicherungsmomentaufnahme wieder her.\n\nSie können eine GitHub Enterprise Server Instanz mithilfe der Befehlszeile aus einer Sicherung wiederherstellen. Der Sicherungsdienst unterstützt die vollständige Wiederherstellung von Instanzen, einschließlich der Konfiguration und Benutzerdaten.\n\n> \\[!WARNING] Durch die Wiederherstellung aus einer Sicherung werden **alle vorhandenen Daten** in deiner Instanz überschrieben. Dieser Vorgang kann nicht rückgängig gemacht werden.\n\n## Versionsanforderungen für Momentaufnahmen\n\nDu kannst eine Momentaufnahme nur wiederherstellen, wenn sie aus maximal zwei Featureversionen hinter der Version der Zielinstanz stammt.\n\nBeispiel:\n\n* Eine Momentaufnahme aus Version 3.17 kann auf einem Ziel mit 3.17.x, 3.18.x oder 3.19.x wiederhergestellt werden.\n* Du kannst eine 3.17-Momentaufnahme nicht in Version 3.20 wiederherstellen, da diese mehr als zwei Versionen voraus ist.\n\nDu kannst auch nicht von einer neueren Version auf eine ältere Version wiederherstellen. Wenn Sie z. B. versuchen, eine 3.18-Momentaufnahme in eine 3.17-Instanz wiederherzustellen, wird dies mit folgendem Fehler fehlschlagen: `Error: Snapshot can not be restored to an older release of GitHub Enterprise Server.`\n\n## Voraussetzungen\n\nVor dem Wiederherstellen einer Sicherung:\n\n1. **Aktiviere den Wartungsmodus** in der Zielinstanz. Siehe [Wartungsmodus aktivieren und planen](/de/enterprise-server@3.17/admin/administering-your-instance/configuring-maintenance-mode/enabling-and-scheduling-maintenance-mode).\n2. **Überprüfen Sie den Zugriff** auf den Sicherungsspeicher, der die Momentaufnahme enthält.\n3. **Halte beeinträchtigende Dienste an**. Stelle bei Verwendung von Hochverfügbarkeit sicher, dass die Replikation beendet ist.\n4. **Vorbereiten auf GitHub Actions** – Wenn diese Option aktiviert ist, stellen Sie sicher, dass die Zielinstanz mit dem richtigen externen Speicher konfiguriert ist. Einzelheiten findest du unter [Wiederherstellen mit aktivierter GitHub Actions](/de/enterprise-server@3.17/admin/backing-up-and-restoring-your-instance/restoring-with-github-actions-enabled).\n\n## Starten des Wiederherstellungsvorgangs\n\nWiederherstellen aus einer Momentaufnahme:\n\n1. Stelle eine SSH-Verbindung mit der Zielinstanz als `admin`-Benutzer her.\n\n2. Führen Sie einen der folgenden Befehle aus:\n\n   * Wiederherstellen der neuesten Momentaufnahme:\n\n     ```shell\n     ghe-restore\n     ```\n\n   * Stelle eine bestimmte Momentaufnahme wieder her. Ersetze `<SNAPSHOT_TIMESTAMP>` durch den Zeitstempel der Momentaufnahme, die du wiederherstellen möchtest (z. B. `YYYYMMDDTHHMMSS`).\n\n     ```shell\n     ghe-restore -s <SNAPSHOT_TIMESTAMP>\n     ```\n\n   * (Optional) Überschreiben Sie die Appliance-Konfiguration, Zertifikate und Lizenzdaten aus der Sicherung. Die `-c` Option steuert keine Datenbank- oder Repositorywiederherstellung:\n\n     ```shell\n     ghe-restore -c          # Latest snapshot\n     ghe-restore -s <SNAPSHOT_TIMESTAMP> -c  # Specific snapshot\n     ```\n\n3. **Abschließen in Verwaltungskonsole:**\n\n   * Überprüfe alle Konfigurationseinstellungen (Netzwerk, Authentifizierung, TLS usw.).\n   * Klicke auf **Save settings**, um sie anzuwenden und die Dienste zu starten.\n   * Die Instanz ist erst vollständig funktionsfähig, wenn dieser Schritt abgeschlossen ist.\n\n4. **Überprüfe die wiederhergestellte Instanz**, um sicherzustellen, dass alles wie erwartet funktioniert.\n\n5. **Wenn Hochverfügbarkeit (HA) genutzt wird**, führe zuerst die Wiederherstellung auf einer eigenständigen Instanz durch. Konfiguriere dann HA neu.\n\n   * Wenn Synchronisierungsprobleme auftreten (z. B. veraltete UUIDs in `ghe-repl-status`), führe `ghe-repl-teardown` aus.\n   * Für Hilfe wenden Sie sich an GitHub-Support.\n\n6. **Registrieren Sie selbstgehostete GitHub Actions Runner** erneut, da bei der Wiederherstellung vorherige Token ungültig werden.\n\n## Rotation und Aufbewahrung von Momentaufnahmen\n\nMomentaufnahmen werden basierend auf deinen Aufbewahrungseinstellungen automatisch bereinigt:\n\n* Nur die neuesten n Momentaufnahmen werden beibehalten (wie konfiguriert).\n* Ältere Momentaufnahmen werden nach jeder erfolgreichen Sicherung gelöscht.\n* Momentaufnahmen werden mithilfe von Zeitstempeln (`YYYYMMDDTHHMMSS`) benannt, um sie einfach zuordnen zu können.\n* Hardlinks werden verwendet, um unveränderte Dateien effizient zu speichern und gleichzeitig die vollständige Wiederherstellbarkeit beizubehalten.\n\n## Wiederherstellungsfehler beheben\n\nWenn ein Wiederherstellungsvorgang fehlschlägt, überprüfe Folgendes:\n\n* **Vollständigkeit der Sicherung**: Stelle sicher, dass die Momentaufnahme nicht unterbrochen oder beschädigt wurde.\n* **Speicherzugriff**: Überprüfe, ob die Instanz das Sicherungsvolume bereitstellen und lesen kann.\n* **Versionskonflikt**: Vergewissere dich, dass die Momentaufnahmeversion mit der Zielinstanz kompatibel ist.\n* **Protokolle**: Überprüfe `/var/log/github-backup/restore-verbose-[timestamp].log` auf Fehler.\n\nWenn Verwaltungskonsole einen allgemeinen Fehler anzeigt, melden Sie sich per SSH bei der Instanz an, um auf ausführliche Protokolle zuzugreifen."}