Fichiers de licences

Lorsque vous installez le serveur de licences, une licence de démarrage et un fichier d’options sont installés automatiquement. Pour obtenir des licences pour vos produits Citrix, vous ajoutez un ou plusieurs fichiers de licences. Pour obtenir des informations sur l’ajout de vos licences de produit, consultez la section Installer des licences.

Vous ne pouvez pas modifier l’emplacement des fichiers de licences sur le serveur de licences. Ils doivent résider dans leur emplacement par défaut.

Fichier de licences de démarrage

Le fichier de licences de démarrage (citrix_startup.lic) est un fichier texte utilisé par les produits Citrix pour communiquer avec le serveur de licences au moyen d’une connexion constamment ouverte. Toutes les cinq minutes, le serveur de licences et le produit s’envoient des messages de battement de cœur pour vérifier le canal de communication. Lorsque le produit et le serveur de licences échangent des messages de battement de cœur mais que les communications sont interrompues, le produit entre en période de grâce. Une panne de courant est un exemple d’interruption. La licence de démarrage n’affecte en rien le nombre de licences.

Licence de diagnostics du serveur de licences CitrixlServeur

Le serveur de licences utilise Citrix License Server Diagnostics License|Server pour les diagnostics internes et les notifications de messages d’alerte affichées dans Studio et Director. Il est disponible par défaut avec la licence de démarrage dans le fichier citrix_startup.lic.

Avertissement

Ne modifiez ni le fichier de licence de démarrage, ni tout autre fichier de licences.

Fichier de licences

Le fichier de licences est un fichier texte contenant les éléments suivants :

  • Informations de licence du produit
  • Nom (ou un autre identificateur de liaison) du serveur de licences
  • Date de renouvellement de l’abonnement à Customer Success Services (également appelée Date d’expiration de Customer Success Services)
  • Date d’expiration de la licence (le cas échéant)
  • Autres informations système

Toutes ces informations sont cryptées avec une signature numérique. Lorsque vous faites l’acquisition d’un produit Citrix, téléchargez un fichier de licences à partir du site Web citrix.com. Vous pouvez disposer de plusieurs fichiers de licences par serveur de licences. Le fichier de licences se trouve dans le répertoire

  • Répertoire C:\Program Files\Citrix\Licensing\MyFiles sur un serveur 32 bits
  • Répertoire C:\ProgramFiles(x86)\Citrix\Licensing\MyFiles sur un serveur 64 bits
  • Répertoire /opt/citrix/licensing/myfiles pour un serveur de licences VPX

Où le serveur de licences lui fait référence. Le serveur de licences se sert de ce fichier pour déterminer s’il peut ou non accorder une licence à un produit Citrix.

Un découvert de licences est inclus dans toutes les licences utilisateur/machine, par utilisateur et par machine. Pour plus d’informations à propos du découvert de licences, consultez la section Découvert de licences.

Déplacer les licences vers un hôte différent

Vous ne pouvez pas utiliser les fichiers de licences téléchargés pour l’ancien serveur de licences vers un serveur qui a un nom d’hôte ou une adresse MAC différent(e). Créez des fichiers de licences faisant référence au nouveau nom du serveur en les réattribuant.

Pour de plus amples informations, consultez la section Réallouer des fichiers de licences.

Format des fichiers de licences

Important

les modifications peuvent rendre les fichiers de licences inutilisables. Si vous utilisez le système de licences Citrix pour Windows 11.6.1 ou version supérieure, modifier les fichiers de licences n’est pas nécessaire. Vous pouvez gérer les licences via Citrix Licensing Manager, la console License Administration Console et le site My Account.

Vous pouvez modifier le nom du fichier de licences mais vous devez préserver l’extension .lic (en minuscules).

Les fichiers de licences Citrix suivent la convention suivante : license_FID_XDT-PLT-UD_25-mar-2013.lic.

Chaque ligne d’un fichier de licences fournit une information spécifique : nom de serveur (SERVER), quantité de licences (INCREMENT), etc. Une ligne commence par un mot-clé, en majuscules, qui identifie sa fonction : VENDOR, SERVER, INCREMENT, USE_SERVER.

