Felsöka problem med identitetsmigrering

Det går inte att återställa säkerhetskopian

Efter uppgradering till Tableau Server 2022.1 (eller senare) kan en återställning av en Tableau Server-säkerhetskopia orsaka följande fel:

”Säkerhetskopieringen kan inte återställas eftersom Tableau Server använder de nya identitetstjänsttabellerna som standard.”

Det här problemet kan uppstå när Tableau Server behöver köra identitetsmigreringen, vilket är en nödvändig process för att fylla i identitetstjänsten. Identitetstjänsten är ett identitetsschema som först introducerades i Tableau Server 2022.1 och används för att provisionera och autentisera användare. För att förhindra eventuella problem kan återställningsprocessen inte fortsätta när Tableau Server har identifierat att Tableau Server-säkerhetskopian använder ett annat identitetsschema än den version som den återställs till.

Obs! Identitetstjänsten är standardidentitetsschemat i Tableau Server version 2022.1–2022.1.7, 2022.3–2022.3.9 och 2023.1–2023.15.

Lös problemet genom att följa nedanstående steg.

Steg 1: Aktivera legacy-identity-mode och återställ säkerhetskopian

  1. Öppna en kommandotolk som administratör på den initiala noden (där TSM har installerats) i klustret.
  2. Ställ in Tableau Server 2022.1 (eller senare) till att använda det äldre identitetsarkivläget genom att köra följande kommandon:

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

    Tableau Server måste använda det äldre identitetsarkivläget för att fylla i identitetstjänsten. Mer information om tsm-kommandot finns i tsm authentication legacy-identity-mode.

  3. Återställ säkerhetskopian igen så att du kan initiera migreringen genom att köra följande kommandon:

    tsm maintenance restore --file <file_name>
    tsm start

    Viktigt: När säkerhetskopian har återställts fyller migreringen i identitetstjänsten med identitetsinformation. Allmän information om hur du återställer från en säkerhetskopia finns i Återställa från en säkerhetskopia.

Steg 2: Validera och slutför identitetsmigreringen

  1. Logga in på Tableau Server som administratör.
  2. Från den vänstra navigeringsrutan, välj Användare (eller Alla webbplatser > Användare för en Tableau Server på flera platser) och klicka sedan på sidan Identitetsmigrering för att verifiera att migreringen har startat.

    Du kan övervaka och hantera förloppet med hjälp av den dedikerade sidan för identitetsmigrering som finns tillgänglig från samma sida som användaren av Tableau Server använder. Du hittar mer information i Hantera identitetsmigrering.

  3. Lös eller bekräfta alla identitetskonflikter enligt beskrivningen i Lösa konflikter vid identitetsmigrering så att fliken Alla fel visar 0 som i bilden nedan.

  4. Gör något av följande:

    • För att köra identitetsmigreringsjobbet nu, klicka på listmenyn Redigera schema bredvid rubriken Migrationsöversikt och välj sedan Kör nu.

    • Som ett alternativ kan du vänta tills migreringsjobbet körs under nästa schemalagda tid.
  5. När migreringen har slutförts verifierar du att migreringsöversikten visar 100% complete på sidan Identitetsmigrering,.

Steg 3: Konfigurera Tableau Server till att använda identitetstjänsten

  1. Öppna en kommandotolk som administratör på den initiala noden (där TSM har installerats) i klustret.
  2. Kör följande kommandon:

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

    Obs! När kommandona ovan har körts tas den dedikerade sidan för identitetsmigrering bort och är inte längre tillgänglig. Sidan är bara tillgänglig när tsm authentication legacy-identity-mode är aktiverat.

När Tableau Server har konfigurerats för att använda identitetstjänsten och användare loggar in på Tableau Server, så söker Tableau Server efter deras identiteter med hjälp av deras identifierare i det konfigurerade identitetsregistret. Utifrån dessa identifierare returneras UUID (Universal Unique Identifier) som används för att matcha befintliga Tableau Server-användaridentiteter. Den här processen genererar sedan sessioner för användarna och slutför autentiseringsarbetsflödet.

”Oväntat fel” på sidan Identitetsmigrering

