Commandes de gestion des licences

Bien que le Gestionnaire de licences Citrix offre une méthode simple pour accéder à de nombreuses fonctionnalités de gestion des licences, vous pouvez également effectuer des tâches de gestion des licences à l’aide de commandes. Vous pouvez utiliser les commandes d’administration des licences pour des 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’extraction à 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

Description des commandes de gestion des licences

Remarque :

Dans la version 11.16.6 build 34000 du serveur de licences, la gestion des utilisateurs existante lmadmin.exe est remplacée par la gestion des utilisateurs appartenant à Citrix lmgrd.exe. Assurez-vous de ne pas utiliser lmadmin.

Format des commandes de gestion des licences

Conventions de formatage pour les commandes d’administration des licences :

Arguments universels

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

Diagnostiquer les problèmes d’extraction (lmdiag)

La commande lmdiag vous permet de diagnostiquer les problèmes lorsqu’un produit ne peut pas extraire une licence. En particulier, vous pouvez vérifier si vos licences sont valides et si le serveur de licences est en cours d’exécution. Lorsque vous exécutez cette commande, elle tente d’extraire une licence.

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

Exemple :

Exécutez lmdiag uniquement sur les licences d’édition Advanced de votre serveur Citrix Virtual Apps™. Spécifiez MPS_ADV_CCU comme argument.

Syntaxe :

lmdiag -c liste_fichiers_licence [-n] [fonctionnalité[:mot_clé=valeur]]

Si aucune fonctionnalité n’est spécifiée, lmdiag opère sur toutes les fonctionnalités des fichiers de licence 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 été réussie. Lorsque l’extraction échoue, lmdiag vous donne 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 dans le fichier de licence est incorrect. lmdiag liste chaque numéro de port TCP/IP en écoute, et si -c liste_fichiers_licence est spécifié, diagnostique les fichiers spécifiés.

La commande lmdiag ne contacte pas l’ordinateur exécutant le produit Citrix lorsqu’elle tente d’extraire des licences. La commande lmdiag indique uniquement s’il y a des problèmes sur le serveur de licences. C’est-à-dire que votre produit ne peut pas extraire de licences parce qu’il pointe vers le mauvais 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 des licences lorsque le produit Citrix pointe vers le mauvais serveur de licences.

Arrêter les démons (lmdown)

La commande lmdown arrête le démon du gestionnaire de licences et le démon du fournisseur Citrix sur votre serveur de licences ou sur tous les serveurs de licences de votre réseau. La commande lmdown est désactivée par défaut.

Syntaxe :

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

Exécutez la commande lmdown sur un serveur de licences. Vous pouvez utiliser -all pour arrêter tous les serveurs de licences de votre réseau.

• Si lmdown détecte plusieurs serveurs et que vous n’avez pas spécifié l’argument -all, la commande affiche une liste 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 arrêter le démon du gestionnaire de licences (Service de licences Citrix), arrêtez d’abord le processus lmgrd, puis arrêtez le processus du démon fournisseur Citrix.

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

Vérifier les informations de liaison du serveur de licences (lmhostid)

La commande lmhostid renvoie l’ID d’hôte du serveur de licences. Vous pouvez utiliser cette commande pour vérifier le nom d’hôte de votre serveur de licences. Vous pouvez ouvrir un fichier de licences et comparer le nom d’hôte de ce fichier à celui de votre serveur de licences.

Remarque

Citrix Licensing, versions 11.5 et ultérieures pour Windows, vous permet d’afficher plusieurs ID d’hôte s’il y a plus d’un hôte.

• Syntaxe :

• lmhostid -bindingidentifier

• où bindingidentifier est l’argument.

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

La commande lmreread entraîne le démon fournisseur Citrix à relire les modifications apportées au fichier de licences et au fichier d’options. Après la relecture, le démon fournisseur Citrix utilise les nouveaux paramètres et 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]

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 de licences (lmutil)

La commande lmutil affiche une liste des utilitaires de licences lorsqu’elle est utilisée seule. Lorsque vous spécifiez lmutil avec une autre commande, elle exécute cette commande.

Syntaxe :

lmutil

lmutil other_command

Exemples :

• lmutil

  Affiche tous les utilitaires de licences.

• lmutil lmstat -c @localhost

  Exécute la commande lmstat.

Déterminer l’état des licences (lmstat)

La commande lmstat vous aide à surveiller l’état de toutes les activités de licences et vous fournit des informations sur les extractions de licences, notamment :

• Le produit qui a extrait une ou plusieurs licences
• 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
• Des informations sur l’état du démon fournisseur Citrix et les fichiers de licences

La commande lmstat affiche les informations qu’elle reçoit du serveur de licences. La commande lmstat n’affiche qu’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]

La sortie de lmstat -c @localhost -a ressemble à cet exemple. Les lignes de l’exemple peuvent être coupé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
<!--NeedCopy-->

Ce qui suit représente une ventilation des informations contenues dans la ligne MPS_ENT_CCU de la sortie lmstat :

La commande lmstat -c @localhost -a peut potentiellement générer une activité réseau importante dans les systèmes qui ont de nombreuses licences de produits extraites.

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

Afficher les versions des binaires (lmver)

La commande lmver affiche les informations de version pour les binaires de licence, tels que les utilitaires de commande.

Syntaxe :

lmver binary

Exemple :

lmver lmdiag

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

La commande udadmin affiche les utilisateurs et les appareils sous licence et libère les licences pour les utilisateurs et les appareils spécifiés.

Vous ne pouvez libérer une licence pour un utilisateur que lorsque :

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

Vous ne pouvez libérer des licences pour les appareils que lorsque les appareils sont hors service.

Attention :

Les libérations massives de licences, avant la période de location automatique de 90 jours, en dehors des raisons mentionnées précédemment, peuvent violer le CLUF Citrix. Avant de le faire, contactez Citrix.

L’aide en ligne de commande udadmin affiche les informations d’utilisation uniquement en anglais, mais vous pouvez utiliser la commande sur des systèmes non anglophones.

Syntaxe :

udadmin [-options] [-delete | -events | -export | -list | -times]

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.

<!--NeedCopy-->