Product Documentation

Commandes d’administration de licences

Mar 16, 2015

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)\CCitrix\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. Voir lmver.
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.

Format des commandes de licence

Conventions des commandes d'administration de licences :
Convention Description
Gras Commande ou commutateur, tel que lmstat.
Italique Vous devez remplacer les variables avec une valeur ; par exemple, dans l'expression :

lmstat -cliste_fichiers_licences

Avant d'exécuter la commande, vous devez remplacer license_file_list par les noms d'un ou 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 d'accès spécifié : -c path

Pour les noms d'un ou plusieurs fichiers de licences : -c license_file_list

Vous pouvez saisir plusieurs chemins de fichiers de licences en séparant chaque chemin d'accès 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 aucun serveur n'est désigné.
-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 XenApp, licences édition Advanced uniquement en ajoutant l'argument MPS_ADV_CCU.

Syntaxe

lmdiag -c liste_fichiers_licences [-n] [fonctionnalité[:mot-clé=valeur]]
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 S'exécute en mode non interactif. lmdiag ne requiert aucune intervention dans ce mode.
feature Limite le retour d'informations à la fonctionnalité spécifiée.
keyword=value 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. En cas d'échec, lmdiag vous en fournit la raison. 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 liste_fichiers_licences, é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 (par exemple, sur un serveur de licences qui ne dispose pas de licence pour ce produit), mais lmdiag ne détecte pas ce problème. 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 liste_fichiers_licences [-vendor CITRIX] [-q] [-all]
Argument Description

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

Utilise les fichiers de licences spécifiés. Notez qu'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 “Are you sure? [y/n] : (Êtes-vous sûr ?) .”
-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 le nom du serveur de licences.

Remarque : si vous utilisez le Gestionnaire des tâches pour mettre fin au démon License Manager (service Citrix Licensing), 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 lmreread -c @localhost -vendor CITRIX to pour le redémarrer.

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 : le système de licences Citrix, version 11.5 et supérieure pour Windows vous permet d'afficher plusieurs ID d'hôte s'il existe plus d'un hôte.

Syntaxe

lmhostid –identificateurdeliaison
Argument (bindingidentifier) 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 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 licences 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 liste_fichiers_licence [-all] [-vendor CITRIX]
Argument Description

-c @localhost ou -c liste_fichiers_licences

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 @nom_point_accès_client
  • 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 autre_commande

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 du système de licences (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 liste_fichiers_licences] [-f [fonctionnalité]] [-i [fonctionnalité] [-s[serveur] [-S [CITRIX]] [-t valeur_délaiexpiration]
Argument Description
-a Affiche toutes les informations.
-c @localhost ou -c@server ou -c license_file_list Utilise les fichiers de licences spécifiés.
-f [feature] Affiche les produits utilisant une fonctionnalité (licence produit). Si aucune feature n'est 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 produit) ou pour toutes les fonctionnalités si aucune 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 aucun server n'est désigné.
-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 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 :
License server status: 27000@license_server1 License files on license_server1: C:\Program Files\Citrix\Licensing\MyFiles\citrix_startup.lic: C:\Program Files\Citrix\Licensing\MyFiles\citrixlic_20031001094430.lic: license_server1: license server UP (MASTER) v9.2 Vendor daemon status (on license_server1): CITRIX: UP v9.2 Feature usage info: Users of CITRIX: (Total of 5000 licenses issued; Total of 1 license in use) "CITRIX" v2002.0101, vendor: CITRIX floating license MPS mps_server1 MPS MPS_ENT_2004.0227 (v1.0) (license_server1/27000 101), start Tue 3/16 16:59 Users of MPS_ENT_CCU: (Total of 30 licenses issued; Total of 1 license in use) "MPS_ENT_CCU" v2004.1201, vendor: CITRIX floating license MPS mps_server1 MPS 25fb337e:MPSCLIENT (v2004.0227) (license_server1/27000 203), start Wed 3/17 11:56
Les informations de la ligne MPS_ENT_CCU de la sortie lmstat se décomposent de la façon suivante.
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.
Remarque : 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 la version des fichiers 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 binaire

Exemple

lmver lmdiag

Afficher ou libérer des licences pour des utilisateurs ou 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 : sachez que 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 | -list ]  
Options Description
-f featurename Utilisé en conjonction avec -list ou -delete, affiche ou libère uniquement l'utilisateur ou la machine pour le featurename spécifié.
-user username Libère la licence uniquement pour l'utilisateur spécifié par username.
-device devicename Libère la licence uniquement pour la machine spécifiée par devicename.
-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.
-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.
pas d'argument ou ? Affiche des informations d'utilisation pour la commande udadmin.

Exemples

  • udadmin -list

    Affiche tous les utilisateurs et toutes les machines.

  • 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 -f XDT_ENT_UD -user u8.08 -delete

    Libère un utilisateur d'une fonctionnalité.

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

    Libère une machine d'une fonctionnalité.