Commandes de licences

La console License Administration Console facilite l’accès à de nombreuses fonctions du système de licences. Vous pouvez également effectuer des opérations de gestion de licences à l’aide de commandes. Vous pouvez utiliser les commandes d’administration des licences lors de la réalisation d’opérations avancées sur le serveur de licences qui ne sont pas disponibles dans la console. Ces opérations incluent le diagnostic des problèmes d’obtention de licence à l’aide de lmdiag.

Les commandes d’administration des licences sont stockées dans :

  • C:\Program Files\Citrix\Licensing\LS sur un ordinateur 32 bits
  • C:\Program Files (x86)\Citrix\Licensing\LS sur un ordinateur 64 bits
  • /opt/citrix/licensing/LS pour un serveur de licences VPX

Tableau des commandes

Utilitaire Description
lmadmin Permet de configurer le système de licences. Utilisez la console License Administration Console pour effectuer les tâches de configuration et d’administration du système de licences. N’utilisez pas lmadmin.
lmdiag Permet d’établir un diagnostic des problèmes d’extraction de licence.
lmdown Interrompt en douceur les démons License Manager et vendeur Citrix (désactivé par défaut).
lmhostid Affiche l’identificateur de l’hôte du serveur sur lequel est exécuté le système de licences Citrix.
lmreread Demande au démon du gestionnaire de licences de relire le fichier de licences et de démarrer le démon vendeur Citrix.
lmstat Fournit l’état d’un serveur de licences.
lmutil Affiche une liste des utilitaires de gestion de licence ou exécute d’autres commandes.
lmver Affiche les informations de version des binaires du système de licences.
udadmin Affiche tous les utilisateurs et machines titulaires d’une licence et supprime les machines et utilisateurs sous licence spécifiés. Cette commande ne s’applique qu’aux licences utilisateur ou associées à une machine. Remarque : la spécification de udadmin -export permet d’exporter l’utilisation des produits, et non une liste de licences. Pour obtenir une liste de licences, spécifiez udadmin -list.

Format des commandes de licence

Conventions des commandes d’administration de licences :

Convention Description  
  Gras Une commande ou un commutateur, tel que lmstat.
  Italique Remplacer les variables avec une valeur, par exemple, dans l’expression : lmstat -c license_file_list. Avant d’exécuter la commande, vous devez remplacer license_file_list par les noms d’un ou de plusieurs fichiers de licences.
  [Crochets] Les crochets entourent des options pouvant être ajoutées à la commande ou du texte devant être remplacé.

Arguments universels

Arguments valides pour la plupart des commandes d’administration de licences :

Argument Description
-all Applique la commande à tous les serveurs de licences du réseau.
-c Permet de spécifier le port et le nom d’hôte des fichiers de licences ou du serveur de licences. Si vous spécifiez le chemin d’accès sans le nom de fichier de licences, la commande s’applique à tous les fichiers de licences du répertoire. Pour un hôte local: -c @localhost. Pour un serveur de licences distant: -c @servername. Pour un serveur de licences dans un cluster: -c @clientaccesspointname. Pour un chemin spécifié: -c path. Pour les noms d’un ou plusieurs fichiers de licence: -c license_file_list. Vous pouvez entrer plusieurs chemins de fichier de licence en séparant chaque chemin par un point-virgule. Les chemins contenant des espaces doivent être entourés de guillemets.
-h Handle de licence, tel qu’il apparaît avec la commande lmstat -a. Il s’agit d’un numéro permettant d’identifier une licence extraite particulière.
-help Affiche des informations d’utilisation, puis ferme la fenêtre.
-s [server] Affiche l’état de tous les fichiers de licences sur le serveur de licences ou sur tous les serveurs de licences, si aucune option server n’est spécifiée.
-verbose Affiche une description de toutes les erreurs rencontrées.

Diagnostic des problèmes d’extraction (lmdiag)

