Aide de Tableau Server sur Windows

Plusieurs options de ligne de commande vous permettent d’effectuer des tâches courantes de gestion de licence pour Tableau Server à l’aide de scripts automatisés.

Si vous souhaitez effectuer ces tâches de licence pour Tableau Desktop à l’aide de scripts automatisés, consultez Déploiement de Tableau Desktop(Le lien s’ouvre dans une nouvelle fenêtre) dans le Guide de déploiement de Desktop.

Options d’outil de ligne de commande ou automatisation améliorée des scripts

Vous pouvez recourir à un utilitaire appelé tabinstallck.exe pour créer un script d’activation, d’actualisation et de désactivation des clés produit serveur. tabinstallck.exe est installé sur le répertoire \bin de Tableau Server sur le nœud initial. Par défaut, il s’agit du fichier suivant :

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

Vous pouvez également utiliser tsm licenses pour effectuer des tâches de licence telles que l’activation ou la désactivation d’une clé produit Tableau Server en ligne ou hors ligne, et l’obtention de fichiers associés pour l’activation ou la désactivation hors ligne. Tableau Server doit toutefois être déjà déployé et configuré. Vous pouvez automatiser ces tâches de licence en utilisant l’API Tableau Services Manager. tabinstallck.exe permet en outre de créer un script pour l’étape de mise sous licence d’une nouvelle installation Tableau Server qui n’est pas complètement configurée.

Pour utiliser tabinstallck.exe, vous devez exécuter les commandes ou le script en tant qu’administrateur sur le nœud Tableau Server principal.

Remarque : tabinstallck.exe ne prend pas en charge l’activation et la désactivation hors ligne. Pour en savoir plus, consultez Activer Tableau Server hors ligne.

Activer

Activez une licence Tableau Server à l’aide de l’option -activate :

start/wait tabinstallck.exe -activate <product_key>

Actualisation

Actualisez une licence Tableau Server à l’aide de l’option -refresh :

start/wait tabinstallck.exe -refresh <product_key>

Désactivation

Désactivez une licence Tableau Server à l’aide de l’option -return :

start/wait tabinstallck.exe -return <product_key>

Exemple

Voici comment peut se présenter un exemple de script d’activation de Tableau Server :

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

Traitement des erreurs

Lorsque vous utilisez tabinstallck.exe pour automatiser des tâches de licence Tableau Server, l’information d’état est retournée en tant que code de sortie dans la variable d’environnement ERRORLEVEL. Si l’activation a réussi, le code de fermeture de l’application est 0 (zéro). Le tableau ci-dessous dresse la liste des codes de fermeture du processus d’activation et indique leur signification. Vous pouvez également trouver des informations d’erreur dans le fichier journal tabinstallck.log. Ce fichier journal se trouve par défaut dans le dossier Tableau Server \logs :

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

Le dossier ProgramData est masqué par défaut.

Cet exemple de script montre comment activer Tableau Server et rechercher des erreurs spécifiques, par exemple une clé produit non valide (536871018) et des problèmes de licence généraux (536871012).

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