Version: tillagt i version 2026.3.0.

Från och med version 2026.3.0 av Tableau Server kan serveradministratörer ersätta de självsignerade certifikat som används av Tableau Server med anpassade certifikat.Om du har konfigurerat Tableau Server för att använda anpassade certifikat och sedan får problem med samordningstjänsten (till exempel på grund av ett utgånget certifikat, en felmatchad nyckel eller en kundlevererad kedja som inte längre valideras) behöver du vidta särskilda åtgärder för att lösa problemet utan att installera om Tableau Server och återställa en befintlig säkerhetskopia.Mer information om hur du använder anpassade certifikat för kommunikation mellan interna tjänster finns i Konfigurera interna anpassade certifikat för Tableau Server.

Använd det nodspecifika verktyget recover-coordination-service-cert för att ersätta mTLS-certifikatet och nyckelmaterialet för samordningstjänsten (ZooKeeper) direkt på disken.Du måste använda samma server- och klientcertifikat/nyckelpar på varje nod.

Förutsättningar

• Du måste köra verktyget på en befintlig Tableau Server-nod, som root eller som Tableaus Kör som användare utan behörigheter.

• Du måste ha ett servercertifikat/nyckelpar och ett klientcertifikat/nyckelpar redo.Valfria kedjefiler och lösenfraser för krypterade nycklar stöds.

Återställa det anpassade certifikatet

1. Om du inte redan har ett certifikat genererar du ett nytt självsignerat par en gång, på en enda nod, och kopierar de identiska filerna till varje nod.Paret ska spegla det som TSM genererar internt (EC P-256, självsignerat, CN=*):

   openssl req -x509 -newkey ec -pkeyopt ec_paramgen_curve:prime256v1 -days 1825 -nodes -subj "/CN=*" -keyout server.key -out server.crt

   openssl req -x509 -newkey ec -pkeyopt ec_paramgen_curve:prime256v1 -days 1825 -nodes -subj "/CN=*" -keyout client.key -out client.crt

   Om du vill skapa en lösenfraskrypterad nyckel utelämnar du -nodes.OpenSSL frågar efter en lösenfras, som du sedan skickar med det matchande alternativet --server-passphrase eller --client-passphrase.

2. Kör återställningsverktyget på den första noden.Börja med en nod som är värd för samordningstjänsten så att kvorum kan återskapas:

   recover-coordination-service-cert --server-cert server.crt --server-key server.key --client-cert client.crt --client-key client.key [--server-chain <file.crt>] [--client-chain <file.crt>] [--server-passphrase <passphrase>] [--client-passphrase <passphrase>]

   Verktyget förhandsvaliderar indata innan det stoppar något: det bekräftar att certifikatet kan tolkas som X.509, att en eventuell angiven lösenfras dekrypterar nyckeln och att det första certifikatet i en eventuell angiven kedja är lövcertifikatets utfärdare.Verktyget stoppar sedan de lokala tjänsterna, korrigerar varje tjänsts konfiguration och nyckelarkiv samt startar om kontrollplanet (ZooKeeper först, sedan administrationsagenten och därefter resten).

3. Kör exakt samma kommando på alla återstående noder med identiska certifikat och nyckelfiler.Återställ först de noder som är värdar för samordningstjänsten och återställ sedan eventuella kvarvarande noder.Klustret återställs inte förrän verktyget har körts på alla noder – noder som fortfarande har det gamla nyckelarkivet återansluter inte.

   Obs! I detta skede visar tsm status affärstjänster med felstatus.Detta är som förväntat.Verktyget korrigerar tjänsterna, men lämnar dem stoppade.Kommandot set i nästa steg startar dem.

4. När alla noder är klara kör du följande set-kommando en gång från styrenheten eller den första noden för att synkronisera samordningstjänstens beständiga konfiguration med det som nu finns på disken:

   tsm security coordination-service-internal-cert set --server-cert server.crt --server-key server.key --client-cert client.crt --client-key client.key [--server-chain <file.crt>] [--client-chain <file.crt>] [--server-passphrase <passphrase>] [--client-passphrase <passphrase>]

   Återställningsverktyget skriver ut det här kommandot åt dig, redan ifyllt med de sökvägar du angett.Verktyget påminner dig om att lägga till lösenfrasalternativen igen, men visar aldrig lösenfrasvärdet.Kommandots genväg vid identiska certifikat synkroniserar konfigurationen och startar upp hela klustret igen, inklusive de stoppade affärstjänsterna, vilket rensar felstatusen.

Felsökning: Varje körning skriver en strukturerad loggfil till ${TABLEAU_SERVER_DATA_DIR}/logs/app-recover-coordination-service-cert.log.

Obs! I Windows finns det en motsvarande omslutning, recover-coordination-service-cert.cmd, som tar samma alternativ och fungerar på samma sätt.