Onafhankelijke gateway van Tableau Server upgraden

In dit onderwerp wordt het proces van upgraden van onafhankelijke gateway van Tableau Server beschreven. Het proces dat in dit onderwerp wordt beschreven, is voor alle versie-upgrades hetzelfde. Dit betekent dat u dit proces kunt gebruiken voor upgrades van hoofdversies (bijvoorbeeld van 2022.1 naar 2023.1) en onderhoudsversies (2022.1.1 naar 2023.1.1).

U moet een installatieprogramma voor onafhankelijke gateway van Tableau Server gebruiken met een hoofdversie die overeenkomt met de versie van Tableau Server. Wij raden aan dat onderhoudsversies (bijvoorbeeld 2022.1.1 of 2022.1.2) ook overeenkomen, maar dit is geen vereiste. Als 'statische assets' tussen versies veranderen en versies niet overeenkomen, kan dit onverwachte gevolgen hebben voor de afbeeldingen. Kaarten zijn bijvoorbeeld mogelijk niet up-to-date als onafhankelijke gateway van een eerdere versie is dan Tableau Server.

Overzicht

Het upgradeproces voor onafhankelijke gateway bestaat feitelijk uit het verwijderen en opnieuw installeren van de software. U kunt de configuratie en de algehele downtime echter minimaliseren door het proces te volgen dat in dit artikel wordt beschreven.

Bij het proces dat in dit artikel wordt beschreven, wordt ervan uitgegaan dat u over een functionele implementatie van Tableau Server en onafhankelijke gateway van Tableau Server beschikt. Als u de backend van de Tableau Server-implementatie bijwerkt als onderdeel van uw upgrade, raden wij u aan eerst de onafhankelijke gateway-server(s) bij te werken. Vervolgens valideert u de basisconnectiviteit met een Tableau-client en gaat u verder met de upgrade van Tableau Server.

De stappen die in dit onderwerp worden beschreven, worden hier samengevat:

  1. Kopieer een aantal bestaande bestanden voor gebruik tijdens de upgrade.
  2. Voer het obliterate-script uit om onafhankelijke gateway te verwijderen.
  3. Installeer een nieuwe versie van onafhankelijke gateway.
  4. Optioneel: overschrijf het tsighk-auth-bestand met het originele exemplaar.
  5. Werk de TLS-instellingen bij.
  6. Optioneel: werk de backend van Tableau Server bij.
  7. Start de onafhankelijke gateway-service opnieuw.

Stap 1: bestanden kopiëren ter referentie

Mogelijk moet u de configuratie-instellingen raadplegen die in de volgende bestanden zijn opgeslagen. Kopieer deze bestanden naar een veilige en toegankelijke locatie (bestandspaden zijn de standaardlocaties):

  • ProgramData\Tableau\tableau_tsig\config\tsighk-auth.conf
  • ProgramData\Tableau\tableau_tsig\config\httpd.conf.stub
  • ProgramData\Tableau\tableau_tsig\config\environment.bash

Stap 2: onafhankelijke gateway verwijderen

Om onafhankelijke gateway van de server(s) te verwijderen, voert u het tableau-tsig-obliterate.cmd-script uit:

  1. Open op het eerste knooppunt een opdrachtprompt als beheerder.

  2. Voer het tableau-tsig-obliterate.cmd-script uit:

    C:\Program Files\Tableau\tableau_tsig\packages\scripts.<version_code>\tableau-tsig-obliterate.cmd -y -y -y

  3. Start de computer opnieuw op.

Stap 3: onafhankelijke gateway installeren

Download de versie van onafhankelijke gateway waarnaar u wilt upgraden en volg vervolgens dezelfde installatieprocedure zoals beschreven in het artikel Tableau Server Installeren met onafhankelijke gateway.

Net als bij de oorspronkelijke installatie moet u tijdens de installatie de initialisatie-instellingen opgeven. Om dezelfde waarden te gebruiken, raadpleegt u het enviornment.bash-bestand dat u in stap 1 hebt gekopieerd. Overschrijf het nieuwe bash-bestand niet met het origineel.

