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(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 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.

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 :

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, 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 fermetureMessageValeur
536871012TABLEAU_ERROR_LICENSING_GENERALUne erreur inconnue s’est produite lors de l’opération de licence.
536871013TABLEAU_ERROR_LICENSING_INTERNALImpossible de démarrer le produit suite à une erreur de licence interne.
536871014TABLEAU_ERROR_LICENSING_SETUPImpossible de démarrer le produit suite à une erreur de licence interne.
536871015TABLEAU_ERROR_LICENSING_CONNECTUne erreur s’est produite lors de la connexion au serveur de licence Tableau.
536871017TABLEAU_ERROR_LICENSING_ACTIVATION_ASRUne erreur s’est produite lors de l’activation de l’ASR.
536871016TABLEAU_ERROR_LICENSING_ACTIVATION_GENERALL’activation a échoué ; recommencez.
536871018TABLEAU_ERROR_LICENSING_ACTIVATION_INVALID_KEYClé produit non valide.
536871019TABLEAU_ERROR_LICENSING_ACTIVATION_OFFLINEImpossible de terminer l’activation hors ligne.
536871020TABLEAU_ERROR_LICENSING_ACTIVATION_INVALID_MODELLe serveur de licence a retourné une erreur. Consultez le fichier journal de Tableau pour plus d’informations.
536871021TABLEAU_ERROR_LICENSING_ACTIVATION_MAX_REHOSTSLa désactivation de la licence a échoué ; vous avez atteint la limite de désactivation pour cette licence.
536871033TABLEAU_ERROR_LICENSING_ACTIVATION_MAX_EXTRA_ACTIVATIONSL’activation de la licence a échoué parce que vous avez atteint la limite d’activations pour cette licence.
536871022TABLEAU_ERROR_LICENSING_UNLICENSED_GENERALUne 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.
536871023TABLEAU_ERROR_LICENSING_UNLICENSED_NONE_FOUNDAucune licence n’a été trouvée.
536871024TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIREDSeules des clés de produit expirées ont été trouvées.
536871025TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_TRIALVotre version d’évaluation pour cette version a expiré.
536871026TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_SUBSCRIPTIONLa clé produit a expiré.
536871027TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_MAINTENANCELe contrat de maintenance a expiré.
536871028TABLEAU_ERROR_LICENSING_RESYNC_GENERALVos clés de produits n’ont pas pu être synchronisées.
536871029TABLEAU_ERROR_LICENSING_REGISTRATION_GENERALUne erreur s’est produite pendant l’enregistrement du produit.
536871030TABLEAU_ERROR_LICENSING_SERVICE_INSTALLUne erreur inconnue s’est produite lors des opérations de licence.
536871031TABLEAU_ERROR_LICENSING_SERVICE_UNINSTALLUne erreur inconnue s’est produite lors des opérations de licence.
536871032TABLEAU_ERROR_LICENSING_SERVICE_NOT_PRESENTLe service de licence FLEXnet n’est pas présent sur le système.
Merci de vos commentaires !Avis correctement envoyé. Merci