Les sections suivantes offrent des informations approfondies sur les éléments suivants de syntaxe du fichier de licences : les lignes SERVER, VENDOR, USE_SERVER et INCREMENT. Bien que le terme fonctionnalité soit utilisé dans la syntaxe des fichiers d’option et de licences, licence produit est préféré dans ce guide, dans la mesure du possible, par soucis de clarté.

Exemple de fichier de licences affichant des numéros correspondants aux explications qui suivent l’exemple :

Exemple de fichier de licences

1 - Ligne SERVER

Ligne SERVER : la ligne SERVER spécifie l’identificateur de liaison (appelé également hostname) du serveur de licences.

Attention : ne modifiez pas l’identificateur de liaison de la ligne SERVER. Sinon, le fichier de licences ne fonctionne pas.

Syntaxe :

SERVER this_host ether

Ou

SERVER this_host HOSTNAME=hostname

Paramètres Description
ether Adresse MAC du boîtier sur lequel le serveur de licences est exécuté. Ne pas modifier.
hostname Nom de l’ordinateur sur lequel le serveur de licences est exécuté. Ne pas modifier.

Exemple

SERVER this\_host HOSTNAME=license\_server1

2 - Ligne VENDOR

La ligne VENDOR spécifie le nom du démon vendeur Citrix.

Syntaxe :

VENDOR CITRIX [chemin_démon_vendeur]

Champ Description
VENDOR CITRIX Nom du démon vendeur Citrix. Ne modifiez pas ce nom.
chemin_démon_vendeur Chemin d’accès de l’exécutable du démon vendeur Citrix. Citrix vous recommande de ne pas modifier ce chemin.

3 - Lignes INCREMENT

La ligne INCREMENT décrit les licences nécessaires à l’utilisation d’un produit. Les fichiers de licences (*.lic) contiennent une ligne INCREMENT ou plus. Chaque ligne INCREMENT constitue une allocation spécifiée par l’utilisateur pour le nombre de produits et de licences (utilisateurs, connexions).

Chaque ligne INCREMENT contient :

  • Une signature basée sur les données de cette ligne
  • Les hostids spécifiées dans une ou plusieurs lignes SERVER
  • Données sélectionnées par Citrix

Les lignes INCREMENT utilisent des barres obliques inverses ( \ ) pour couper de longues lignes de texte.

Syntaxe :

INCREMENT feature vendor css_expiry_date exp_date num_lic \ SIGN=sign [optional_attributes]

Attention :

ne modifiez pas les six champs qui suivent le mot-clé de la ligne INCREMENT. Les champs sont obligatoires et ont un ordre fixe.

Le tableau suivant explique ces champs dans leur ordre d’apparition.

Champ Description
feature La licence du produit. Ne modifiez pas cette ligne.
vendor Indique que la licence est destinée au démon vendeur Citrix. Ne modifiez pas cette ligne.
CSS_expiry_date Indique la date jusqu’à laquelle vous avez droit à des mises à niveau du produit. Si vous n’êtes pas adhérent au programme Customer Success Services ou s’il ne s’agit pas d’une licence Customer Success Services, la date indique quand vous avez commandé ou activé la licence. Ne modifiez pas cette ligne. Remarque : si vous avez renouvelé votre adhésion au programme Customer Success Services et reçu une licence de mise à niveau, deux dates figurent dans la liste. La première date correspond à la date d’adhésion initiale au programme Customer Success Services La deuxième date est la CC_expiry_date. Exemple : INCREMENT MPS_ENT_CCU CITRIX 2005.0311 2007.0311 permanent 1000 \
exp_date Date d’expiration de licence au format jj-mmm-aaaa, c’est-à-dire, 07-mai-2006. Ne modifiez pas cette ligne. Remarque : si le champ date_exp contient la chaîne de texte permanent, la licence n’expire jamais.
num_lic Nombre de licences Utilisateurs simultanés pour cette licence produit. Ne modifiez pas cette ligne.
SIGN=sign SIGN= signature permettant d’authentifier cette ligne INCREMENT. Ne modifiez pas cette ligne.
SUPERSEDE_SIGN=sign Désactive stratégiquement des licences spécifiques en fonction de la fonctionnalité et signature de licence ou de la ligne INCREMENT à désactiver. Exemple : SUPERSEDE_SIGN={“CBR_100_SSERVER:0F76 2946 4790 6B67 08E0 65BC 302B E1B6 6ECE 41D6 8AB6 E9C6 FE44 4EB3 9A83 01E4 D405 3E95 74B8 9BC8 7791 BDD3 1385 33F8 9533 95FF A3E4 F461 35B4 251E”}

