Sicherung kann nicht wiederhergestellt werden

Nach dem Upgrade auf Tableau Server 2022.1 (oder höher) verursacht das Wiederherstellen einer Tableau Server-Sicherung den folgenden Fehler:

"Die Sicherung kann nicht wiederhergestellt werden, da Tableau Server standardmäßig die neuen Identitätsdiensttabellen verwendet."

Dieses Problem tritt auf, weil Tableau Server die Identitätsmigration ausführen muss. Die Migration ist erforderlich, um den Identitätsdienst zu füllen, ein Identitätsschema, das von Tableau Server 2022.1 (und höher) verwendet wird, um Benutzer bereitzustellen und zu authentifizieren. Um mögliche Probleme zu vermeiden, kann der Upgrade-Vorgang nicht fortgesetzt werden, wenn Tableau Server feststellt, dass die Tableau Server-Sicherung ein anderes Identitätsschema als Tableau Server 2022.1 (oder höher) verwendet.

Um dieses Problem zu beheben, gehen Sie wie folgt vor.

Schritt 1: Aktivieren von legacy-idenity-mode und Wiederherstellen der Sicherung

  1. Öffnen Sie als ein Administrator eine Eingabeaufforderung auf dem Ausgangsknoten (auf dem TSM installiert ist) in dem Cluster.
  2. Stellen Sie Tableau Server 2022.1 (oder höher) so ein, dass der ältere Identitätsspeichermodus verwendet wird, indem Sie die folgenden Befehle ausführen:

    tsm authentication legacy-identity-mode enable
    tsm pending-changes apply

    Tableau Server muss den älteren Identitätsspeichermodus verwenden, um den Identitätsdienst zu füllen. Weitere Informationen zum tsm-Befehl finden Sie unter tsm authentication legacy-identity-mode.

  3. Stellen Sie die Sicherung erneut wieder her, damit die Migration beginnen kann, indem Sie die folgenden Befehle ausführen:

    tsm restore
    tsm pending-changes apply

    Wichtig: Nachdem die Sicherung wiederhergestellt wurde, füllt die Migration den Identitätsdienst mit Identitätsinformationen.

Schritt 2: Validieren und Abschließen der Identitätsmigration

  1. Melden Sie sich als Administrator in Tableau Server an.
  2. Wählen Sie im linken Navigationsbereich Benutzer (oder bei einem Tableau Server mit mehreren Sites Alle Sites > Benutzer) aus und klicken Sie dann auf die Seite Identitätsmigration, um zu überprüfen, dass die Migration gestartet wurde.

    Sie können den Fortschritt mithilfe der dedizierten Identitätsmigrationsseite überwachen und verwalten, die auf der Seite "Benutzer" von Tableau Server verfügbar ist. Weitere Informationen finden Sie unter Verwalten der Identitätsmigration.

  3. Lösen oder bestätigen Sie alle Identitätskonflikte, wie unter Lösen von Konflikten bei der Identitätsmigration beschrieben.

  4. Führen Sie einen der folgenden Schritte aus:

    • Wenn der Identitätsmigrationsauftrag sofort ausgeführt werden soll, klicken Sie auf den Dropdown-Pfeil "Zeitplan bearbeiten" neben der Überschrift "Migrationsübersicht", und wählen Sie dann Jetzt ausführen aus.
    • Alternativ dazu können Sie auch warten, bis der Migrationsauftrag zum nächsten geplanten Zeitpunkt ausgeführt wird.
  5. Überprüfen Sie nach Abschluss der Migration, dass auf der Seite "Identitätsmigration" in der "Migrationsübersicht" der Eintrag 100 % abgeschlossen angezeigt wird.

Schritt 3: Konfigurieren von Tableau Server für die Verwendung des Identitätsdienstes

  1. Öffnen Sie als Administrator eine Eingabeaufforderung auf dem Ausgangsknoten (auf dem TSM installiert ist) in dem Cluster.
  2. Führen Sie die folgenden Befehle aus:

    tsm authentication legacy-identity-mode disable
    tsm pending-changes apply

Wenn sich Benutzer bei Tableau Server anmelden, nachdem Tableau Server für die Verwendung des Identitätsdienstes konfiguriert wurde, sucht Tableau Server anhand ihrer Bezeichner im konfigurierten Identitätsspeicher nach ihren Benutzeridentitäten. Ausgehend von den Bezeichnern werden die universellen eindeutigen Bezeichner (UUID) zurückgegeben und verwendet, um vorhandene Tableau Server-Benutzeridentitäten abzugleichen. Dieser Prozess generiert dann Sitzungen für die Benutzer und schließt den Authentifizierungsworkflow ab.

"Unerwarteter Fehler" auf der Identitätsmigrationsseite

Nachdem Sie alle Benutzeridentitäten auf der Identitätsmigrationsseite aufgelöst oder bestätigt haben, wird die Meldung "Unerwarteter Fehler" angezeigt. Diese Meldung kann angezeigt werden, wenn Sie versucht haben, mehr als 1.000 Benutzeridentitäten gleichzeitig aufzulösen oder zu bestätigen.

Um dieses Problem zu beheben, wählen Sie 1.000 oder weniger Benutzeridentitäten aus, lösen Sie sie auf oder bestätigen Sie sie und versuchen Sie es dann erneut.

Weitere Informationen zur Handhabung von Identitätskonflikten finden Sie unter Lösen von Konflikten bei der Identitätsmigration.

Rückgängigmachen der Identitätsmigration

Wenn es Probleme gibt, wie z. B. dass sich bestimmte Benutzer nicht bei Tableau Server anmelden können, die Ihrer Meinung nach durch den Identitätsdienst verursacht werden, können Sie den Befehl tsm authentication legacy-identity-mode verwenden, um zum älteren Identitätsspeichermodus zurückzukehren. Nach der Rückgängigmachung können sich sowohl neue Benutzer, die nach der Identitätsmigration hinzugefügt wurden, als auch Benutzer, die sich vor der Migration nur bei Tableau Server anmelden konnten, ohne Probleme bei Tableau Server anmelden.

Nachdem Sie vom Identitätsdienst zum älteren Identitätsspeichermodus zurückgekehrt sind, können Sie die Identitätsmigrationsseite verwenden, um die Migration für die problematischen Benutzeridentitäten durchzuführen. Weitere Informationen zur Handhabung von Identitätskonflikten finden Sie unter Lösen von Konflikten bei der Identitätsmigration.

Vielen Dank für Ihr Feedback!