Commandes de licence

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 sur un ordinateur 32 bits
• C:\Program Files (x86)\Citrix\Licensing\LS sur un ordinateur 64 bits

Description des commandes

• 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/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 :

Arguments universels

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

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]]

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]

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

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]

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]

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
<!--NeedCopy-->

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

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]

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