Activer Tableau Server à l’aide du service Authorize to Run
Vous pouvez utiliser le service ATR pour activer Tableau Server déployé dans des environnements sur place, nuagiques, conteneurs ou virtuels sans manquer d’activations de licence. Le service ATR offre cette possibilité en fournissant des baux à court terme d’une durée configurable (durée du service ATR) qui lient la licence à l’appareil jusqu’à ce que la date d’expiration de la clé produit soit atteinte. ATR gère le suivi de la capacité d’activation de sorte qu’en cas de modification matérielle sous-jacente, les erreurs d’activation maximales ne se produisent pas. Cette option est recommandée pour toutes les installations de Tableau Server.
Si vous activez Tableau Server en ligne (c’est le cas par défaut), Tableau Server se connecte à différents sites Internet pour l’octroi de licences. Pour plus d’informations, consultez Communication avec Internet(Le lien s’ouvre dans une nouvelle fenêtre).
Si vous activez Tableau Server hors ligne, vous pouvez toujours utiliser le service ATR pour l’activer, mais de légères différences existent dans le fonctionnement de la durée du service ATR avec les activations hors ligne. Pour plus d’information, consultez Durée du service ATR pour les activations hors ligne.
Nous vous recommandons d’utiliser le service Autorize to Run (ATR) du serveur pour simplifier l’octroi de licences de serveur. Si vous choisissez de ne pas utiliser Server ATR, vous utiliserez l’ancienne technologie d’octroi de licences qui n’offre pas les capacités de gestion dynamique de Server ATR.
Le type d’activation que vous allez sélectionner sera permanent pour cette installation de Tableau Server. Si vous souhaitez le modifier ultérieurement, vous devrez sauvegarder, supprimer, puis réinstaller Tableau Server.
Fonctionnement de Tableau Server ATR
Lorsque le service ATR est activé, Tableau Server communique périodiquement avec un service Authorize to Run (ATR) hébergé par Tableau pour vérifier que Tableau est autorisé à s’exécuter, en fonction de sa licence et de la durée de la fenêtre d’autorisation (durée ou bail ATR). Tant que cette communication fonctionne, Tableau s’exécute sans incidence pour l’utilisateur.
Lorsque Tableau Server est activé hors ligne et que ATR est activé, Tableau Server ne peut pas communiquer périodiquement avec le service ATR pour vérifier que Tableau est autorisé à s’exécuter. En revanche, Tableau Server effectue un suivi interne de la durée du service ATR à partir de la première activation hors ligne de la clé produit.
Durée du service ATR
Par défaut, une instance de Tableau Server se voit attribuer un bail (durée) ATR de 5 jours pour joindre avec succès le service ATR à des fins de vérification. Il faut donc comprendre qu’après la première autorisation, Tableau Server peut être utilisé pendant 5 jours sans connexion réseau avant que l’activation n’expire. Des tentatives de contrôles d’autorisation sont régulièrement effectuées entre Tableau Server et le service ATR, et chaque fois qu’un contrôle réussit, l’autorisation ATR est réinitialisée à sa pleine durée.
La fréquence des contrôles d’autorisation varie et dépend de la durée du service ATR :
| Durée du service ATR | Fréquence des contrôles d’autorisation |
| < 4 heures | toutes les 15 minutes |
| < 24 heures | toutes les 1 heure |
| < 7 jours | toutes les 12 heures |
| > 7 jours | toutes les 24 heures |
Par exemple : Si la durée du service ATR est de 48 heures, Tableau Server communique avec le service ATR toutes les 12 heures pour effectuer un contrôle d’autorisation et la durée du service ATR sera réinitialisée à 48 heures après chaque contrôle d’autorisation réussi. La durée du service ATR commence alors un compte à rebours à 0 jusqu’au prochain contrôle d’autorisation. Si la machine Tableau Server cesse de fonctionner ou s’il n’y a pas d’accès à Internet, Tableau Server ne pourra plus communiquer avec le service ATR. Dans ce cas, la durée du service ATR ne sera pas réinitialisée à 48 heures et continuera le décompte jusqu’à 0. Si Tableau Server n’est pas démarré ou ne peut pas communiquer avec le service ATR avant que la durée du service ATR n’atteigne 0, la licence va expirer et vous devrez l’activer à nouveau.
Remarque : Vous devez garder votre Tableau Server en cours d’exécution autant que possible. Si Tableau Server n’arrive pas à effectuer un contrôle d’autorisation pendant la durée ATR, le service ATR récupère le bail de licence et vous devrez alors réactiver votre licence.
Pour afficher la durée ATR, voir tsm licenses atr-configuration get(Le lien s’ouvre dans une nouvelle fenêtre).
Définir ou modifier la durée du service ATR du serveur
Lorsque vous utilisez le service ATR du serveur pour activer Tableau Server, vous pouvez modifier la durée du service ATR et utiliser un paramètre différent de la valeur par défaut de 432 000 secondes (5 jours). Si vous créez un serveur de test ou une machine virtuelle (VM) qui aura une courte durée de vie, vous voudrez peut-être raccourcir la durée du service ATR. De même, si vous avez un serveur que vous prévoyez de conserver pendant une longue période, vous souhaiterez peut-être allonger la durée du service.
La réduction de la durée ATR lorsque vous démarrez fréquemment des machines virtuelles récentes permet aux machines virtuelles d’ancienne génération de libérer leur capacité, qui pourra être utilisée par les machines virtuelles récentes. En revanche, l’augmentation de la durée ATR rallonge les cycles de renouvellement, mais ne permet pas de libérer la capacité aussi souvent.
Pour modifier la durée du service ATR, utilisez la commande tsm licenses atr-configuration set –duration <value_in_seconds>. Pour plus d’informations, consultez tsm licenses atr-configuration set(Le lien s’ouvre dans une nouvelle fenêtre).
| Durée du service ATR en quelques secondes | Minimum | Maximum | Par défaut |
|---|---|---|---|
| Tableau Server (conteneur) | 3 600 (1 heure) | 2 593 000 (30 jours) | 14 400 (4 heures) |
| Tableau Server (non-conteneur) | 3 600 (1 heure) | 7 776 000 (90 jours) | 432 000 (5 jours) |
Tableau Server sur Linux
Pour définir la durée du service ATR et démarrer manuellement le Service d’activation, exécutez les commandes suivantes :
Sur le nœud initial, ouvrez une session du terminal puis utilisez les commandes suivantes :
tsm licenses atr-configuration set -–duration <value_in_seconds>tsm pending-changes applysudo su -l tableausystemctl --user stop activationservice_0systemctl --user start activationservice_0Vérifiez que le Service d’activation est en cours d’exécution à l’aide de la commande
tsm status -v. Le Service d’activation de Tableau Server devrait afficher l’état « en cours d’exécution ». Si le Service d’activation n’est pas démarré, exécutez :systemctl --user restart activationservice_0
Tableau Server dans un conteneur
Pour définir la durée du service ATR et démarrer manuellement le Service d’activation, exécutez les commandes suivantes :
Sur le nœud initial, ouvrez une session du terminal puis utilisez les commandes suivantes :
tsm licenses atr-configuration set -–duration <value_in_seconds>tsm pending-changes applysudo su -l tableausupervisorctl stop activationservice_0supervisorctl start activationservice_0Vérifiez que le Service d’activation est en cours d’exécution à l’aide de la commande
tsm status -v. Le Service d’activation de Tableau Server devrait afficher l’état « en cours d’exécution ». Si le Service d’activation n’est pas démarré, exécutez :supervisorctl restart activationservice_0
Remarque : pour Tableau Server exécuté dans un conteneur, les valeurs Début TTL et Fin TTL reflètent le bail actuel utilisé par Tableau Server . Les baux de conteneurs de moins d’une journée sont actualisés toutes les heures, mais les baux plus longs peuvent prendre jusqu’à 24 heures pour se renouveler.
Durée du service ATR pour les activations hors ligne
Lorsque Tableau Server est activé hors ligne, la durée ATR est fixée à un an à compter du jour d’activation hors ligne de la clé produit ou de la date de renouvellement de la clé produit, selon la première éventualité. Lorsque la durée ATR atteint la date définie, la clé produit est désactivée. Tableau ne pouvant pas communiquer avec le service ATR dans des environnements hors ligne, aucun contrôle d’autorisation ne sera effectué.
Si vous utilisez la commande tsm licenses atr-configuration get pour afficher la durée du service ATR pour les activations hors ligne, le résultat sera 0, ce qui est attendu. Pour afficher la durée du service ATR pour les activations hors ligne, utilisez plutôt la commande ATRDiag -product "Tableau Server". Pour plus d’informations, consultez Référence de ligne de commande ATRDiag.exe. Parmi les sorties, la date TTL End correspond à la date à laquelle la durée du service ATR se termine.
Mise à jour de la durée ATR dans les environnements hors ligne
Étant donné que les contrôles d'autorisation ne sont pas possibles dans un environnement hors ligne, la durée ATR est définie sur une valeur fixe comme décrit ci-dessus. Pour éviter les temps d’arrêt imprévus de Tableau Server, tenez compte de la durée ATR de votre installation et prévoyez de mettre à jour la durée ATR avant son expiration. La réalisation de cette opération dépend de si votre clé est USL ou non USL :
Clés USL : Si vous avez une clé USL, suivez les instructions décrites ici : Mises à jour du droit de licence hors ligne de la clé produit USL.
Clés non USL : Si vous avez une clé non USL :
Désactivez la clé de licence existante. Consultez Désactiver Tableau Server hors ligne.
Activez votre nouvelle clé. Consultez Activer Tableau Server hors ligne
Déplacer une clé produit Server ATR vers une autre instance de Tableau Server
Si vous souhaitez arrêter d’utiliser votre clé produit sur une instance Tableau Server existante et l’utiliser sur une nouvelle installation de Tableau Server, vous pouvez déplacer votre clé produit Server ATR. Vous souhaiterez peut-être déplacer des clés produits dans les cas suivants :
Basculement entre les environnements de développement ou de pré-production.
Déplacement de Tableau Server sur un matériel mis à niveau.
Déplacement de Tableau Server sur une infrastructure dans le nuage.
Utiliser une instance Tableau Server éphémère, par exemple une machine virtuelle ou un conteneur.
Désactiver une clé produit pour la réutiliser sur une autre instance Tableau Server
Désactiver une clé produit dans la version 2021.4 et les versions ultérieures
Vous pouvez supprimer des clés produit qui ont été activées à l’aide du service ATR du serveur lorsque vous souhaitez récupérer des capacités de licence d’une installation Tableau Server et les utiliser sur une autre. Pour plus d’informations sur la récupération d’une clé de produit, consultez Désactiver une clé produit .
Désactiver une clé produit dans la version 2021.3 et les versions antérieures
Lorsque le service ATR est utilisé pour activer une licence Tableau Server, vous ne pouvez pas désactiver manuellement la licence. Vous pouvez avoir une installation de production et deux installations hors production par licence. Si vous avez des activations inutilisées sur une licence, vous pouvez activer la même licence sur une autre instance Tableau Server. Si vous n’avez plus d’activations, vous pouvez toujours activer la licence après l’expiration du bail ATR en procédant comme suit :
Empêchez l’instance Tableau Server existante d’actualiser son activation louée. Vous pouvez utiliser l’une des méthodes suivantes dans ce cas :
Fermer votre Tableau Server existant.
Désinstaller l’instance Tableau Server existante.
Déconnecter l’instance Tableau Server existante d’Internet en débranchant le câble Ethernet ou en déconnectant le Wi-Fi.
Après l’expiration du bail ATR, vous pouvez réutiliser la licence sur un autre Tableau Server.
Sur le nouvel ordinateur, installez Tableau Server.
Lorsque vous y êtes invité, activez Tableau Server en utilisant la même licence.