Stap 4: (optioneel) tsighk-auth-bestand overschrijven met de originele kopie

Het tsighk-auth-bestand is een configuratiebestand dat een unieke tekenreeks opslaat, het verificatiegeheim. Het verificatiegeheim wordt gebruikt om te verifiëren of de backend van Tableau Server communiceert met een vertrouwde instantie van onafhankelijke gateway. Toen u de oorspronkelijke instantie van onafhankelijke gateway instelde, moest u een configuratiebestand op de backend van Tableau Server bijwerken met het verificatiegeheim.

Als uw beveiligingsbeleid dit toestaat, kunt u het originele verificatiegeheim op onafhankelijke gateway blijven gebruiken. Hiermee vermijdt u het proces van het bijwerken en opnieuw opstarten van de backend van Tableau Server met een nieuw verificatiegeheim.

Om het originele verificatiegeheim te behouden, overschrijft u het tsighk-auth.conf-bestand (bevindt zich in ProgramData\Tableau\tableau_tsig\config\tsighk-auth.conf) met de kopie die u in stap 1 hebt opgeslagen.

Als uw beveiligingsbeleid vereist dat u het verificatiegeheim vernieuwt, noteer dan het nieuwe verificatiegeheim dat tijdens het installatieproces is gegenereerd. Later in het proces werkt u de backend van Tableau Server bij met het nieuwe verificatiegeheim.

Stap 5: TLS-instellingen voor housekeeping bijwerken

Als u TLS niet hebt geconfigureerd voor housekeeping-communicatie (HK) tussen onafhankelijke gateway-instantie(s) en de backend van de Tableau Server-implementatie, kunt u deze stap overslaan.

Als u HK TLS hebt geconfigureerd, moet u de configuratie handmatig kopiëren van het oorspronkelijke httpd.conf.stub-bestand naar het bestand dat zich bevindt in ProgramData\Tableau\tableau_tsig\config\httpd.conf.stub. Overschrijf het nieuwe bestand niet met het originele bestand, omdat het nieuwere bestand andere instellingen kan bevatten.

  1. Werk de relevante TLS-configuratie-instellingen bij in het volgende blok:

    <VirtualHost *:${TSIG_HK_PORT}>
    SSLEngine on
    #TLS# SSLHonorCipherOrder on
    #TLS# SSLCompression off
    SSLCertificateFile /etc/ssl/certs/tsig-ssl.crt
    SSLCertificateKeyFile /etc/ssl/private/tsig-ssl.key
    SSLCACertificateFile /etc/ssl/certs/rootTS-CACert.pem 
    #TLS# SSLCARevocationFile /path/to/file
    </VirtualHost>

    Zie TLS configureren op onafhankelijke gateway voor meer informatie over deze instellingen.

  2. Wanneer u klaar bent met bijwerken van httpd.conf.stub, slaat u het op.

  3. Kopieer httpd.conf.stub en sla het vervolgens op om httpd.conf te overschrijven in dezelfde directory.

Stap 6: (optioneel) backend van de Tableau Server-implementatie bijwerken

Als u het originele verificatiegeheimbestand hebt gekopieerd (tsighk-auth.conf) naar de nieuwe instantie van de onafhankelijke gateway zoals beschreven in stap 4, dan kunt u deze stap overslaan.

Als u het verificatiegeheim in de backend van de Tableau Server-implementatie vernieuwt, moet u het tsig.json-bestand op het eerste knooppunt met het nieuwe verificatiegeheim bijwerken. Zie Tableau Server Installeren met onafhankelijke gateway. Wanneer u klaar bent, voert u de volgende TSM-opdrachten uit:

tsm stop
tsm topology external-services gateway update -c tsig.json
tsm start

Stap 7: de tsig-httpd-service opnieuw starten

Wanneer u klaar bent met de configuratie, start u de tsig-httpd-service opnieuw op.