Aktualisieren von Tableau Server Independent Gateway

Dieses Thema führt Sie durch den Prozess der Aktualisierung von Tableau Server Independent Gateway. Der in diesem Thema beschriebene Prozess ist für alle Versionsupgrades gleich. Dies bedeutet, dass Sie diesen Prozess für Upgrades von Hauptversionen (z. B. 2022.1 auf 2023.1) und Nebenversionen (2022.1.1 auf 2023.1.1) verwenden können.

Sie müssen ein Installationsprogramm für Tableau Server Independent Gateway mit einer Hauptversion verwenden, die mit der Version von Tableau Server übereinstimmt. Wir empfehlen, dass auch die Nebenversionen (z. B. 2022.1.1 oder 2022.1.2) übereinstimmen, dies ist jedoch keine Voraussetzung. Wenn sich "statische Assets" zwischen Versionen ändern und Versionen nicht übereinstimmen, kann es zu unerwarteten Auswirkungen auf die bildliche Darstellung kommen. So sind zum Beispiel Karten möglicherweise nicht auf dem aktuellen Stand, wenn Independent Gateway eine frühere Version als Tableau Server ist.

Übersicht

Der Upgrade-Prozess für Independent Gateway ist genaugenommen ein Prozess, bei dem die Software deinstalliert und dann neu installiert wird. Sie können jedoch die Konfigurations- und Gesamtausfallzeit minimieren, indem Sie dem in diesem Thema beschriebenen Prozess folgen.

Der in diesem Thema beschriebene Prozess geht davon aus, dass Sie über eine funktionierende Bereitstellung von Tableau Server und Tableau Server Independent Gateway verfügen. Wenn Sie die Back-End-Bereitstellung von Tableau Server als Teil Ihres Upgrades aktualisieren, empfehlen wir, zuerst den/die unabhängigen Gateway-Server zu aktualisieren, die grundlegende Konnektivität mit einem Tableau-Client zu validieren und dann mit dem Tableau Server-Upgrade fortzufahren.

Die in diesem Thema beschriebenen Schritte sind hier zusammengefasst:

  1. Kopieren Sie einige vorhandene Dateien zur Verwendung während des Upgrades.
  2. Führen Sie das Obliterate-Skript aus, um Independent Gateway zu entfernen.
  3. Installieren Sie die neue Version von Independent Gateway.
  4. Optional: Überschreiben Sie die Datei tsighk-auth mit der Originalkopie.
  5. Aktualisieren Sie die TLS-Einstellungen.
  6. Optional: Aktualisieren Sie das Back-End von Tableau Server
  7. Starten Sie den Independent Gateway-Dienst neu.

Schritt 1: Dateien als Referenz kopieren

Möglicherweise müssen Sie auf die in den folgenden Dateien gespeicherten Konfigurationseinstellungen verweisen. Kopieren Sie die folgenden Dateien an einen sicheren und zugänglichen Speicherort (Dateipfade sind Standardspeicherorte):

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

Schritt 2: Independent Gateway löschen

Um Independent Gateway von den Servern zu entfernen, führen Sie das Skript tableau-tsig-obliterate.cmd aus:

  1. Öffnen Sie auf dem ersten Knoten als Administrator eine Eingabeaufforderung.

  2. Führen Sie das Skript tableau-tsig-obliterate.cmd aus:

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

  3. Starten Sie den Computer neu.

Schritt 3: Independent Gateway installieren

Laden Sie die Version von Independent Gateway herunter, auf die Sie aktualisieren möchten, und befolgen Sie dann dasselbe Installationsverfahren wie im Thema Installieren von Tableau Server mit Independent Gateway beschrieben.

Wie bei der ursprünglichen Installation müssen Sie im Rahmen der Einrichtung Initialisierungseinstellungen angeben. Um dieselben Werte zu verwenden, verweisen Sie auf die Datei enviornment.bash, die Sie in Schritt 1 kopiert haben. Überschreiben Sie die neue Bash-Datei nicht mit dem Original.

