Herstel na het uitvallen van een eerste knooppunt
De eerste computer waarop u Tableau installeert, het 'eerste knooppunt', heeft een aantal unieke kenmerken. Drie processen worden alleen op het eerste knooppunt uitgevoerd en kunnen niet naar een ander knooppunt worden verplaatst, behalve in geval van een storing: de Licentieservice (Licentiebeheer), de ATR-service en de TSM-controller (Beheercontroller). Tableau Server bevat een script waardoor het verplaatsen van deze processen naar een van uw andere bestaande knooppunten wordt geautomatiseerd, zodat u weer volledige toegang krijgt tot TSM, en Tableau Server draaiende kunt houden.
Twee andere processen zijn aanvankelijk opgenomen op het eerste knooppunt, maar kunnen worden toegevoegd aan of verplaatst naar extra knooppunten: de clientbestandsservice en de coördinatieservice. Afhankelijk van de manier waarop uw installatie is geconfigureerd met de clientbestandsservice en coördinatieservice moet u mogelijk ook stappen ondernemen om deze services opnieuw te implementeren.
Als een eerste knooppunt uitvalt
Als er een probleem is met het eerste knooppunt en er redundante processen op uw andere knooppunten zijn, is er geen garantie dat Tableau Server blijft werken.
- Tableau Server kan na een storing op het eerste knooppunt maximaal 72 uur blijven draaien voordat het uitvallen van de licentieservice gevolgen heeft voor andere processen. In dat het geval kunnen uw gebruikers zich misschien nog steeds aanmelden en hun inhoud bekijken en gebruiken nadat het eerste knooppunt is uitgevallen. U kunt Tableau Server echter niet opnieuw configureren, omdat u geen toegang meer hebt tot de beheercontroller.
- Als u gebruikmaakt van een versie van Tableau Server 2021.4.2 (of ouder) die is geconfigureerd voor ATR, wordt alle serverfunctionaliteit bij problemen met het eerste knooppunt onbeschikbaar. Dit geldt niet alleen als er een probleem is met het knooppunt, maar ook als u het knooppunt opzettelijk stopt (bijvoorbeeld om een patch op systeemniveau uit te voeren).
Zelfs als Tableau Server is geconfigureerd met redundante processen, is het mogelijk dat Tableau Server niet meer functioneert na het uitvallen van het eerste knooppunt. Dit geldt zelfs wanneer een installatie is geconfigureerd voor hoge beschikbaarheid. Dit betekent dat u de twee unieke processen zo snel mogelijk naar een ander actief knooppunt moet verplaatsen. Als uw eerste knooppunt uitvalt om oorzaken die in relatief korte tijd kunnen worden verholpen (bijvoorbeeld een storing in de hardware die u kunt oplossen), moet u eerst proberen het knooppunt weer te starten zonder de onderstaande procedure te gebruiken.
Opmerking: de stappen in dit artikel vereisen serverdowntime en kunnen storend zijn. Ze mogen alleen worden gebruikt in het geval van een onherstelbare fout op het eerste knooppunt. Als u het eerste knooppunt niet opnieuw kunt uitvoeren, verplaatst u belangrijke TSM-processen naar een ander knooppunt in uw cluster aan de hand van de volgende stappen.
Algemene vereisten
De 2021.1-versie van Tableau Server is bijgewerkt met verbeterde herstelfunctionaliteit. De procedure in dit onderwerp is geschreven voor Tableau Server 2021.1.
Als u probeert om een uitgevallen knooppunt uit een eerdere versie van Tableau Server te herstellen, moet u de procedure voor die versie volgen. Zie Tableau Help(Link wordt in een nieuw venster geopend) om gearchiveerde versies van Tableau Help te bekijken.
- Als onderdeel van het proces voor het opzetten van een Tableau Server-installatie met meerdere knooppunten moet u een coördinatieservice-ensemble hebben geïmplementeerd. Bij het onderstaande proces wordt ervan uitgegaan dat er een coördinatieservice-ensemble is geïmplementeerd voordat er een probleem was met het eerste knooppunt. Zie Een coördinatieservice-ensemble implementeren voor meer informatie over het implementeren van een coördinatieservice-ensemble.
- Bij dit proces wordt ervan uitgegaan dat u instanties van de clientbestandsservice hebt geconfigureerd op elk knooppunt waarop de coördinatieservice wordt uitgevoerd. Als u geen extra instanties van de clientbestandsservice hebt toegevoegd, bevond uw enige instantie zich op het eerste knooppunt en zult u minstens één instantie van de clientbestandsservice aan een ander knooppunt moeten toevoegen. U moet de clientbestandsservice ook opnieuw vullen. Voor Tableau Server is minimaal één instantie van de clientbestandsservice vereist. Zie Clientbestandsservice configureren en Tableau Server - Clientbestandsservice voor meer informatie.
Opmerking: deze bewerking omvat stappen die u mogelijk moet uitvoeren via de TSM-opdrachtregel.
De TSM-controller, licentieservice en activeringsservice naar een ander knooppunt verplaatsen
Als er een probleem is met het eerste knooppunt, moeten de TSM-controller, de licentieservice en de activeringsservice op een ander knooppunt worden gestart. Voer de volgende stappen uit om het meegeleverde script move-tsm-controller
te gebruiken en de TSM-controller, licentieservice en activeringsservice op een ander knooppunt uit te voeren.
Voer het controllerherstelscript uit op een knooppunt dat nog steeds werkt. U opent hiervoor een opdrachtprompt en navigeert naar de Tableau Server-scriptmap (Standaard:
C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\
). U typt vervolgens de volgende opdracht:move-tsm-controller -n <nodeID>
waarbij 'nodeID' de ID is van het knooppunt waarop u de TSM-controller wilt uitvoeren. Bijvoorbeeld:
move-tsm-controller -n node2
Sluit het opdrachtvenster en open het opnieuw. Controleer vervolgens of de beheercontroller op het knooppunt actief is door de volgende opdracht te typen:
tsm status -v
Stop Tableau Server.
De rest van deze procedure omvat enkele opdrachten met de optie
--ignore-node-status
. Wanneer een opdracht wordt uitgevoerd met de optie--ignore-node-status
, wordt de opdracht uitgevoerd zonder rekening te houden met de status van het opgegeven knooppunt. Als u--ignore-node-status
wilt gebruiken, geeft u het knooppunt met de storing op:tsm stop --ignore-node-status <nodeID>
Als er bijvoorbeeld een storing is op knooppunt1, voert u de opdracht als volgt uit:
tsm stop --ignore-node-status node1
Voeg de licentieservice toe aan het knooppunt:
tsm topology set-process -pr licenseservice -n <nodeID> -c 1
Verwijder de oude licentieservice van het oorspronkelijke knooppunt, waarbij 'nodeID' het eerste knooppunt is dat is uitgevallen:
tsm topology set-process -pr licenseservice -n <nodeID> -c 0
Als u een van de volgende versies gebruikt
2023.3.0 of hoger
2023.1.3 of hoger
2022.3.7 of hoger
2022.1.15 of hoger
of u een eerdere versie en ATR gebruikt, voegt u de activeringsservice toe aan het nieuwe knooppunt:
tsm topology set-process -pr activationservice -n <nodeID> -c 1
Als u een van de volgende versies of hoger gebruikt
2023.3.0 of hoger
2023.1.3 of hoger
2022.3.7 of hoger
2022.1.15 of hoger
of u een eerdere versie en ATR gebruikt. In dat geval verwijdert u de oude activeringsservice van het oorspronkelijke knooppunt, waarbij 'nodeID' het eerste knooppunt is dat is uitgevallen:
tsm topology set-process -pr activationservice -n <nodeID> -c 0
Belangrijk: Als in een cluster een knooppunt mislukt waarop uw enige exemplaar van CFS wordt uitgevoerd, gaan alle bestanden die door CFS worden beheerd verloren. U dient die bestanden in CFS opnieuw in te vullen door certificaten en aangepaste afbeeldingen opnieuw te importeren en eventuele gerelateerde configuratiewijzigingen aan te brengen. zie Tableau Server - Clientbestandsservice voor een lijst met bestanden die door de clientbestandsservice worden beheerd.
Als op het eerste knooppunt de de berichtenservice werd uitgevoerd, voegt u de berichtenservice toe aan het volgende knooppunt:
tsm topology set-process -pr activemqserver -n node2 -c 1
U kunt ook andere processen toevoegen die op het eerste knooppunt werden uitgevoerd, maar niet op dit knooppunt worden uitgevoerd (optioneel). U voegt bijvoorbeeld als volgt een cacheserver toe:
tsm topology set-process -pr cacheserver -n node2 -c 1
Pas de wijzigingen toe:
tsm pending-changes apply --ignore-node-status <nodeID>
Als voor de in behandeling zijnde wijzigingen de Server opnieuw moet worden opgestart, geeft de opdracht
pending-changes apply
een prompt weer om u te laten weten dat de server opnieuw wordt gestart. Deze prompt verschijnt ook als de server is gestopt, maar in dat geval vindt er geen herstart plaats. U kunt de prompt onderdrukken met de optie--ignore-prompt
, maar dit verandert niets aan het herstartgedrag. Als opnieuw opstarten niet nodig is voor de wijzigingen, worden de wijzigingen zonder waarschuwing van een prompt toegepast. Zie tsm pending-changes apply voor meer informatie.De TSM-beheercontroller opnieuw starten:
net stop tabadmincontroller_0
net start tabadmincontroller_0
Opmerking: u moet deze opdrachten als beheerder uitvoeren vanaf een opdrachtprompt. Afhankelijk van hoe uw computer is geconfigureerd, moet u ze mogelijk uitvoeren in de map
C:\Windows\System32
.Opmerking: het kan enkele minuten duren voordat de tabadmincontroller opnieuw is gestart. Als u in de volgende stap probeert openstaande wijzigingen toe te passen voordat de controller volledig opnieuw is gestart, kan TSM geen verbinding maken met de controller. U kunt controleren of de controller actief is met de opdracht
tsm status -v
. Er moet staan dat de Tableau Server-beheercontroller 'wordt uitgevoerd'.Pas lopende wijzigingen toe (ook al lijken die er niet te zijn, maar deze stap is vereist):
tsm pending-changes apply --ignore-node-status <nodeID>
Activeer de Tableau Server-licentie op het nieuwe knooppunt met de controller:
tsm licenses activate -k <product-key>
Controleer of de licentie correct is geactiveerd:
tsm licenses list
Als op het eerste knooppunt de coördinatieservice werd uitgevoerd, moet u een nieuw coördinatieservice-ensemble implementeren dat dat knooppunt niet bevat. Als u een cluster met drie knooppunten hebt en op het eerste knooppunt de coördinatieservice werd uitgevoerd, moet u een nieuwe instantie van het coördinatieservice-ensemble op een ander knooppunt implementeren en het oude ensemble verwijderen. In dit voorbeeld wordt een instantie van de coördinatieservice geïmplementeerd op het tweede knooppunt:
tsm topology deploy-coordination-service -n node2 --ignore-node-status node1
Als op het eerste knooppunt een instantie van het bestandsarchief werd uitgevoerd, moet u die instantie verwijderen:
tsm topology filestore decommission -n <nodeID> --delete-filestore
Waarbij
nodeID
het eerste knooppunt is dat is uitgevallen.Pas lopende wijzigingen toe met behulp van de markering
--ignore-warnings
, als het nieuwe coördinatieservice-ensemble dat u hierboven hebt geïmplementeerd een ensemble met één knooppunt is:tsm pending-changes apply --ignore-node-status node1 --ignore-warnings
Verwijder het eerste knooppunt, waarbij
nodeID
het eerste knooppunt is dat is uitgevallen:tsm topology remove-nodes -n <nodeID>
Pas lopende wijzigingen toe met behulp van de markering
--ignore-warnings
, als het nieuwe coördinatieservice-ensemble dat u hierboven hebt geïmplementeerd een ensemble met één knooppunt is:tsm pending-changes apply --ignore-warnings
Start Tableau Server:
tsm start
Op dit punt zou uw server moeten opstarten en kunt u deze met TSM configureren. De volgende stap is het vervangen van uw eerste knooppunt, zodat uw cluster hetzelfde aantal knooppunten heeft. Hoe u dit doet, hangt ervan af of u het knooppunt dat is uitgevallen opnieuw wilt gebruiken. We raden u aan om dat knooppunt alleen opnieuw te gebruiken als u de reden van de storing kunt achterhalen en stappen onderneemt om te voorkomen dat de storing zich opnieuw voordoet.
Als u van plan bent het oorspronkelijke knooppunt opnieuw te gebruiken, moet u Tableau er eerst volledig van verwijderen. U doet dit door het script
tableau-server-obliterate
uit te voeren. Zie Tableau Server van de computer verwijderen om te lezen hoe u dit doet.Installeer Tableau op een nieuwe computer of op uw oorspronkelijke computer nadat u Tableau volledig hebt verwijderd. U doet dit met behulp van uw oorspronkelijke installatieprogramma en een bootstrap-bestand dat is gegenereerd vanaf het knooppunt waarop nu de beheercontroller en de licentieservice worden uitgevoerd. Hierdoor wordt een extra knooppunt gemaakt dat u kunt configureren als onderdeel van uw cluster. Zie Extra knooppunten installeren en configureren voor meer informatie over het toevoegen van het knooppunt.
U kunt het beste alle processen configureren die u bent kwijtgeraakt toen het oorspronkelijke knooppunt uitviel. Op die manier zorgt u ervoor dat uw cluster volledig redundant is. U kunt processen van uw nieuwe eerste knooppunt naar het onlangs toegevoegde extra knooppunt verplaatsen om uw oorspronkelijke configuratie te dupliceren. Als er op uw eerste knooppunt bijvoorbeeld alleen een gateway en het bestandsarchief werden uitgevoerd, wilt u het nieuwe eerste knooppunt mogelijk op dezelfde manier configureren.
U moet ook opnieuw een nieuw coördinatieservice-ensemble implementeren, wanneer uw knooppunten eenmaal naar wens werken. Zie Een coördinatieservice-ensemble implementeren voor meer informatie.
Als u dit nog niet hebt gedaan, voegt u ten slotte een instantie van de clientbestandsservice toe aan elk knooppunt waarop de coördinatieservice wordt uitgevoerd. Zie Clientbestandsservice configureren voor meer informatieClientbestandsservice configureren
Zie Tableau Server - Clientbestandsservice Als in een cluster een knooppunt mislukt waarop uw enige exemplaar van CFS wordt uitgevoerd, gaan alle bestanden die door CFS worden beheerd verloren. U dient die bestanden in CFS opnieuw in te vullen door certificaten en aangepaste afbeeldingen opnieuw te importeren en eventuele gerelateerde configuratiewijzigingen aan te brengen.voor een lijst met bestanden die door CFS worden beheerd.