Skip to main content

Diese Version von GitHub Enterprise Server wurde eingestellt am 2024-07-09. Es wird keine Patch-Freigabe vorgenommen, auch nicht für kritische Sicherheitsprobleme. Für bessere Leistung, verbesserte Sicherheit und neue Features aktualisiere auf die neueste Version von GitHub Enterprise Server. Wende dich an den GitHub Enterprise-Support, um Hilfe zum Upgrade zu erhalten.

Bekannte Probleme mit Sicherungen für Instanzen

Hier findest du eine Übersicht über die Umgehung von Problemen, die sich auf den Sicherungs- oder Wiederherstellungsvorgang für GitHub Enterprise Server auswirken.

Informationen zu bekannten Problemen mit GitHub Enterprise Server-Sicherungen

GitHub bietet Problemumgehungen für die folgenden Probleme, die sich auf die Sicherung oder Wiederherstellung von Daten für eine GitHub Enterprise Server-Instanz auswirken können. Weitere Informationen findest du unter „Bekannte Probleme“ in den Versionshinweisen zu GitHub Enterprise Server.

Benutzer*innen können sich nach der Wiederherstellung einer Sicherung nicht anmelden

Hinweis: Dieses bekannte Problem wurde in GitHub Enterprise Server Backup Utilities 3.9.1 behoben.

Wenn Sie GitHub Enterprise Server Backup Utilities 3.7.0, 3.8.0 oder 3.9.0 verwendet haben, um eine Instance zu sichern, auf der eine beliebige Freigabe der GitHub Enterprise Server 3.7 oder 3.8 laufen, können sich die Benutzer nach der Wiederherstellung der Sicherung in einer neuen Instanz nicht mehr anmelden. Obwohl sich Benutzer*innen nicht anmelden können, ist die Sicherung selbst nicht betroffen, und alle Daten sind intakt.

Nachdem du eine von diesem Problem betroffene vorhandenen Sicherung wiederhergestellt hast, kannst du das Problem lösen, indem du die Konfiguration für die neue Instanz änderst.

Wiederherstellen über eine vorhandene Sicherung

Wenn Sie eine vorhandene Sicherung über GitHub Enterprise Server Backup Utilities 3.7.0, 3.8.0 oder 3.9.0 auf einer neuen Instanz wiederhergestellt haben und Benutzer*innen sich nicht anmelden können, müssen Sie Konfigurationsdaten über die GitHub Enterprise Server-Quellinstanz ausgeben und die Konfiguration auf der Zielinstanz anpassen.

Um sicherzustellen, dass sich Benutzer*innen bei der neuen Zielinstanz anmelden können, stelle sicher, dass deine Umgebung die folgenden Anforderungen erfüllt.

  • Die GitHub Enterprise Server-Quellinstanz muss ausgeführt werden und über SSH zugänglich sein.
  • Sie müssen über eine vorhandene Sicherung über GitHub Enterprise Server Backup Utilities 3.7.0, 3.8.0, or 3.9.0 verfügen.
  • Du musst eine neue GitHub Enterprise Server-Zielinstanz bereitgestellt und die Sicherung wiederhergestellt haben. Weitere Informationen findest du unter GitHub Enterprise Server-Instanz einrichten und unter Konfigurieren von Sicherungen auf einer Instanz.
  1. Stelle eine SSH-Verbindung mit der GitHub Enterprise Server-Quellinstanz her, die du gesichert hast. Wenn deine Instanz mehrere Knoten umfasst, wenn z. B. Hochverfügbarkeit oder Georeplikation konfiguriert ist, wird SSH im primären Knoten konfiguriert. Wenn du einen Cluster verwendest, kannst du SSH in einen beliebigen Knoten einfügen. Ersetze „HOSTNAME“ durch den tatsächlichen Hostnamen deiner Instanz. Weitere Informationen zum SSH-Zugriff findest du unter Auf die Verwaltungsshell (SSH) zugreifen.

    Shell
    ssh -p 122 admin@HOSTNAME
    
  2. Führe den folgenden Befehl aus, um eine Liste der Entschlüsselungsschlüssel anzuzeigen.

    Shell
    ghe-config secrets.github.encrypted-column-keying-material
    
  3. Kopiere die Ausgabe, und speichere sie an einem sicheren und temporären Speicherort.

  4. Führe den folgenden Befehl aus, um eine Liste mit Verschlüsselungsschlüsseln anzuzeigen.

    Shell
    ghe-config secrets.github.encrypted-column-current-encryption-key
    
  5. Kopiere die Ausgabe, und speichere sie an einem sicheren und temporären Speicherort.

  6. Stelle eine SSH-Verbindung mit der GitHub Enterprise Server-Zielinstanz her, auf der du die Sicherung wiederhergestellt hast. Ersetze „HOSTNAME“ durch den tatsächlichen Hostnamen deiner Instanz.

    Shell
    ssh -p 122 admin@HOSTNAME
    
  7. Aktiviere den Wartungsmodus. Weitere Informationen findest du unter Wartungsmodus aktivieren und planen.

  8. Um zu überprüfen, ob die Zielinstanz bereit für die Konfiguration ist, führe die folgenden Befehle aus . Es sollte keine Ausgabe angezeigt werden.

    Shell
    ghe-config secrets.github.encrypted-column-keying-material
    ghe-config secrets.github.encrypted-column-current-encryption-key
    
  9. Führe den folgenden Befehl aus, um die Entschlüsselungsschlüssel auf der Zielinstanz zu aktualisieren. Ersetze "DECRYPTION-KEY-LIST" durch die Ausgabe aus Schritt 1.

    Shell
    ghe-config secrets.github.encrypted-column-keying-material "DECRYPTION-KEY-LIST"
    
  10. Führe den folgenden Befehl aus, um den Verschlüsselungsschlüssel auf der Zielinstanz zu aktualisieren. Ersetze "ENCRYPTION-KEY" durch die Ausgabe aus Schritt 4.

    Shell
    ghe-config secrets.github.encrypted-column-current-encryption-key "ENCRYPTION-KEY"
    
  11. Führe den folgenden Befehl aus, um die Konfiguration anzuwenden.

    Shell
    ghe-config-apply
    
  12. Warte auf den Abschluss der Konfigurationsausführung.

  13. Um sicherzustellen, dass die Konfiguration der Zielinstanz die Schlüssel enthält, führe die folgenden Befehle aus und vergewissere dich, dass die Ausgabe Schritt 1 und Schritt 4 entspricht.

    Shell
    ghe-config secrets.github.encrypted-column-keying-material
    ghe-config secrets.github.encrypted-column-current-encryption-key
    
  14. Weise einen Benutzerin an, sich bei der Zielinstanz anzumelden. Wenn Probleme auftreten, wende dich an den GitHub Enterprise Support. Weitere Informationen findest du unter Kontaktieren des GitHub-Supports.