Bekannte Probleme mit Sicherungen für Instanzen

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

Wenn du GitHub Enterprise Server Backup Utilities 3.7.0 zur Sicherung einer Instanz genutzt hast, die ein Release der Serie GitHub Enterprise Server 3.7 ausführt, können Benutzerinnen sich nach Wiederherstellen der Sicherung nicht anmelden. Obwohl sich Benutzerinnen 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 du eine vorhandene Sicherung aus GitHub Enterprise Server Backup Utilities 3.7.0 in einer neuen Instanz wiederhergestellt hast und Benutzer*innen sich nicht anmelden können, musst du die Konfigurationsdaten der Quellinstanz GitHub Enterprise Server ausgeben und die Konfiguration 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.
• Du benötigst eine vorhandene Sicherung aus GitHub Enterprise Server Backup Utilities 3.7.0.
• 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 Verschlüsselungs- und Entschlüsselungsschlüssel anzuzeigen.

   Shell

   ghe-config secrets.github.encrypted-column-keying-material
   

3. 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
   

4. Aktiviere den Wartungsmodus. Weitere Informationen findest du unter Wartungsmodus aktivieren und planen.

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

   Shell

   ghe-config secrets.github.encrypted-column-keying-material
   

6. Führe den folgenden Befehl aus, um die Liste der Schlüssel auf der Zielinstanz zu aktualisieren. Ersetze "KEY-LIST" durch die Ausgabe aus Schritt 1.

   Shell

   ghe-config secrets.github.encrypted-column-keying-material "KEY-LIST"
   

7. Führe den folgenden Befehl aus, um die Konfiguration anzuwenden.

   Shell

   ghe-config-apply
   

8. Warte auf den Abschluss der Konfigurationsausführung.

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

   Shell

   ghe-config secrets.github.encrypted-column-keying-material
   

10. 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.