När du har löst eller bekräftat alla användaridentiteter från sidan Identitetsmigrering visas meddelandet ”Oväntat fel”. Det här meddelandet kan visas när du har försökt lösa eller bekräfta mer än 1000 användaridentiteter på en gång.

Du kan lösa det här problemet genom att välja och lösa eller bekräfta 1000 användaridentiteter eller färre och sedan försöka igen.

Mer information om hur man hanterar identitetskonflikter finns i Lösa konflikter vid identitetsmigrering.

Migreringsförloppet verkar inte svara eller har fastnat

Om migreringsstatusen eller migreringsförloppsfältet inte svarar eller fastnar, ska du verifiera att du har löst och bekräftat alla användarkonflikter under Migreringsfel.

Du kan lösa det här problemet genom att se till att alla konflikter är lösta och bekräftade och välja en eller flera användaridentiteter på fliken Alla fel och klicka på Bekräfta på listrutemenyn Åtgärder. Utför den här uppgiften tills fliken Alla fel visar ”0”. Mer information om hur man hanterar identitetskonflikter finns i Lösa konflikter vid identitetsmigrering.

Obs! När alla identitetskonflikter har lösts eller hanterats måste alla migreringsjobb köras innan du kan aktivera identitetstjänsten för Tableau Server. Du kan köra migreringsjobben nu genom att klicka på listrutan Redigera schema bredvid rubriken Migreringsöversikt och sedan välja Kör nu. När migreringsöversikten visar 100 % klar kan du konfigurera Tableau Server för att använda identitetstjänsten. Mer information finns i Steg 3: Slutför identitetsmigreringen.

Meddelandet ”Identitetsmigrering pågår.” visas hela tiden

Meddelandet ”Identitetsmigrering pågår” visas trots att identitetsmigreringen har slutförts eftersom identitetstjänsten inte har aktiverats ännu. För att slutföra identitetsmigreringen måste identitetstjänsten aktiveras i Steg 4: Konfigurera Tableau Server till att använda identitetstjänsten så att Tableau Server kan använda den identitetsstruktur som accepterar identitetspooler.

Sidan för identitetsmigrering försvinner

När identitetsmigreringen är slutförd och Tableau Server är konfigurerad att använda identitetstjänsten tas den dedikerade sidan för identitetsmigrering bort och är inte längre tillgänglig. Sidan Identitetsmigrering behövs endast för identitetsmigreringen eller när tsm authentication legacy-identity-mode är aktiverat.

Användare kan inte logga in

Efter att identitetsmigreringen har slutförts och identitetstjänsten har aktiverats kan vissa användare inte logga in på Tableau Server. I de flesta fall uppstår det här problemet för användare vars identiteter hade konflikter och därför bekräftades under identitetsmigreringen. Användaridentiteter som bekräftats migreras inte till identitetstjänsten och ignoreras därför i framtida synkroniseringar av Active Directory- och LDAP-grupper.

Om användare som är associerade med de här bekräftade användaridentiteterna behöver komma åt Tableau Server igen lägger du till dem manuellt i Tableau Server. Efter att användarna har lagts till manuellt kan efterföljande synkroniseringar av Active Directory- och LDAP-grupper identifiera användaridentiteterna och synkronisera som väntat.

Återställa identitetsmigrering

Om det förekommer några problem, som att vissa användare exempelvis inte kan logga in på Tableau Server, som du misstänker kan ha orsakats av identitetstjänsten, så kan du använda kommandot tsm authentication legacy-identity-mode för att återställa till användning av det äldre identitetsarkivläget. Efter återställningen kan såväl de nya användare som lades till efter identitetsmigreringen som de användare som bara kunde logga in på Tableau Server innan migreringen genomfördes utan problem logga in på Tableau Server.

När du har återställt från identitetstjänsten till det äldre identitetsarkivläget kan du använda sidan Identitetsmigrering och köra migreringen för de problematiska användaridentiteterna. Mer information om hur man hanterar identitetskonflikter finns i Lösa konflikter vid identitetsmigrering.

Tack för din feedback!Din feedback har skickats in. Tack!