Uppgradera oberoende gateway för Tableau Server

Detta ämne leder dig genom processen att uppdatera oberoende gateway för Tableau Server. Processen som beskrivs i det här avsnittet är densamma för alla versionsuppgraderingar. Det betyder att du kan använda den här processen för uppgraderingar av större versioner (till exempel 2022.1 till 2023.1) och underhållsversioner (2022.1.1 till 2023.1.1).

Du måste använda ett installationsprogram för oberoende gateway för Tableau Server med en större version som matchar versionen av Tableau Server. Vi rekommenderar att även underhållsversioner (till exempel 2022.1.1 eller 2022.1.2) matchar, men det är inget krav. Om statiska tillgångar ändras mellan versioner och versionerna inte matchar så kan du uppleva oväntade bildkonsekvenser. Kartor kanske till exempel inte är uppdaterade om oberoende gateway är av en tidigare version än Tableau Server.-

Översikt

Uppgraderingsprocessen för oberoende gateway är faktiskt en process för att avinstallera och sedan installera om programvaran. Du kan dock minimera konfigurationen och den totala stilleståndstiden genom att följa processen som beskrivs i det här avsnittet.

Processen som beskrivs i det här avsnittet förutsätter att du har en funktionell distribution av Tableau Server och att oberoende gateway för Tableau Server körs. Om du uppgraderar distributionen av serverdelen av Tableau Server som en del av uppgraderingen rekommenderar vi att du först uppgraderar servrarna för oberoende gateway, validerar grundläggande anslutning till en Tableau-klient och sedan fortsätter med uppgraderingen av Tableau Server.

Stegen som beskrivs i detta ämne sammanfattas här:

  1. Kopiera några befintliga filer för användning under uppgraderingen.
  2. Kör Obliterate-skriptet för att ta bort oberoende gateway.
  3. Installera ny version av oberoende gateway.
  4. Valfritt: Skriv över tsighk-auth-fil med originalkopia.
  5. Uppdatera TLS-inställningar.
  6. Valfritt: Uppdatera serverdelen av Tableau Server
  7. Starta om oberoende gateway-tjänsten.

Steg 1: Kopiera filer för referens

Du kan behöva referera till konfigurationsinställningarna som är lagrade i följande filer. Kopiera dessa filer till en säker och tillgänglig plats (filsökvägar är standardplatsen):

  • /var/opt/tableau/tableau_tsig/config/tsighk-auth.conf
  • /var/opt/tableau/tableau_tsig/config/httpd.conf.stub
  • /etc/opt/tableau/tableau_tsig/environment.bash

Steg 2: Radera oberoende gateway

Om du vill radera oberoende gateway från servrarna kör du skriptet tableau-tsig-obliterate:

  1. Öppna en terminalsession på den initiala noden.

  2. Kör skriptet tableau-tsig-obliterate:

    sudo /opt/tableau/tableau_tsig/packages/scripts.<version_code>/tableau-tsig-obliterate -y -y -y

  3. Starta om datorn.

Steg 3: Installera oberoende gateway

Ladda ner versionen av oberoende gateway som du vill uppgradera till och följ sedan samma installationsprocedur som beskrivs i avsnittet Installera Tableau Server med oberoende gateway.

Precis som med den ursprungliga installationen måste du ange initialiseringsinställningar som en del av installationen. För att använda samma värden refererar du till den enviornment.bash-fil som du kopierade i steg 1. Skriv inte över den nya bash-filen med originalet.

Steg 4: (Valfritt) Skriv över tsighk-auth-fil med originalkopia

tsighk-auth-filen är en konfigurationsfil som lagrar en unik sträng som kallas authsecret. Authsecret används för att verifiera att serverdelen av Tableau Server kommunicerar med en betrodd instans av oberoende gateway. När du konfigurerade den ursprungliga instansen av oberoende gateway var du tvungen att uppdatera en konfigurationsfil på serverdelen av Tableau Server med authsecret.

Om din säkerhetspolicy tillåter det kan du fortsätta att använda den ursprungliga authsecret på oberoende gateway. Om du gör det undviker du processen med att uppdatera och starta om serverdelen av Tableau Server med en ny authsecret.

För att behålla den ursprungliga authsecret skriver du över tsighk-auth.conf-filen (finns på /var/opt/tableau/tableau_tsig/config/tsighk-auth.conf) med kopian som du sparade i steg 1.

Om din säkerhetspolicy kräver att du uppdaterar authsecret, notera då den nya authsecret som genererades av installationsprocessen. Du uppdaterar serverdelen av Tableau Server med den nya authsecret senare i processen.

Steg 5: Uppdatera TLS-inställningar för rensning

Om du inte konfigurerade TLS för rensing-kommunikation (HK) mellan instanser av oberoende gatewayer och serverdelen av Tableau Server, kan du hoppa över det här steget.

Om du konfigurerade HK TLS måste du manuellt kopiera konfigurationen från originalfilen httpd.conf.stub till filen som finns på /var/opt/tableau/tableau_tsig/config/httpd.conf.stub). Skriv inte över den nya filen med originalfilen, eftersom den nyare filen kan innehålla andra inställningar.

  1. Uppdatera relevanta TLS-konfigurationsinställningar i följande block:

    <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>

    Mer information om dessa inställningar finns i Konfigurera TLS på oberoende gateway.

  2. När du är klar med uppdateringen av httpd.conf.stub sparar du den.

  3. Kopiera httpd.conf.stub och spara sedan för att skriva över httpd.conf i samma katalog.

Steg 6: (Valfritt) Uppdatera serverdelen av Tableau Server-distributionen

Om du kopierade den ursprungliga authsecret-filen (tsighk-auth.conf) till den nya instansen av oberoende gateway som beskrivs i steg 4, kan du hoppa över det här steget.

Om du uppdaterar authsecret i serverdelen av Tableau Server-distributionen måste du uppdatera tsig.json-filen på den ursprungliga noden med den nya authsecret. Se Installera Tableau Server med oberoende gateway. När du är klar kör följande TSM-kommandon:

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

Steg 7: Starta om tsig-httpd-tjänsten

När du är klar med konfigurationen startar du om tsig-httpd-tjänsten.

sudo su - tableau-tsig
systemctl --user restart tsig-httpd
exit