Problemen met de identiteitsmigratie oplossen

Kan back-up niet terugzetten

Na een upgrade naar Tableau Server 2022.1 (of hoger) kan bij het terugzetten van een back-up van Tableau Server de volgende fout optreden:

De back-up kan niet worden hersteld, omdat Tableau Server standaard de nieuwe tabellen voor de identiteitsservice gebruikt.

Dit probleem kan optreden wanneer Tableau Server de identiteitsmigratie moet uitvoeren, wat een noodzakelijk proces is om de identiteitsservice te vullen. De identiteitsservice is een identiteitsschema dat is geïntroduceerd sinds Tableau Server 2022.1 en wordt gebruikt om gebruikers in te richten en te verifiëren. Om mogelijke problemen te voorkomen, kan het herstelproces niet worden voortgezet wanneer Tableau Server detecteert dat de back-up van Tableau Server een ander identiteitsschema gebruikt dan de versie waarnaar deze wordt hersteld.

Opmerking: de identiteitsservice is het standaard identiteitsschema in Tableau Server-versie 2022.1-2022.1.7, 2022.3-2022.3.9 en 2023.1-2023.15.

Om dit probleem op te lossen, volgt u de onderstaande stappen.

Stap 1: Schakel legacy-identity-mode in en zet de back-up terug

  1. Open een opdrachtprompt als beheerder op het eerste knooppunt (waar TSM is geïnstalleerd) in het cluster.
  2. Stel Tableau Server 2022.1 (of later) in om de oude identiteitenarchiefmodus te gebruiken door de volgende opdrachten uit te voeren:

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

    Tableau Server moet de oude identiteitenarchiefmodus gebruiken om de identiteitsservice te vullen. Zie tsm authentication legacy-identity-mode voor meer informatie over de tsm-opdracht.

  3. Zet de back-up opnieuw terug zodat de migratie kan worden gestart door de volgende opdrachten uit te voeren:

    tsm maintenance restore --file <file_name>
    tsm start

    Belangrijk: nadat de back-up is teruggezet, wordt de identiteitsservice tijdens de migratie gevuld met identiteitsdata. Zie Herstellen van een back-up voor algemene informatie over het terugzetten van een back-up.

Stap 2: Valideer en voltooi de identiteitsmigratie

  1. Meld u als beheerder aan bij Tableau Server.
  2. Selecteer in het linker navigatiedeelvenster Gebruikers (of Alle sites > Gebruikers voor een Tableau Server met meerdere sites) en klik vervolgens op de pagina Identiteitsmigratie om te controleren of de migratie is gestart.

    U kunt de voortgang ervan bewaken en beheren via de speciale pagina Identiteitsmigratie, die beschikbaar is op de pagina Gebruikers van Tableau Server. Raadpleeg voor meer informatie De identiteitsmigratie beheren.

  3. Los alle identiteitsconflicten op of bevestig ze zoals beschreven in Identiteitsmigratieconflicten oplossen, zodat op het tabblad Alle fouten "0" wordt weergegeven, zoals in de afbeelding hieronder.

  4. Voer een van de volgende handelingen uit:

    • Als u de identiteitsmigratietaak nu wilt uitvoeren, klikt u naast de kop Migratieoverzicht op de vervolgkeuzepijl Planning bewerken en selecteert u vervolgens Nu uitvoeren.

    • U kunt er ook voor kiezen om te wachten tot de migratietaak op het eerstvolgende geplande tijdstip wordt uitgevoerd.
  5. Nadat de migratie is voltooid, controleert u op de pagina Identiteitsmigratie of het migratieoverzicht het volgende weergeeft: 100% compleet.

Stap 3: Configureer Tableau Server voor gebruik van de identiteitsservice

  1. Open een opdrachtprompt als beheerder op het eerste knooppunt (waar TSM is geïnstalleerd) in het cluster.
  2. Voer de volgende opdrachten uit:

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

    Opmerking: nadat u de bovenstaande opdrachten hebt uitgevoerd, is de speciale pagina Identiteitsmigratie verwijderd en niet langer toegankelijk. De pagina is alleen toegankelijk als tsm authentication legacy-identity-mode is ingeschakeld.

Nadat Tableau Server is geconfigureerd voor het gebruik van de identiteitsservice, zoekt Tableau Server, wanneer gebruikers zich bij Tableau Server aanmelden, naar hun gebruikersidentiteiten met behulp van hun ID's in de geconfigureerde identiteitenarchief. Op basis van de identificatiedata worden de universele unieke identificatiedata (UUID) geretourneerd en gebruikt om aan bestaande Tableau Server-gebruikersidentiteiten te koppelen. Dit proces genereert vervolgens sessies voor de gebruikers en voltooit de verificatieworkflow.

'Onverwachte fout' op de pagina Identiteitsmigratie

Nadat u alle gebruikersidentiteiten hebt opgelost of bevestigd op de pagina Identiteitsmigratie, ziet u het bericht 'Onverwachte fout'. Dit bericht kan worden weergegeven wanneer u meer dan 1000 gebruikersidentiteiten tegelijk probeert om te zetten of erkennen.

