Hilfe zu Tableau Server für Windows

Mithilfe von verschiedenen Befehlszeilenoptionen und automatisierten Skripten können Sie allgemeine Lizenzierungsaufgaben für Tableau Server durchführen.

Wenn Sie diese Lizenzierungsaufgaben mithilfe von automatisierten Skripten durchführen möchten, schlagen Sie im Desktop-Bereitstellungshandbuch unter Bereitstellen von Tableau Desktop(Link wird in neuem Fenster geöffnet) nach.

Optionen des Befehlszeilentools und bessere Skriptautomatisierung

Mithilfe des Dienstprogramms tabinstallck.exe können Sie ein Skript für die Aktivierung, Aktualisierung und Deaktivierung von Server-Product Keys erstellen. tabinstallck.exe wird im \bin-Verzeichnis von Tableau Server auf dem Ausgangsknoten installiert. Standardmäßig ist das:

C:\Program Files\Tableau\Tableau Server\packages\bin.<version_code>

Zudem können Sie tsm licenses verwenden, um Lizenzierungsaufgaben durchzuführen, beispielsweise die Online- oder Offline-Aktivierung bzw. -Deaktivierung eines Tableau Server-Produktschlüssels und das Abrufen der zugehörigen Dateien für die Offline-Aktivierung oder -Deaktivierung. Tableau Server muss jedoch bereits bereitgestellt und konfiguriert sein. Sie können diese Lizenzierungsaufgaben mit der Tableau Services Manager-API automatisieren. Zusätzlich kann in tabinstallck.exe der Lizenzierungsschritt für eine neue Tableau Server-Installation, die noch nicht vollständig konfiguriert ist, in einem Skript codiert werden.

Um tabinstallck.exe verwenden zu können, müssen Sie die Befehle oder Skripts als Administrator auf dem primären Tableau Server-Knoten ausführen.

Hinweis: tabinstallck.exe unterstützt keine Offline-(De-)Aktivierung. Weitere Informationen finden Sie unter Offline-Aktivieren von Tableau Server.

Aktivieren

Aktivieren Sie eine Tableau Server-Lizenz mithilfe der Option -activate:

start/wait tabinstallck.exe -activate <product_key>

Aktualisieren

Aktualisieren Sie eine Tableau Server-Lizenz mithilfe der Option -refresh:

start/wait tabinstallck.exe -refresh <product_key>

Deaktivieren

Deaktivieren Sie eine Tableau Server-Lizenz mithilfe der Option -return:

start/wait tabinstallck.exe -return <product_key>

Beispiel

Ein Beispiel eines Skripts zum Aktivieren von Tableau Server kann wie folgt aussehen:

@echo off
start/wait tabinstallck.exe -activate <product_key>
if %errorlevel% EQU 0 (ECHO SUCCESS) ELSE (ECHO FAILED)

Fehlerbehebung

Wenn Sie tabinstallck.exe zum Automatisieren von Tableau Server-Lizenzierungsaufgaben verwenden, werden in der Umgebungsvariable ERRORLEVEL Statusinformationen als Exit-Code zurückgegeben. Bei erfolgreicher Aktivierung lautet der Exit-Code 0 (null). In der folgenden Tabelle werden Exit-Codes aus dem Aktivierungsvorgang und deren Bedeutung aufgeführt. Die Datei tabinstallck.log enthält ebenfalls Fehlerinformationen. Diese Protokolldatei befindet sich standardmäßig im Ordner "Tableau Server \logs":

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\

Der Ordner "ProgramData" ist standardmäßig ausgeblendet.

Im folgenden Beispielskript werden die Aktivierung von Tableau Server und die Überprüfung auf bestimmte Fehler, z. B. auf einen ungültigen Product Key (536871018), sowie allgemeine Lizenzierungsprobleme (536871012) veranschaulicht.

@echo off
start/wait tabinstallck.exe -activate  <product_key>
if %errorlevel% EQU 536871018 (ECHO TABLEAU_ERROR_LICENSING_INVALID_KEY)
if %errorlevel% EQU 536871012 (ECHO TABLEAU_ERROR_LICENCING_GENERAL)
if %errorlevel% EQU 0 (ECHO SUCCESS)