lmdiag permet d’établir un diagnostic lorsqu’un produit ne parvient pas à extraire une licence. Vous pouvez notamment vérifier que vos licences sont valables et que le serveur de licences fonctionne correctement. Lorsque cet utilitaire est exécuté, il tente d’extraire une licence.

Vous pouvez également vous servir de l’utilitaire lmdiag pour voir si un type de licence spécifique fonctionne. Par exemple, vous pouvez exécuter lmdiag sur votre serveur Citrix Virtual Apps, licences édition Advanced uniquement en ajoutant l’argument MPS_ADV_CCU.

Syntaxe :

lmdiag -c license_file_list [-n] [feature[:keyword=value]]

Argument Description
-c license_file_list Établit un diagnostic concernant les fichiers spécifiés. Vous pouvez également utiliser : -c @localhost ou -c @server-name
-n Fonctionne en mode non interactif. lmdiag ne demande aucune entrée dans ce mode.
feature Limite le retour d’informations à la fonctionnalité spécifiée.
keyword=valeur Si un fichier de licences contient plusieurs lignes pour une fonctionnalité particulière, le résultat est limité à la ligne contenant la valeur littérale. Par exemple, lmdiag -c @localhost MPS_ENT_CCU:HOSTID=LICSERV01 effectue une tentative d’extraction à la ligne contenant l’expression host ID LICSERV01. Le mot-clé est l’un des suivants : VERSION, HOSTID, EXPDATE, KEY, VENDOR_STRING, ISSUER

Si aucune fonctionnalité n’est spécifiée, lmdiag traite toutes les fonctionnalités des fichiers de licences de votre liste. lmdiag affiche des informations sur la licence, puis tente d’extraire chaque licence. lmdiag indique la réussite par un message. Si l’extraction échoue, lmdiag vous donne la raison de l’échec. lmdiag tente de se connecter à chaque port TCP/IP du serveur de licences. Il détecte si le numéro de port du fichier de licences est incorrect. lmdiag énumère tous les ports TCP/IP en cours d’écoute et, en présence de l’argument -c license_file_list, établit un diagnostic des fichiers spécifiés.

lmdiag ne contacte pas la machine exécutant le produit Citrix lors de la tentative d’extraction de licences. lmdiag ne signale que les problèmes sur le serveur de licences. Cela signifie que le produit ne peut pas extraire de licences car il ne pointe pas vers le bon serveur de licences, mais lmdiag ne détecte pas ce problème. Par exemple, cela peut se produire sur un serveur de licences qui ne dispose pas de licence pour ce produit. lmdiag signale qu’il peut extraire les licences lorsque le produit Citrix pointe sur le serveur de licences incorrect.

Arrêter les démons (lmdown)

L’utilitaire lmdown ferme les démons du gestionnaire de licences et vendeur Citrix sur votre serveur de licences ou tous les serveurs de licences de votre réseau mais il est désactivé par défaut. Pour l’activer :

  1. Arrêtez le serveur de licences.
  2. Exécutez lmadmin - allowStopServer et/ou -allowRemoteStop Server.
  3. Redémarrez le serveur de licences.

Syntaxe :

lmdown -c license_file_list [-vendor CITRIX] [-q] [-all]

Argument Description
-c license_file_list ou -c@localhost or -c@server Utilise les fichiers de licences spécifiés. Il est toujours recommandé de spécifier -c license_file_list avec lmdown. Vous pouvez également utiliser : -c @localhost ou -c @server-name.
-vendor CITRIX Ferme uniquement le démon vendeur Citrix. Le démon License Manager continue à fonctionner.
-q N’affiche aucune invite et n’imprime aucun en-tête. Sinon lmdown pose la question « Êtes-vous sûr ? [[y/n]] : . »
-all Si plusieurs serveurs sont désignés, ils sont tous fermés automatiquement. -q est sous-entendu dans -all.

L’utilitaire lmdown doit être utilisé sur un serveur de licences. Vous pouvez utiliser -all pour arrêter tous les serveurs de licences du réseau.