U kunt dit probleem oplossen door 1000 of minder gebruikersidentiteiten te selecteren en om te zetten of erkennen en het vervolgens opnieuw te proberen.

Zie Identiteitsmigratieconflicten oplossen voor meer informatie over het omgaan met identiteitsconflicten.

Migratievoortgang lijkt niet te reageren of vast te zitten

Als de migratiestatus of de voortgangsbalk voor de migratie niet reageert of vastloopt, controleer dan of u alle gebruikersconflicten onder Migratiefouten hebt opgelost en erkend.

Om dit probleem op te lossen, moet u ervoor zorgen dat alle conflicten worden opgelost en erkend door een of meer gebruikersidentiteiten te selecteren op het tabblad Alle fouten en te klikken op Erkennen in het vervolgkeuzemenu Acties. Voer deze taak uit tot op het tabblad Alle fouten "0" wordt weergegeven. Zie Identiteitsmigratieconflicten oplossen voor meer informatie over het omgaan met identiteitsconflicten.

Opmerking: nadat alle identiteitsconflicten zijn opgelost of verwerkt, moeten alle migratietaken worden uitgevoerd voordat u de identiteitsservice voor Tableau Server kunt inschakelen. U kunt de migratietaken nu uitvoeren door te klikken op de vervolgkeuzepijl bij Planning bewerken naast de kop Migratieoverzicht en vervolgens Nu uitvoeren te selecteren. Wanneer bij Migratieoverzicht 100% voltooid wordt weergegeven, kunt u Tableau Server configureren voor gebruik van de identiteitsservice. Zie Stap 3: Voltooi de identiteitsmigratie voor meer informatie.

De pop-up 'Identiteitsmigratie wordt uitgevoerd' wordt blijvend weergegeven

De melding 'Identiteitsmigratie wordt uitgevoerd' wordt blijvend weergegeven, ook al is de identiteitsmigratie voltooid. Dit komt doordat de identiteitsservice nog niet is ingeschakeld. Om de identiteitsmigratie te voltooien, moet de identiteitsservice worden ingeschakeld in Stap 4: Configureer Tableau Server voor gebruik van de Identiteitsservice, zodat Tableau Server de identiteitsstructuur kan gebruiken waarmee identiteitspools mogelijk worden gemaakt.

De pagina Identiteitsmigratie verdwijnt

Wanneer de identiteitsmigratie is voltooid en Tableau Server is geconfigureerd voor gebruik van de identiteitsservice, wordt de toegewezen pagina Identiteitsmigratie verwijderd en is deze niet langer toegankelijk. De pagina Identiteitsmigratie is alleen nodig voor de identiteitsmigratie of wanneer tsm authentication legacy-identity-mode is ingeschakeld.

Gebruikers kunnen zich niet aanmelden

Nadat de identiteitsmigratie is voltooid en de identiteitsservice is ingeschakeld, kunnen sommige gebruikers zich niet meer aanmelden bij Tableau Server. In de meeste gevallen doet dit probleem zich voor bij gebruikers waarvan de identiteiten een conflict hadden en die vervolgens tijdens de identiteitsmigratie werden gewijzigd in Erkend. Gebruikersidentiteiten die zijn erkend, worden niet gemigreerd naar de identiteitsservice en worden vervolgens genegeerd tijdens Active Directory- (AD) of LDAP-groepssynchronisaties.

Als gebruikers die aan deze erkende gebruikersidentiteiten zijn gekoppeld, opnieuw toegang tot Tableau Server nodig hebben, voegt u de gebruikers handmatig aan Tableau Server toe. Nadat de gebruikers handmatig zijn toegevoegd, worden de gebruikersidentiteiten herkend tijdens de daaropvolgende AD- of LDAP-groepsynchronisaties en worden deze zoals verwacht gesynchroniseerd.

Identiteitsmigratie terugdraaien

Als er problemen zijn, zoals bepaalde gebruikers die zich niet kunnen aanmelden bij Tableau Server, waarvan u denkt dat deze worden veroorzaakt door de identiteitsservice, kunt u de opdracht tsm authentication legacy-identity-mode uitvoeren om terug te keren naar de oude identiteitenarchiefmodus. Nadat u dit hebt teruggedraaid, kunnen zowel nieuwe gebruikers die na de identiteitsmigratie zijn toegevoegd als gebruikers die zich vóór de migratie alleen bij Tableau Server konden aanmelden, zich zonder problemen bij Tableau Server aanmelden.

Nadat u bent teruggekeerd van de identiteitsservice naar de oude identiteitenarchiefmodus, kunt u op de pagina Identiteitsmigratie de migratie uitvoeren voor de problematische gebruikersidentiteiten. Zie Identiteitsmigratieconflicten oplossen voor meer informatie over het omgaan met identiteitsconflicten.

Bedankt voor uw feedback.De feedback is verzonden. Dank u wel.