Fichiers de licences

Avant de commencer à installer des licences de produits, consultez les Conditions requises pour obtenir vos fichiers de licences.

Lorsque vous installez le serveur de licences, une licence de démarrage Citrix (citrix_startup.lic) et un fichier d’options (CITRIX.opt) sont installés par défaut. 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.

Licence de démarrage Citrix

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 pulsation pour vérifier le canal de communication. Lorsque le produit et le serveur de licences échangent des messages de pulsation mais que les communications sont interrompues, le produit entre en période de grâce. Une panne de courant est un exemple d’interruption. Le fichier de licences de démarrage n’affecte en rien le nombre de licences.

Citrix License Server Diagnostics License

Le serveur de licences utilise Citrix License Server Diagnostics License 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 licences 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. Pour plus d’informations, consultez Gérer les licences sur Citrix.com. Vous pouvez disposer de plusieurs fichiers de licences par serveur de licences. Le fichier de licences réside dans ces répertoires, où le serveur de licences lui fait référence.

  • 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

Le serveur de licences se sert de ce fichier pour déterminer s’il peut 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 le fichier 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 renvoyant et en les réattribuant.

Pour plus d’informations, consultez Modifier les licences.

Format des fichiers de licences

Important

Toute modification apportée au fichier de licences peut 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 et le site My Account à l’adresse citrix.com. Pour plus d’informations, consultez Gérer les licences dans My Account sur citrix.com.

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 :

FID_fulfillmentID.lic

Par exemple : FID_30d0000_0000_xxxx_c800_00xxyy000zz7.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.

L’image suivante est un exemple de fichier de licences :

  1. La ligne SERVER affiche un identificateur requis pour associer les licences au serveur de licences.
  2. La ligne VENDOR spécifie le nom du démon vendeur Citrix.
  3. Les lignes INCREMENT spécifient la licence requise pour utiliser un produit.
  4. Commentaires utilisés par le serveur de licences pour traduire les fonctionnalités (FEATURES) de licence (PRODUCT_EDITION_LICENSEMODEL) en noms de produits Citrix.

Exemple de fichier de licences

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 fonctionnera pas.

Syntaxe :

SERVER this_host ether

ou

SERVER this_host HOSTNAME=hostname

Paramètres Description
ether Adresse MAC de l’appliance 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

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.

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 éléments hostids spécifiés 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
exp_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, CSS_expiry_date figure dans la liste. Exemple : INCREMENT MPS_ENT_CCU CITRIX 2019.0311 permanent 1000
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 exp_date 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. Les licences de mise à niveau/maintenance ou Customer Success Services incluent SUPERSEDE_SIGN. 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. La console affiche et effectue le suivi d’un regroupement nouvellement créé 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 Les éléments importants ont les codes couleur suivants dans l’exemple précédent :

  • 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 Le numéro de série est le code d’accès aux licences et l’ID d’exécution de cette licence.
START=jj-mmm-aaaa Date à partir de laquelle vous pouvez commencer à utiliser une licence. Le serveur de licences ne peut pas utiliser de licences avant cette date. Vous pouvez installer des licences avant la date de début (START), mais elles ne sont pas visibles dans votre inventaire du serveur de licences avant la date de début réelle.
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"
<!--NeedCopy-->

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
<!--NeedCopy-->
Fichiers de licences