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 pour les 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 on a 32-bit computer
  • C:\\Program Files (x86)\\Citrix\\Licensing\\LS on a 64-bit computer

Description des commandes

  • lmadmin — Permet de configurer le système de licences. Utilisez la License Administration Console pour les tâches de configuration et d’administration des 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. La spécification de udadmin -export permet d’exporter les données utilisateur/machine non traitées. Ces données sont utilisées pour calculer l’utilisation des licences. Elles ne représentent pas une liste de licences en cours d’utilisation. 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, remplacez license_file_list par les noms d’un ou de plusieurs fichiers de licences.
[Crochets] Le texte entouré par des crochets indique les options que vous pouvez ajouter à la commande. Cela peut indiquer que le texte entre crochets doit ê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 licences : -c license_file_list Vous pouvez entrer plusieurs chemins de fichier de licences 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 [serveur] Si vous ne spécifiez pas de serveur, cet argument affiche l’état de tous les fichiers de licences répertoriés sur le serveur de licences ou les fichiers de licences sur tous les serveurs de licences.
-verbose Affiche une description de toutes les erreurs rencontrées.

Diagnostic des problèmes d’extraction (lmdiag)

La commande 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 cette commande est exécutée, elle tente d’extraire une licence.

Vous pouvez également utiliser la commande lmdiag pour voir si un type de licence spécifique fonctionne.

Exemple :

Exécutez uniquement lmdiag sur votre serveur Citrix Virtual Apps avec des licences d’édition Advanced. Spécifiez MPS\_ADV\_CCU comme argument.

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. La commande lmdiag affiche des informations sur la licence, puis tente d’extraire chaque licence. Lorsque l’extraction réussit, lmdiag indique que l’extraction a réussi. Lorsque l’extraction échoue, lmdiag indique la raison de l’échec. La commande lmdiag tente de se connecter à chaque port TCP/IP du serveur de licences. Elle 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.

La commande lmdiag ne contacte pas la machine exécutant le produit Citrix lors de la tentative d’extraction de licences. La commande 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, un serveur de licences qui ne possède pas de licences pour ce produit. La commande lmdiag signale qu’elle peut extraire les licences lorsque le produit Citrix pointe sur le serveur de licences incorrect.

Arrêter les démons (lmdown)

La commande lmdown arrête le démon License Manager et le démon vendeur Citrix sur votre serveur de licences ou tous les serveurs de licences de votre réseau. La commande lmdown est désactivée par défaut. Pour l’activer :

  1. Arrêtez le serveur de licences.
  2. Exécutez lmadmin - allowStopServer et -allowRemoteStop Server 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. Nous vous recommandons toujours 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.

Exécutez la commande lmdown 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 et que vous n’avez pas spécifié l’argument -all, la commande affiche un choix de serveurs de licences à arrêter. Par exemple, l’argument -c spécifie un répertoire contenant de nombreux fichiers *.lic. Arrêtez 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 le démon vendeur Citrix uniquement, 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ôte (lmhostid)

La commande lmhostid renvoie l’ID d’hôte du serveur de licences. Vous pouvez utiliser la commande pour 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 (bindingidentifier) Description
-ether Utilisé pour les licences de produit qui sont liées à l’adresse MAC de l’appliance.
-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 nom d’hôte 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 licences et d’options (lmreread)

La commande 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 et les nouvelles licences.

Vous ne pouvez pas utiliser lmreread à 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, cet argument ordonne la relecture de tous les démons License Manager.
-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)

La commande 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)

la commande 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.

La commande lmstat affiche les informations reçues du serveur de licences. La commande 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 vous ne spécifiez pas de fonctionnalité, les informations d’utilisation de toutes les fonctionnalités s’affichent.
-i [feature] Si vous ne spécifiez pas de fonctionnalité, cet argument affiche les informations de la ligne INCREMENT pour la fonctionnalité spécifiée (licence produit) ou toutes les fonctionnalités.
-s [server] Si vous ne spécifiez pas de serveur, cet argument affiche l’état de tous les fichiers de licences répertoriés sur le serveur de licences ou les fichiers de licences répertoriés sur tous les serveurs de licences.
-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. Cette valeur limite le temps que lmstat passe à tenter de se connecter au serveur de licences.

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.

La commande lmstat -c@localhost -a peut parfois générer un accroissement de l’activité réseau dans les systèmes sur lesquels 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)

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

Syntaxe :

lmver binary

Exemple :

lmver lmdiag

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

udadmin 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 uniquement lorsque :

  • L’employé n’est plus associé à l’entreprise.
  • L’employé est en congé prolongé.

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 non traitées dans un document .csv. Ces données sont utilisées pour calculer l’utilisation des licences. Elles ne représentent pas une liste de licences en cours d’utilisation. La première ligne est l’en-tête de colonne. La fonctionnalité, suivie de l’utilisateur constituent le format. Chaque (user,deviceId,versionRequested) unique est signalé sur une ligne. Les demandes de licence redondantes pour le même (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

    Usage data is 0 minutes old. Next update in 15 minutes.

    Users:

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

    Devices:

    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

    Lists all features, versions, counts of licenses, and the users and devices for each feature.

-  udadmin -export

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

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

    Releases one device from one feature.