Schritt 4: (Optional) Überschreiben der Datei tsighk-auth mit der Originalkopie

Die Datei tsighk-auth ist eine Konfigurationsdatei, die eine eindeutige Zeichenfolge namens authsecret (Authentifizierungsgeheimnis) speichert. Das Authentifizierungsgeheimnis wird verwendet, um zu überprüfen, ob das Back-End von Tableau Server mit einer vertrauenswürdigen Instanz von Independent Gateway kommuniziert. Als Sie die ursprüngliche Instanz von Independent Gateway eingerichtet haben, mussten Sie eine Konfigurationsdatei auf dem Back-End von Tableau Server mit dem Authentifizierungsgeheimnis aktualisieren.

Wenn Ihre Sicherheitsrichtlinie dies zulässt, können Sie weiterhin das ursprüngliche Authentifizierungsgeheimnis auf Independent Gateway verwenden. Dadurch wird das Aktualisieren und Neustarten des Back-Ends von Tableau Server mit einem neuen Authentifizierungsgeheimnis vermieden.

Um das ursprüngliche Authentifizierungsgeheimnis beizubehalten, überschreiben Sie die Datei tsighk-auth.conf (befindet sich unter ProgramData\Tableau\tableau_tsig\config\tsighk-auth.conf) mit der Kopie, die Sie in Schritt 1 gespeichert haben.

Wenn Ihre Sicherheitsrichtlinie erfordert, dass Sie das Authentifizierungsgeheimnis aktualisieren, notieren Sie sich das neue Authentifizierungsgeheimnis, das durch den Installationsprozess generiert wurde. Sie werden das Back-End von Tableau Server später im Prozess mit dem neuen Authentifizierungsgeheimnis aktualisieren.

Schritt 5: Aktualisieren der Housekeeping-TLS-Einstellungen

Wenn Sie TLS nicht für die Housekeeping-Kommunikation (HK) zwischen Independent Gateway-Instanz(en) und der Bereitstellung des Back-Ends von Tableau Server konfiguriert haben, können Sie diesen Schritt überspringen.

Wenn Sie HK TLS konfiguriert haben, müssen Sie die Konfiguration manuell von der Originaldatei httpd.conf.stub in die Datei kopieren, die sich unter ProgramData\Tableau\tableau_tsig\config\httpd.conf.stub) befindet. Überschreiben Sie die neue Datei nicht mit der Originaldatei, da die neuere Datei möglicherweise andere Einstellungen enthält.

  1. Aktualisieren Sie die relevanten TLS-Konfigurationseinstellungen im folgenden 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>

    Weitere Informationen zu diesen Einstellungen finden Sie unter Konfigurieren von TLS auf dem Independent Gateway .

  2. Wenn Sie die Aktualisierung von httpd.conf.stub , abgeschlossen haben, speichern Sie die Datei.

  3. Kopieren Sie die Datei httpd.conf.stub und speichern Sie sie dann zum Überschreiben von httpd.conf im selben Verzeichnis.

Schritt 6: (Optional) Aktualisieren der Bereitstellung des Back-Ends von Tableau Server

Wenn Sie, wie in Schritt 4 beschrieben, die ursprüngliche Authsecret-Datei (tsighk-auth.conf) in die neue Instanz von Independent Gateway kopiert haben, dann können Sie diesen Schritt überspringen.

Wenn Sie das Authentifizierungsgeheimnis in der Bereitstellung des Back-Ends von Tableau Server aktualisieren, müssen Sie die Datei tsig.json auf dem Ausgangsknoten mit dem neuen Authentifizierungsgeheimnis aktualisieren. Siehe Installieren von Tableau Server mit Independent Gateway Führen Sie die folgenden TSM-Befehle aus, wenn Sie fertig sind:

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

Schritt 7: Neustart des tsig-httpd-Dienstes

Wenn Sie mit der Konfiguration fertig sind, starten Sie den tsig-httpd-Dienst neu.

Vielen Dank für Ihr Feedback!Ihr Feedback wurde erfolgreich übermittelt. Vielen Dank.