Automatiser les tâches de gestion de licence

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 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 suivant :

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

Vous pouvez également utiliser tsm licenses pour automatiser des tâches de licence, mais pour cela, cette instance Tableau Server doit déjà être déployée et configurée. tabinstallck.exe permet 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.

Opérations de clé produit avec les serveurs proxy de transfert

Si l'ordinateur sur lequel vous exécutez Tableau Server a été configuré pour se connecter à Internet via un serveur proxy de transfert, suivez la procédure décrite dans la rubrique Configurer les opérations de clé produit avec un proxy de transfert avant de tenter d'activer, d'actualiser ou de désactiver les clés produit.

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 :

/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, les informations d'état sont retournées 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)
Code de fermeture Message Valeur
536871012 TABLEAU_ERROR_LICENSING_GENERAL Une erreur inconnue s'est produite lors de l'opération de licence.
536871013 TABLEAU_ERROR_LICENSING_INTERNAL Impossible de démarrer le produit suite à une erreur de licence interne.
536871014 TABLEAU_ERROR_LICENSING_SETUP Impossible de démarrer le produit suite à une erreur de licence interne.
536871015 TABLEAU_ERROR_LICENSING_CONNECT Une erreur s'est produite lors de la connexion au serveur de licence Tableau.
536871017 TABLEAU_ERROR_LICENSING_ACTIVATION_ASR Une erreur s'est produite lors de l'activation de l'ASR.
536871016 TABLEAU_ERROR_LICENSING_ACTIVATION_GENERAL L'activation a échoué ; recommencez.
536871018 TABLEAU_ERROR_LICENSING_ACTIVATION_INVALID_KEY Clé produit non valide.
536871019 TABLEAU_ERROR_LICENSING_ACTIVATION_OFFLINE Impossible de terminer l'activation hors ligne.
536871020 TABLEAU_ERROR_LICENSING_ACTIVATION_INVALID_MODEL Le serveur de licence a retourné une erreur. Consultez le fichier journal de Tableau pour plus d'informations.
536871021 TABLEAU_ERROR_LICENSING_ACTIVATION_MAX_REHOSTS La désactivation de la licence a échoué ; vous avez atteint la limite de désactivation pour cette licence.
536871022 TABLEAU_ERROR_LICENSING_UNLICENSED_GENERAL Une erreur inconnue s'est produite lors de l'opération de désactivation de la licence. Vérifiez votre clé produit ou contactez le support.
536871023 TABLEAU_ERROR_LICENSING_UNLICENSED_NONE_FOUND Aucune licence n'a été trouvée.
536871024 TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED Seules des clés de produit expirées ont été trouvées.
536871025 TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_TRIAL Votre version d'évaluation pour cette version a expiré.
536871026 TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_SUBSCRIPTION La clé produit a expiré.
536871027 TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_MAINTENANCE Le contrat de maintenance a expiré.
536871028 TABLEAU_ERROR_LICENSING_RESYNC_GENERAL Vos clés de produits n'ont pas pu être synchronisées.
536871029 TABLEAU_ERROR_LICENSING_REGISTRATION_GENERAL Une erreur s'est produite pendant l'enregistrement du produit.
536871030 TABLEAU_ERROR_LICENSING_SERVICE_INSTALL Une erreur inconnue s'est produite lors des opérations de licence.
536871031 TABLEAU_ERROR_LICENSING_SERVICE_UNINSTALL Une erreur inconnue s'est produite lors des opérations de licence.
Merci pour vos commentaires ! Il y a eu une erreur lors de l’envoi de vos commentaires. Essayez à nouveau ou envoyez-nous un message.