Si lmdown rencontre plusieurs serveurs (par exemple, si -c désigne un répertoire contenant plusieurs fichiers *.lic) et si -all est absent, une liste de serveurs de licences pouvant être fermés s’affiche. Vous pouvez arrêter les serveurs de licences distants en utilisant -c et en spécifiant le nom du serveur de licences.

Remarque

Si vous utilisez le Gestionnaire des tâches pour mettre fin au démon License Manager (service Système de licences Citrix), arrêtez d’abord le processus lmgrd, puis le processus du démon vendeur Citrix.

Pour arrêter et redémarrer uniquement le démon vendeur Citrix, utilisez lmdown -c @localhost -vendor CITRIX, puis utilisez lmreread -c @localhost -vendor CITRIX pour redémarrer le démon vendeur.

Vérifier les noms d’hôtes (lmhostid)

L’utilitaire lmhostid renvoie le nom d’hôte du serveur de licences. Vous pouvez ainsi vérifier le nom d’hôte de votre serveur de licences. Il est possible d’ouvrir un fichier de licences et d’y comparer le nom d’hôte à celui de votre serveur de licences.

Remarque

La version 11.5 et supérieure du système de licences Citrix pour Windows vous permet d’afficher plusieurs ID d’hôte s’il existe plus d’un hôte.

Syntaxe :

lmhostid -bindingidentifier

Argument (identificateur de liaison) Description
-ether Utilisé pour les licences de produit qui sont liées à l’adresse MAC du boîtier.
-internet Utilisé pour les licences de produits Citrix Windows qui nécessitent une adresse TCP/IP.
-hostname Utilisé pour les licences de produits Citrix Windows qui sont liées au paramètre hostname du serveur de licences. Remarque : le paramètre hostname doit respecter la casse et doit correspondre exactement au nom de votre serveur de licences.

Relire les fichiers de licence et d’options (lmreread)

L’utilitaire lmreread demande au démon vendeur Citrix de relire les modifications apportées au fichier de licences et au fichier d’options. Après la relecture, le démon vendeur Citrix utilise les nouveaux réglages ou les nouvelles licences.

lmreread ne peut pas être utilisé à distance. Exécutez-le localement sur le serveur de licences.

Syntaxe :

lmreread -c license_file_list [-all] [-vendor CITRIX]

Argument Description
-c @localhost ou -c license_file_list Utilise les fichiers de licences spécifiés.
-all Si plusieurs lmgrd sont désignés, envoyez une commande de relecture à tous les démons du gestionnaire de licences.
-vendor CITRIX Provoque le redémarrage du démon vendeur Citrix.

Exemples :

  • lmreread -c @localhost [-all]
  • lmreread -c @client_access_point_name
  • lmreread -c /opt/citrix/licensing/myfiles/CITRIX.lic -vendor CITRIX

Afficher la liste des utilitaires du système de licences (lmutil)

L’utilitaire lmutil affiche une liste des utilitaires du système de licences en cas d’utilisation autonome. Lorsque vous spécifiez lmutil avec une autre commande, il exécute cette commande.

Syntaxe :

lmutil

lmutil other_command

Exemples :

  • lmutil

    Affiche la liste des utilitaires du système de licences.

  • lmutil lmstat -c @localhost

    Exécute la commande lmstat.

Déterminer l’état de la licence (lmstat)

L’utilitaire lmstat permet de surveiller l’état de toutes les activités réseau liées à la gestion de licences et propose des informations sur les extractions de licences, notamment :

  • le produit pour lequel une ou plusieurs licences ont été extraites ;
  • les données d’extraction ;
  • la version du fichier de licences ;
  • le nom et le port du serveur de licences ;
  • la date d’extraction de la licence ;
  • les informations relatives à l’état du démon vendeur Citrix et des fichiers de licences.

lmstat affiche les informations reçues du serveur de licences. lmstat affiche une seule utilisation de la licence, même si plusieurs connexions partagent cette licence.

Syntaxe :

