Automatisieren von Lizenzierungsaufgaben

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.

Product Key-Vorgänge mit Forward-Proxyservern

Wenn der Computer, auf dem Sie Tableau Server ausführen, so konfiguriert wurde, dass er die Verbindung zum Internet über einen Forward-Proxy herstellt, führen Sie vor dem Aktivieren, Aktualisieren oder Deaktivieren von Product Keys die im Abschnitt Konfigurieren von Product Key-Vorgängen mit Forward-Proxy beschriebenen Schritte aus.

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)
ExitcodeMeldungWert
536871012TABLEAU_ERROR_LICENSING_GENERALUnbekannter Fehler beim Lizenzierungsvorgang
536871013TABLEAU_ERROR_LICENSING_INTERNALDas Produkt kann aufgrund eines internen Lizenzierungsfehlers nicht gestartet werden.
536871014TABLEAU_ERROR_LICENSING_SETUPDas Produkt kann aufgrund eines internen Lizenzierungsfehlers nicht gestartet werden.
536871015TABLEAU_ERROR_LICENSING_CONNECTFehler beim Kontaktieren des Tableau-Lizenzservers
536871017TABLEAU_ERROR_LICENSING_ACTIVATION_ASRFehler beim Aktivieren von ASR
536871016TABLEAU_ERROR_LICENSING_ACTIVATION_GENERALAktivierung fehlerhaft. Versuchen Sie es erneut.
536871018TABLEAU_ERROR_LICENSING_ACTIVATION_INVALID_KEYUngültiger Produktschlüssel
536871019TABLEAU_ERROR_LICENSING_ACTIVATION_OFFLINEOffline-Aktivierung kann nicht abgeschlossen werden.
536871020TABLEAU_ERROR_LICENSING_ACTIVATION_INVALID_MODELVom Lizenzserver wurde ein Fehler zurückgegeben. Prüfen Sie die Tableau-Protokolldatei, um weitere Informationen zu erhalten.
536871021TABLEAU_ERROR_LICENSING_ACTIVATION_MAX_REHOSTSFehler beim Deaktivieren der Lizenz, da Sie den Grenzwert an Deaktivierungen für diese Lizenz erreicht haben.
536871033TABLEAU_ERROR_LICENSING_ACTIVATION_MAX_EXTRA_ACTIVATIONSFehler beim Aktivieren der Lizenz, da Sie den Grenzwert an Aktivierungen für diese Lizenz erreicht haben.
536871022TABLEAU_ERROR_LICENSING_UNLICENSED_GENERALUnbekannter Fehler beim Rückgängigmachen der Lizenzierung. Prüfen Sie Ihren Product Key, oder wenden Sie sich an den Support.
536871023TABLEAU_ERROR_LICENSING_UNLICENSED_NONE_FOUNDKeine Lizenzen gefunden
536871024TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIREDEs wurden nur abgelaufene Product Keys gefunden.
536871025TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_TRIALIhr Testzeitraum für diese Version ist zu Ende.
536871026TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_SUBSCRIPTIONDer Product Key ist abgelaufen.
536871027TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_MAINTENANCEWartung ist abgelaufen.
536871028TABLEAU_ERROR_LICENSING_RESYNC_GENERALIhre Product Keys konnten nicht synchronisiert werden.
536871029TABLEAU_ERROR_LICENSING_REGISTRATION_GENERALFehler bei der Produktregistrierung
536871030TABLEAU_ERROR_LICENSING_SERVICE_INSTALLUnbekannter Fehler während der Lizenzierungsvorgänge
536871031TABLEAU_ERROR_LICENSING_SERVICE_UNINSTALLUnbekannter Fehler während der Lizenzierungsvorgänge
536871032TABLEAU_ERROR_LICENSING_SERVICE_NOT_PRESENTDer FLEXnet-Lizenzierungsdienst ist auf dem System nicht vorhanden.
Vielen Dank für Ihr Feedback!Ihr Feedback wurde erfolgreich übermittelt. Vielen Dank.