Commandes de gestion des licences

Bien que la console d’administration des licences 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

• Descriptions des commandes

• lmadmin — Fournit la configuration des licences. Utilisez la console d’administration des licences pour les tâches de configuration et d’administration des licences. N’utilisez pas lmadmin.

• lmdiag — Diagnostique les problèmes d’extraction de licence.

• lmdown — Arrête proprement le gestionnaire de licences et les démons du fournisseur Citrix® (désactivé par défaut).

• lmhostid — Rapporte l’ID d’hôte du serveur sur lequel Citrix Licensing est en cours d’exécution.

• lmreread — Demande au démon du gestionnaire de licences de relire le fichier de licence et de démarrer le démon du fournisseur Citrix.

• lmstat — Affiche l’état d’un serveur de licences.

• lmutil — Affiche une liste d’utilitaires de gestion des licences ou exécute d’autres commandes.

• lmver — Affiche les informations de version des binaires de gestion des licences.

• udadmin — Affiche tous les utilisateurs et appareils sous licence et supprime les utilisateurs et appareils sous licence spécifiés. Cette commande s’applique uniquement aux licences utilisateur/appareil. La spécification de udadmin -export exporte les données utilisateur et appareil non traitées. Ces données sont utilisées pour calculer l’utilisation des licences et ne constituent pas une liste des licences en cours d’utilisation. Pour obtenir une liste des licences, spécifiez udadmin -list.

Format des commandes de licence

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 Advanced Edition de votre serveur Citrix Virtual Apps™. Spécifiez MPS_ADV_CCU comme argument.

Syntaxe :

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

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 réussi. 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 répertorie chaque numéro de port TCP/IP en écoute, et si -c license_file_list 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 contient 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. Pour l’activer :

1. Arrêtez le service 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]

• | – | – |

• -c license_file_list ou -c@localhost ou -c@server

  Utilise les fichiers de licence spécifiés. Nous recommandons toujours de spécifier -c license_file_list avec lmdown. Vous pouvez également utiliser : -c @localhost ou -c @server-name

• -vendor CITRIX	Arrête uniquement le démon du fournisseur Citrix. Le démon du gestionnaire de licences continue de fonctionner.
  -q	Ne demande pas de confirmation et n’affiche pas d’en-tête. Sinon, lmdown demande « Êtes-vous sûr ? [o/n] : ».
  -all	Si plusieurs serveurs sont spécifiés, les arrête tous automatiquement. -q est implicite avec -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 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 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 du fournisseur Citrix.

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

• Vérifier les noms d’hôte (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 licence et comparer le nom d’hôte du fichier de licence à 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

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

La commande lmreread force le démon du fournisseur Citrix à relire les modifications apportées au fichier de licence et au fichier d’options. Après la relecture, le démon du fournisseur Citrix utilise les nouveaux paramètres et licences à partir de ce moment.

Vous ne pouvez pas utiliser lmreread à distance ; exécutez-la 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 licence (lmutil)

La commande lmutil affiche une liste des utilitaires de licence 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 licence.

• 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 licence réseau 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 licence
• Le nom et le port du serveur de licences
• La date d’extraction de la licence
• Des informations sur l’état du démon du fournisseur Citrix et les fichiers de licence

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]

• -S [CITRIX]	Répertorie tous les serveurs de produits utilisant les fonctionnalités (licences de produit) fournies par le démon du fournisseur Citrix.
  -t timeout_value	Définit le délai d’expiration de la connexion à 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 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 où de nombreuses licences de produits sont 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 des binaires de licence, tels que les utilitaires de commande. 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 les utilisateurs ou les appareils (udadmin)

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 dans les cas suivants :

• 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, pourraient violer le CLUF Citrix. Avant de procéder, 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-->