Återställa från ett fel på den ursprungliga noden

Den första datorn som du installerar Tableau på, den ”ursprungliga noden”, har vissa unika egenskaper. Det finns tre processer som bara körs på den ursprungliga noden och som inte kan flyttas till en annan nod förutom i händelse av ett fel: Licenstjänst (Licenshanteraren), Aktiveringstjänst och TSM-styrenhet (Administrationsstyrenhet). Tableau Server innehåller ett skript som automatiserar flytten av de här processerna till en av de andra noderna, så att du kan få fullkomlig tillgång till TSM igen och hålla Tableau Server igång.

Två andra processer ingår inledningsvis på den initiala noden, men kan läggas till på eller flyttas till andra noder: klientfiltjänsten (CFS) och samordningstjänsten. Beroende på hur installationen har konfigurerats med klientfiltjänsten och samordningstjänsten kan du behöva distribuera dessa igen.

Om den ursprungliga noden får problem

Om det uppstår ett problem med den ursprungliga noden och du har redundanta processer på dina övriga noder så finns det inga garantier att Tableau Server kommer att fortsätta fungera.

  • Tableau Server kan fortsätta att fungera i upp till 72 timmar efter ett fel på en ursprunglig nod innan bristen på licensieringstjänst påverkar andra processer. I sådant fall kan det hända att användarna kan fortsätta att logga in samt se och använda sitt innehåll efter det att den ursprungliga noden misslyckas, men du kommer inte att kunna omkonfigurera Tableau Server eftersom du inte kommer att ha åtkomst till administrationsstyrenheten.
  • Om en version av Tableau Server 2021.4.2 (eller äldre) körs och den är konfigurerad för ATR gör problem med den första noden att all serverfunktionalitet blir otillgänglig. Detta gäller vare sig noden har ett problem eller du avsiktligen stoppar den (till exempel för att utföra en korrigering på systemnivå).

Även när Tableau Server har konfigurerats med redundanta processer är det möjligt att den inte fortsätter att fungera efter att den ursprungliga noden misslyckas. Det gäller även när en installation konfigurerats för hög tillgänglighet. Det innebär att du bör flytta de två unika processerna till en annan av dina noder som körs så snart som möjligt. Om din ursprungliga nod skulle misslyckas av skäl som går att återhämta sig från på en relativt kort tid (till exempel ett maskinvarufel som du kan korrigera) så bör du först försöka få igång noden igen utan att använda proceduren nedan.

Obs! Stegen i denna artikel kräver nedtid för servern och kan vara störande. De bör endast användas vid ett katastrofalt fel hos den ursprungliga noden. Om du inte kan få igång din ursprungliga nod igen, använder du följande steg för att flytta viktiga TSM-processer till en annan nod i ditt kluster.

Allmänna krav

Version 2021.1 av Tableau Server har uppdaterats med förbättrade återställningsfunktioner. Proceduren för detta ämne har skrivits för Tableau Server 2021.1.

Om du försöker återställa en tidigare version av Tableau Server, måste du följa proceduren för versionen i fråga. Visa arkiverade versioner av Tableaus hjälp genom att gå till Tableau hjälp(Länken öppnas i ett nytt fönster).

  • Som en del av processen för att konfigurera en distribuerad Tableau Server-installation med flera noder bör du ha installerat en samordningstjänstensemble. Processen nedan förutsätter att en samordningsensemble har driftsatts innan det uppstod ett problem med den ursprungliga noden. Mer information om hur du driftsätter en samordningstjänstensemble finns i Driftsätta en ensemble för samordningstjänst.
  • Denna process förutsätter att du har konfigurerat instanser av klientfiltjänsten (CFS) på varje nod som kör samordningstjänsten. Om du inte lagt till ytterligare instanser av CFS fanns din enda instans på den ursprungliga noden, och du måste lägga till minst en instans av CFS i en annan nod. Du behöver också fylla i CFS på nytt. Tableau Server måste ha minst en instans av CFS. Mer information finns i Konfigurera klientfiltjänsten och Klientfiltjänst (CFS) för Tableau Server.

Obs! Den här åtgärden inkluderar steg som du kan behöva utföra med TSM-kommandoraden.

Flytta TSM-styrenheten, licenstjänsten och aktiveringstjänsten till en annan nod

