Installieren von Tableau Server mit Independent Gateway

Anwendungsbereich: Tableau Advanced Management

Dieses Thema führt Sie durch den Installationsprozess von Tableau Server Independent Gateway.

Die Durchführung dieses Prozesses führt zu einer Independent Gateway-Konfiguration mit einer direkten Verbindung zu der Back-End-Tableau Server-Bereitstellung. Weitere Informationen zum Unterschied zwischen einer direkten und einer Relay-Verbindung finden Sie im Thema Konfigurieren von Tableau Server mit Independent Gateway.

Voraussetzungen

Sie müssen über einen dedizierten Server mit mindestens 2 Kernen (4 vCPUs), 8 GB RAM und 100 GB freiem Festplattenspeicher verfügen.
Sie müssen Tableau Server 2022.1 oder höher verwenden.
Sie müssen ein Installationsprogramm für Tableau Server Independent Gateway mit einer Hauptversion (z. B. 2022.1) verwenden, die mit der Version von Tableau Server übereinstimmt. Wir empfehlen, dass auch die Nebenversionen (z. B. 2022.1.1 oder 2022.1.5) ü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.
Advanced Management muss in Tableau Server aktiviert sein. Weitere Informationen zu Advanced Management finden Sie unter Über Tableau Advanced Management in Tableau Server.
Das Independent Gateway muss während der Installation mit der Backend-Tableau Server-Bereitstellung in der Standardeinstellung über die Ports 80 und 21319 kommunizieren können. Sie können diese Standardports während der Initialisierung ändern, wie weiter unten in diesem Thema beschrieben wird.
Vergewissern Sie sich, dass Ihre Tableau Server-Bereitstellung vollständig und fehlerfrei ist, bevor Sie Independent Gateway installieren und konfigurieren.
Vergewissern Sie sich, dass auf dem Computer, auf dem Sie Independent Gateway installieren möchten, keine anderen Anwendungen ausgeführt werden, die mit dem Internet kommunizieren. Wenn beispielsweise "Apache httpd" auf dem Computer installiert ist, deinstallieren Sie es oder konfigurieren Sie httpd so, dass dieser nicht aktiv den Port 80 abhört.

Installieren von Tableau Server und Independent Gateway

Die Installation von Independent Gateway erfolgt mithilfe eines eigenständigen Installationsprogramms, das "tsig" als Teil des Dateinamens enthält, um es vom vollständigen Tableau Server-Installationsprogramm zu unterscheiden. Wir empfehlen Ihnen dringend, Independent Gateway zu installieren, nachdem Sie Tableau Server installiert und sich überzeugt haben, dass es wie erwartet funktioniert. Zur Installation müssen Sie und der Root-Benutzer sein (oder in der Lage sein, mit sudo zum "root" zu werden). Sie können eine oder mehrere Instanzen von Independent Gateway installieren, aber jede Instanz von Independent Gateway muss separat installiert werden. Wenn Sie zwecks Hochverfügbarkeit oder zur Verteilung einer hohen Clientlast mehrere Instanzen installieren, wiederholen Sie die Installationsschritte für jede Instanz.

Nach der Installation werden Sie aufgefordert, ein Skript namens initialize-tsig auszuführen, um die Installation abzuschließen. Das Skript nimmt Informationen entgegen, die Sie mithilfe von Parametern bereitstellen, und konfiguriert Independent Gateway. Sobald Independent Gateway vollständig installiert ist, müssen Sie auf dem Tableau Server-Anfangsknoten einen TSM-Befehl ausführen, um den Server mit Details zu der Instanz von Independent Gateway zu konfigurieren.

Die Installation des Independent Gateways besteht aus den folgenden Schritten:

Ausführen des plattformspezifischen Installationsprogramms.
Ausführen des Nachinstallationsskripts.
Aktivieren der Independent Gateway-Instanz mithilfe von TSM.

Schritt 1: Herunterladen und Installieren von Tableau Server

Installieren und Initialisieren von TSM: Folgen Sie den in diesem Thema aufgeführten Anweisungen und führen Sie die Schritte 1–5 aus, mit denen das Einrichtungsprogramm ausgeführt und TSM installiert wird.
Aktivieren und Registrieren von Tableau Server: Geben Sie im Aktivierungsschritt den Tableau Server-Schlüssel und den Advanced Management-Schlüssel an. Sie müssen den folgenden Befehl zwei Mal ausführen – zuerst mit dem Tableau Server-Produktschlüssel und dann mit dem Advanced Management-Produktschlüssel:
tsm licenses activate -k <product key>
Konfigurieren der Einstellungen für den ursprünglichen Knoten: Folgen Sie den Anweisungen, die in dem Thema zum Konfigurieren der Einstellungen für den Primärknoten aufgeführt sind.