Les lignes INCREMENT déterminent également des groupes de licences dans la console de gestion. Ces groupes sont connus sous le nom de regroupements de licences. Le démon vendeur Citrix crée des regroupements de licences en fonction d’attributs communs, tels que la licence ou la version du produit. Lorsqu’un nouveau regroupement est créé, la console l’affiche et effectue son suivi indépendamment des autres regroupements de licences. Lorsque deux ou trois attributs diffèrent, le démon vendeur Citrix crée un regroupement de licences.

Attributs Citrix dans les lignes INCREMENT

Les lignes INCREMENT peuvent également inclure des attributs supplémentaires provenant de Citrix. Ces attributs fournissent des informations à propos de la licence, notamment la date d’émission ou s’il s’agit d’une licence de mise à niveau.

Attention :

vous ne devez ni modifier ni supprimer ces attributs.

Exemple : Ligne INCREMENT Dans l’exemple ci-dessus, les éléments importants ont les codes couleur suivants :

  • Le produit (fonction licence) s’affiche en bleu.
  • La date d’expiration de Customer Success Services s’affiche en rouge (Format : AAAA.MMDD).
  • Le nombre de licences (utilisateurs, connexions) s’affiche en VERT.

Syntaxe :

keyword=valeur

Le tableau suivant énumère les attributs Citrix. Les lettres majuscules indiquent qu’un attribut n’est pas modifiable.

Attribut Description
DUP_GROUP=V Cet attribut permet le partage de licence sur une même machine cliente.
ISSUED=dd-mmm-yyyy Date d’émission.
ISSUER=”…” Fournisseur de la licence.
NOTICE=”…” Nom de votre société.
SN=serial_num Numéro utilisé pour identifier les lignes INCREMENT.
START=jj-mmm-aaaa Date à partir de laquelle la licence est utilisable. Le serveur de licences ne peut pas utiliser de licences avant cette date.
SUPERSEDE=”MPS_ADV_CCU MPS_STD_CCU …” Cet attribut apparaît dans le fichier de licences de mise à niveau lors du passage à une édition supérieure. Dans ce cas, toutes les licences émises avant la date indiquée dans ISSUED= sont remplacées par cette ligne et sont désormais ignorées.
VENDOR_STRING=”…” Chaîne de texte définie par Citrix.

Exemple de licence de base :

INCREMENT CBR_100_SSERVER CITRIX 2016.1201 permanent 10 \\

   VENDOR_STRING=;LT=Retail;GP=720;MAXBW=1;MLC=0;HA=0;CL=BRSE;SA=1;ODP=0 \\

   DUP_GROUP=V ISSUED=18-dec-2005 NOTICE="Citrix" \\

   SN=100se200seB SIGN="1B19 C213 7517 CC62 756F 864C 9C93 06FC \\

   E1DE B5D5 D793"

Exemple de licence de renouvellement de Customer Success Services contenant SUPERSEDE_SIGN :

INCREMENT CBR_100_SSERVER CITRIX 2017.1201 permanent 10 \\

   VENDOR_STRING=;LT=Retail;GP=720;MAXBW=2;MLC=0;HA=0;CL=BRSE;SA=1;ODP=0 \\

   DUP_GROUP=V ISSUED=18-dec-2007 NOTICE="Citrix" \\

   SN=100se200seU SUPERSEDE_SIGN={"CBR_100_SSERVER:1B19 C213 7517 \\

   CC62 756F 864C 9C93 06FC E1DE B5D5 D793"} SIGN="1D5D 869A 40BE \\

   D4DB 361D 7897 AFA5 FF8B E52A 20BA 5525 01AA F241 6919