Om det finns ett problem med den ursprungliga noden måste TSM-styrenheten, licensieringstjänsten och aktiveringstjänsten startas på en annan nod. Följ dessa steg för att använda det medföljande skriptet move-tsm-controller och få TSM-styrenheten, licensieringstjänsten och aktiveringstjänsten att arbeta på en annan nod.

  1. Kör Controller-återställningsskriptet på en nod som fortfarande fungerar. Skriv in följande kommando vid en terminaltolk på en fungerande nod:

    sudo /opt/tableau/tableau_server/packages/scripts.<version_code>/move-tsm-controller -n <nodeID>

    där ”node ID” är ID för den nod som du vill att TSM-styrenheten ska köras på. Till exempel:

    sudo /opt/tableau/tableau_server/packages/scripts.10400.17.0802.1319/move-tsm-controller -n node2

  2. Kontrollera att administrationsstyrenheten körs på noden:

    tsm status -v

  3. Stoppa Tableau Server.

    I resten av den här proceduren används vissa kommandon med alternativet --ignore-node-status. När ett kommando körs med alternativet --ignore-node-status körs kommandot utan att ta hänsyn till den angivna nodens status. Om du vill använda --ignore-node-status anger du noden som har problem:

    tsm stop --ignore-node-status <nodeID>

    Om exempelvis nod1 har slutat fungera kör du följande kommando:

    tsm stop --ignore-node-status node1

  4. Lägg till licenstjänsten i noden:

    tsm topology set-process -pr licenseservice -n <nodeID> -c 1

  5. Ta bort den gamla licenstjänsten från den ursprungliga noden, där ”node ID” är den ursprungliga nod som har misslyckats:

    tsm topology set-process -pr licenseservice -n <nodeID> -c 0

  6. Om du kör en av följande versioner

    • 2023.3.0 eller senare

    • 2023.1.3 eller senare

    • 2022.3.7 eller senare

    • 2022.1.15 eller senare

    eller du kör en tidigare version och använder ATR, lägg till aktiveringstjänsten till den nya noden:

    tsm topology set-process -pr activationservice -n <nodeID> -c 1

  7. Om du kör en av dessa versioner eller senare

    • 2023.3.0 eller senare

    • 2023.1.3 eller senare

    • 2022.3.7 eller senare

    • 2022.1.15 eller senare

    eller om du kör en tidigare version och använder ATR tar du bort den gamla aktiveringstjänsten från den ursprungliga noden, där ”nodeID” är den ursprungliga nod som har misslyckats:

    tsm topology set-process -pr activationservice -n <nodeID> -c 0

    Viktigt: Om en nod, i ett kluster, kör din enda instans av CFS och misslyckas, förloras alla filer som hanteras av CFS. Du måste då fylla på CFS för dessa filer genom att importera certifikat och anpassade bilder på nytt samt göra eventuella relaterade konfigurationsändringar.En lista över filer som hanteras av klientfiltjänsten (CFS) finns i Klientfiltjänst (CFS) för Tableau Server.

  8. Om den ursprungliga noden hade kört den meddelandetjänsten lägger du till meddelandetjänsten i denna nod:

    tsm topology set-process -pr activemqserver -n node2 -c 1

  9. (Valfritt) Du kan också lägga till andra processer som har körts på den ursprungliga noden, men som inte körs på denna nod. Om du till exempel vill lägga till en cacheserver:

    tsm topology set-process -pr cacheserver -n node2 -c 1

  10. Använd ändringarna:

    tsm pending-changes apply --ignore-node-status <nodeID>

    Om de väntande ändringarna kräver att servern startas om visar kommandot pending-changes apply en kommandotolk så att du vet att en omstart kommer att ske. Kommandotolken visas även om servern stoppas, men i så fall sker ingen omstart. Du kan utelämna tolken med alternativet --ignore-prompt, men det påverkar inte omstartsbeteendet. Om ändringarna inte kräver omstart används de utan någon kommandotolk. Du hittar mer information i tsm pending-changes apply.

  11. Starta om TSM- administrationsstyrenheten (med systemkontot för tableau):

    sudo su -l tableau -c "systemctl --user restart tabadmincontroller_0.service"

    Obs! Det kan ta några minuter för tabadmincontroller att starta om. Om du försöker tillämpa väntande ändringar i nästa steg innan styrenheten har startats om helt och hållet, kan TSM inte ansluta till styrenheten. Du kan verifiera att styrenheten körs med kommandot tsm status -v. Tableau Server-administrationsstyrenheten ska anges som ”körs”.

  12. Tillämpa väntande ändringar (det kanske inte verkar finnas några, men det här steget är ändå nödvändigt):

    tsm pending-changes apply --ignore-node-status <nodeID>

  13. Aktivera Tableau Server-licensen på den nya styrenhetsnoden:

    tsm licenses activate -k <product-key>

  14. Kontrollera att licensen är korrekt aktiverad:

    tsm licenses list

  15. Om den ursprungliga noden körde samordningstjänsten måste du driftsätta en ny samordningstjänstensemble som inte inkluderar den noden. Om du har ett kluster med tre noder och den ursprungliga noden körde samordningstjänsten, måste du driftsätta en ny samordningstjänstensemble med en enda instans på en annan nod och rensa upp den gamla ensemblen. I detta exempel driftsätts en enskild instans av samordningstjänsten med den andra noden:

    tsm topology deploy-coordination-service -n node2 --ignore-node-status node1

  16. Om den ursprungliga noden körde en instans för Fillagring måste du ta bort den instansen:

    tsm topology filestore decommission -n <nodeID> --delete-filestore

    Där nodeID är den ursprungliga nod som har misslyckats.

  17. Tillämpa väntande ändringar och använd flaggan --ignore-warnings om den nya samordningstjänstensemblen som du driftsatt ovan bara har en nod:

    tsm pending-changes apply --ignore-node-status node1 --ignore-warnings

  18. Ta bort den ursprungliga noden, där nodeID är den ursprungliga nod som har misslyckats:

    tsm topology remove-nodes -n <nodeID>

  19. Tillämpa väntande ändringar och använd flaggan --ignore-warnings om den nya samordningstjänstensemblen som du driftsatt ovan bara har en nod:

    tsm pending-changes apply --ignore-warnings

  20. Starta Tableau Server:

    tsm start

    Vid denna tidpunkt bör din server starta och du kan använda TSM för att konfigurera den. Nästa steg är att byta ut din ursprungliga nod, så att klustret har det ursprungliga antalet noder. Hur du gör detta beror på om du vill återanvända den nod som misslyckats eller inte. Vi rekommenderar att du bara använder noden igen om du identifierat orsaken till att den misslyckades, och vidtagit åtgärder för att förhindra att felet upprepas.

  21. Du måste först ta bort Tableau helt från den ursprungliga noden, om du planerar att använda den igen. Gör detta genom att köra skriptet tableau-server-obliterate. Du hittar mer information om detta i Ta bort Tableau Server från datorn.

  22. Installera Tableau med det ursprungliga installationsprogrammet och en startfil som genererats från noden som nu kör administrationsstyrenheten och licensieringstjänsten på en ny dator, eller på den ursprungliga datorn efter att tagit bort Tableau helt. Detta skapar ytterligare en nod som du kan konfigurera som en del av klustret. Du hittar mer information om hur du lägger till noden i Installera och konfigurera ytterligare noder.

    Som bästa praxis bör du konfigurera eventuella processer som gick förlorade när den ursprungliga noden slutade fungera, för att vara säker på att klustret är helt redundant. Du kanske vill flytta processer från den nya ursprungliga noden till den nytillagda ytterligare noden, för att duplicera din ursprungliga konfiguration. Om den ursprungliga noden till exempel endast körde gateway och fillagring kanske du vill konfigurera den nya ursprungliga noden på samma sätt.

  23. Du bör också driftsätta en ny samordningstjänstensemble när noderna körs och fungerar som de ska igen. Mer information finns i Driftsätta en ensemble för samordningstjänst.

  24. Till sist, om du inte redan gjort det, lägger du till en instans av klientfiltjänsten (CFS) på alla noder där samordningstjänsten körs. Mer information finns i Konfigurera klientfiltjänsten

    Om en nod, i ett kluster, kör din enda instans av CFS och misslyckas, förloras alla filer som hanteras av CFS. Du måste då fylla på CFS för dessa filer genom att importera certifikat och anpassade bilder på nytt samt göra eventuella relaterade konfigurationsändringar.En lista med filer som hanteras av klientfiltjänsten (CFS) finns i Klientfiltjänst (CFS) för Tableau Server.

 

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