lmstat [-a] [-c license_file_list] [-f [feature]] [-i [feature] [-s[server] [-S [CITRIX]] [-t timeout_value]

Argument Description
-a Affiche toutes les informations.
-c @localhost ou -c@server or -c license_file_list Utilise les fichiers de licences spécifiés.
-f [feature] Affiche les produits utilisant une fonctionnalité (licence produit). Si l’option feature n’est pas spécifiée, les informations d’utilisation de toutes les fonctionnalités sont affichées.
-i [feature] Affiche des informations de la ligne INCREMENT pour la fonctionnalité spécifiée (licence de produit) ou pour toutes les fonctionnalités si aucune option *feature* n’est spécifiée.
-s [server] Affiche l’état de tous les fichiers de licences sur le serveur de licences ou sur tous les serveurs de licences, si aucune option *server* n’est spécifiée.
-S [CITRIX] Énumère tous les serveurs de produits utilisant les fonctionnalités (licences produit) servies par le démon vendeur Citrix.
-t timeout_value Établit le délai d’expiration de la connexion à la valeur timeout_value. Ainsi le temps que lmstat passe à tenter de se connecter au serveur de licences est limité.

La sortie de lmstat -c@localhost -a est affichée ainsi. Les lignes de l’exemple peuvent être séparées en raison de l’espace d’écran.

License server status: 27000@localhost

   License file(s) on localhost: C:\Program Files (x86)\Citrix\Licensing\MyFiles\citrix_startup.lic:C:\Program Files (x86)\Citrix\Licensing\MyFiles\License.lic:

   localhost: license server UP v11.15.0

   Vendor daemon status (on LicenseServer):

      CITRIX: UP v11.15.0

Feature usage info:

   Users of CITRIX: (Total of 10000 licenses issued; Total of 1 licenses in use)

   "CITRIX" v2038.0101, vendor: CITRIX, expiry: permanent(no expiration date)
vendor_string: ;LT=SYS;GP=720;SA=0
floating license

   XDT DDCPrinc-0001.citrix.com XDT XDT_PLT&MPS_PLT_2018.0518 (v1.0) (localhost/27000 102), start Tue 5/8 17:59

Users of CTXLSDIAG: (Total of 10000 licenses issued; Total of 0 licenses in use)

Users of XDT_PLT_CCS: (Total of 200000 licenses issued; Total of 3 licenses in use)

   "XDT_PLT_CCS" v2018.1201, vendor: CITRIX, expiry: 01-dec-2018
vendor_string: ;LT=Retail;GP=720;PSL=10;CL=VDS,VDA,VDE,VDP;SA=0;ODP=0;NUDURMIN=2880;NUDURMAX=525600
floating license

   XDT DDCAux-0001.citrix.com XDT 00001E3A (v2018.0518) (localhost/27000 534201), start Wed 5/9 15:17
   XDT DDCAux-0001.citrix.com XDT 00001E81 (v2018.0518) (localhost/27000 392504), start Wed 5/9 15:18
   XDT DDCAux-0001.citrix.com XDT 00001E0C (v2018.0518) (localhost/27000 419703), start Wed 5/9 15:18

Les informations de la ligne MPS_ENT_CCU de la sortie lmstat se décomposent de la façon suivante.

    Description
MPS citrix_product_name Nom du produit Citrix pour lequel une licence est extraite.
mps_server1 hostname Machine sur laquelle est exécuté le produit Citrix.
MPS display Nom du produit Citrix pour lequel une licence est extraite.
license_server1 server_host Machine sur laquelle est exécuté le serveur de licences.
27000 port Numéro du port TCP/IP sur lequel est exécuté le serveur de licences.
203 handle Identificateur de licence. Il s’agit d’un numéro permettant d’identifier une licence extraite particulière.
start Wed 3/17 11:56 checkout_time Heure à laquelle la licence a été extraite pour la première fois.

lmstat -c@localhost -a peut parfois générer un accroissement de l’activité réseau dans des systèmes où de nombreuses licences sont extraites.

Vous pouvez utiliser lmstat -a pour vérifier les données d’extraction de licences.

Afficher les versions des binaires (lmver)

L’utilitaire lmver affiche des informations sur la version des fichiers binaires du système de licences, telles que les utilitaires de commandes. La seule exception est l’utilitaire lmadmin. Pour afficher des informations sur la version de l’utilitaire lmadmin, utilisez lmadmin -version.

Syntaxe :

lmver binary

Exemple :

lmver lmdiag

Afficher ou libérer des licences pour des utilisateurs ou des machines (udadmin)

uadmin affiche les utilisateurs et machines titulaires d’une licence et libère des licences pour des utilisateurs et machines spécifiés.

Vous pouvez libérer une licence pour un utilisateur seulement à la condition que cette personne ne soit plus associée à l’entreprise ou qu’elle ait pris un congé de longue durée. Vous pouvez libérer des licences associées à des machines lorsque ces dernières sont hors service.

Attention :

L’émission en masse de licences, avant la période d’utilisation de 90 jours, autre que pour les raisons indiquées ci-dessus peut violer le Contrat de licence de l’utilisateur final Citrix (EULA). Avant de procéder, contactez Citrix.

Les informations d’utilisation affichées par la ligne de commande udadmin s’affichent uniquement en anglais, vous pouvez toutefois utiliser cette commande sur des systèmes autres que l’anglais.

Syntaxe :

udadmin [-options] [-delete -events -export -list -times]
Options Description
-f feature name Utilisé en conjonction avec -list ou -delete, affiche ou libère la licence uniquement pour l’utilisateur ou la machine pour la valeur feature name spécifiée.
-user user name Libère la licence uniquement pour l’utilisateur spécifié par la valeur user name.
-device device name Libère la licence uniquement pour la machine spécifiée par la valeur device name.
-a Dresse la liste de toutes les fonctionnalités et versions installées sur le serveur de licences.
Argument Description
-delete Libère la licence pour un utilisateur, une fonctionnalité ou une machine à la fois.
-events Crée un rapport de tous les événements journalisés par le système de licences utilisateur/machine pour chaque fonctionnalité par ordre chronologique.
-export Exporte toutes les données utilisateur/machine dans un document .csv. La première ligne est l’en-tête de colonne. La fonctionnalité, suivie de l’utilisateur constituent le format. Chaque élément unique (user, deviceId, versionRequested) apparaît sur une ligne. Les demandes de licence redondantes pour le même élément (user, deviceid, versionRequested) ne sont pas affichées individuellement. L’horodatage est mis à jour par la demande la plus récente.
-list Affiche les utilisateurs et machines dotés de licences ainsi que l’heure de la dernière mise à jour. L’heure de la prochaine mise à jour s’affiche si une activité importante s’est produite dans les 15 minutes suivant le dernier rapport. La spécification de -list -times génère une sortie contenant un horodatage.
-times La spécification de -list -times génère une sortie contenant un horodatage.
Pas d’argument ou ? Affiche des informations d’utilisation pour la commande udadmin.

Exemples :

  • udadmin -list -times

    Les données d’utilisation sont âgées de 0 minute. Prochaine mise à jour dans 15 minutes.

    Utilisateurs :

    u01.01 XDT_ENT_UD 2017.1201 (Thu Sep 14 13:41:07 2017)

    u01.04 XDT_ENT_UD 2017.1201 (Thu Sep 14 13:41:07 2017) . . .

    Appareils :

    D.ADV.23 XDT_ADV_UD 2017.1201 (Thu Sep 21 18:31:01 2017)

    D01 XDT_PLT_UD 2017.1201 (Tue Sep 12 14:30:33 2017)

  • udadmin -list -a

    Dresse la liste de toutes les fonctionnalités, des versions, du nombre de licences, et des utilisateurs et machines pour chaque fonctionnalité.

  • udadmin -export

    feature,userId,deviceId,deviceName,versionRequested,versionUserAllocated,versionDeviceAllocated,time

  • udadmin -f XDT_ENT_UD -device dn01.88 -delete

    Libère une machine d’une fonctionnalité.