Schritt 2: Herunterladen und Installieren von Independent Gateway

Installieren Sie Tableau Server Independent Gateway mit dem Paket-Manager Ihrer Distribution, und führen Sie dann ein Skript zur Initialisierung von Independent Gateway aus. Das Skript ist im installierten Paket enthalten.

Independent Gateway wird in dem Verzeichnis /opt installiert.

Melden Sie sich als ein Benutzer mit sudo-Zugriff bei dem Computer an, auf dem Sie Independent Gateway installieren möchten.
Hinweis: Um mögliche Komplikationen zu vermeiden, empfehlen wir ein Benutzerkonto, das keine Sonderzeichen enthält (z. B. Nicht-ASCII-Zeichen, "+", "-"). Diese können je nach Konfiguration Ihrer Umgebung Probleme verursachen, wie zum Beispiel, dass Independent Gateway nicht vollständig installiert wird.
Laden Sie das .rpm- oder .deb-Paket des Installationsprogramms von der Seite Tableau Server – Downloads und Versionshinweise herunter.
Navigieren Sie zu dem Verzeichnis, in das Sie das .rpm- bzw. .deb-Paket kopiert haben.
Verwenden Sie den Paket-Manager, um das Independent Gateway-Paket zu installieren.
Führen Sie die Installation nicht an einem Speicherort mit einer symbolischen Verknüpfung oder in einem Verzeichnis auf einem NFS-Volume (Network File System) durch. Führen Sie den folgenden Befehl aus, um Independent Gateway zu installieren. Dabei ist <version> im Format "Hauptversion-Nebenversion-Wartungsversion" anzugeben (z. B. 2022-1-0).
- Für RHEL-ähnliche Distributionen, inklusive CentOS:
  sudo yum update
  sudo yum install tableau-tsig-<version>.x86_64.rpm
- Unter Ubuntu:
```
sudo apt-get update
sudo apt-get upgrade
sudo apt-get -y install gdebi-core
sudo gdebi -n tableau-tsig-<version>_amd64.deb
```

Initialisieren von Tableau Server-Independent Gateway

Der nächste Schritt ist das Ausführen des Skripts initialize-tsig.

Navigieren Sie zu dem Verzeichnis scripts:

cd /opt/tableau/tableau_tsig/packages/scripts.<version_code>/

Führen Sie das folgende Skript aus, um Independent Gateway zu initialisieren und zu starten:
sudo ./initialize-tsig --accepteula -c <ts_cluster_location> --<optional_parameters>
Die einzigen für das Skript initialize-tsig erforderlichen Parameter sind --accepteula und -c.
- --accepteula – Diesen Parameter müssen Sie angeben, um die Lizenzvereinbarung für Endbenutzer (EULA) von Tableau zu akzeptieren. Ein Link zur EULA ist an der folgenden Stelle verfügbar:
  /opt/tableau/tableau_tsig/packages/docs.<version_code>/
- -c – Diesen Parameter müssen Sie einfügen, um den Netzwerkspeicherort aller Knoten in dem Tableau Server-Cluster anzugeben. Diese Knoten können HK-Anforderungen (das "Housekeeping"-Protokoll von Tableau) an das Independent Gateway senden. Um mehrere Knoten anzugeben, können Platzhalter und Subnetzmasken verwendet werden. Um mehrere Adressen anzugeben, trennen Sie die Adressen durch Leerzeichen und setzen Sie das gesamte Set in Anführungszeichen. Werte müssen in einer für die Apache-"Require"-Direktive httpd mod_authz_host akzeptablen Form bereitgestellt werden. Weitere Informationen finden Sie unter https://httpd.apache.org/docs/2.4/mod/mod_authz_host.html(Link wird in neuem Fenster geöffnet).
Alle anderen Parameter, zum Beispiel von HTTP und dem Housekeeping-Prozess verwendete Standardports, sind optional und erhalten Standardwerte, wenn sie nicht angegeben sind. Überprüfen Sie die Parameter und deren Standardwerte, bevor Sie das Skript ausführen: Hilfe-Ausgabe für das Skript "initialize-tsig".

Schritt 3: Aktivieren von Independent Gateway in Tableau Server

Der letzte Schritt der Installation und Konfiguration von Independent Gateway besteht darin, Independent Gateway in Tableau Server zu aktivieren. Verwenden Sie dazu den TSM-Befehl tsm topology external-services gateway enable -c <file> mit einer JSON-Datei, die die Independent Gateway-Instanz oder -Instanzen identifiziert und Tableau Server die für die Kommunikation zwischen dem Server und dem Independent Gateway erforderlichen Details bereitstellt.

Tableau Server muss sich in einem gestoppten Zustand befinden, um Independent Gateway zu aktivieren.

Der Inhalt der JSON-Datei für das Independent Gateway

Die JSON-Datei, mit der Sie die Instanzen von Independent Gateway in Tableau Server aktivieren, muss Folgendes enthalten:

id – Die ID muss mit der tsig_instance_id für die jeweilige Instanz übereinstimmen. Wenn nicht angegeben, wird standardmäßig der vollqualifizierte Domänenname (FQDN) des Independent Gateway-Computers in Kleinbuchstaben verwendet. Der Wert in der JSON-Datei muss mit der Ausgabe des Befehls hostname übereinstimmen.
host – Der Host muss ein DNS-auflösbarer Name für den Independent Gateway-Computer sein, der von den Tableau Server-Knoten per DNS aufgelöst werden kann.
port – Der Port muss mit dem Housekeeping-Port (tsig_housekeeping_port) übereinstimmen, der in der Independent Gateway-Instanz angegeben ist. Wenn während der Initialisierung nicht angegeben, wird der Standardwert "21.319" verwendet.
protocol – Das Protokoll muss mit dem Housekeeping-Protokoll (tsig_housekeeping_port_protocol ) identisch sein, das in der Independent Gateway-Instanz angegeben ist. Wenn während der Initialisierung nicht angegeben, wird der Standardwert "http" verwendet.
authsecret – Das Authentifizierungsgeheimnis muss mit dem Geheimnis übereinstimmen, das von dem Initialisierungsskript auf der Independent Gateway-Instanz erstellt wird.

Das Authentifizierungsgeheimnis des Independent Gateways

Das Initialisierungsskript erstellt auf jedem Independent Gateway-Computer ein eindeutiges, gemeinsames Geheimnis. Sie benötigen dieses Geheimnis, um Independent Gateway in Tableau Server zu aktivieren. Kopieren Sie das Geheimnis und tragen Sie es als "authsecret" in Ihre JSON-Datei ein.

Das gemeinsame Geheimnis befindet sich in der Datei tsighk-auth.conf an der folgenden Stelle:

/var/opt/tableau/tableau_tsig/config/tsighk-auth.conf

Beispiel für eine JSON-Datei für Independent Gateway

Die JSON-Datei sollte das folgende Format haben. Diese JSON-Beispieldatei enthält dort Standardwerte, wo es Standardwerte gibt. Ihre Datei sollte die tatsächlichen Werte verwenden, die Ihrer Installation von Independent Gateway und Ihrer Organisation entsprechen.

{
 "independentGateways": [
  {
    "id": "<mycomputer.example.com>",
    "host": "<DNS name of Independent Gateway computer>",
    "port": "21319",
    "protocol": "http",
    "authsecret": "<shared-secret01>"
  },
  {
    "id": "<mycomputer2.example.com>",
    "host": "<DNS name of second Independent Gateway computer>",
    "port": "21319",
    "protocol": "http",
    "authsecret": "<shared-secret02>"
  }
 ]
}

Aktivieren von Independent Gateway in Tableau Server

Um die Installation von Independent Gateway abzuschließen, müssen Sie es mittels TSM aktivieren.

Kopieren Sie die JSON-Konfigurationsdatei auf den Anfangsknoten von Tableau Server.
Öffnen Sie auf dem Anfangsknoten eine Eingabeaufforderung mit einem Konto, das Mitglied der Gruppe tsmadmin ist.
Führen Sie die folgenden Befehle aus, um Tableau Server zu stoppen, aktivieren Sie Independent Gateway mithilfe der JSON-Konfigurationsdatei und starten Sie den Server neu:
```
tsm stop
tsm topology external-services gateway enable -c tsig.json
tsm start
```

Schritt 4: Überprüfen des Independent Gateways in Tableau Server

Sie sollten in der Lage sein, auf die Anmeldeseite von Tableau Server zu navigieren, indem Sie in einem Browser die Adresse des Independent Gateways eingeben.

Wenn sich zwischen dem Independent Gateway und der Back-End-Tableau Server-Bereitstellung eine Firewall befindet, müssen Sie die Ports für die Tableau Server-Prozesse für eine direkte Verbindung öffnen. Weitere Informationen finden Sie unter Direkte Verbindung.

Alternativ dazu können Sie auch entscheiden, die Portanforderungen minimal zu halten, indem Sie Independent Gateway für eine Relay-Verbindung konfigurieren. Weitere Informationen finden Sie unter Relay-Verbindung.

Zurück zum Anfang

Vielen Dank für Ihr Feedback!

Ihr Feedback wurde erfolgreich übermittelt. Vielen Dank.

Hilfe zu Tableau Server für Linux