Product Documentation

Format des fichiers de licences

Apr 08, 2013
Attention : 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, vous ne devez jamais modifier les fichiers de licences. Vous pouvez gérer les licences et les tâches qui leur sont associées via la console License Administration Console et le site My Account.
Les fichiers de licences Citrix suivent la convention suivante : license_FID_XDT-PLT-UD_25-mar-2013.lic.
Remarque : vous pouvez modifier le nom du fichier de licences mais vous devez préserver l'extension .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, etc.

Les sections suivantes offrent des informations approfondies sur les éléments suivants de syntaxe du fichier de licences : les lignes SERVER, VENDOR, USE_SERVER, INCREMENT et UPGRADE. 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 avec des numéros correspondants aux explications qui suivent l'exemple :


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 où le fichier de licences ne fonctionnera 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 [vendor_daemon_path]
Champ Description
VENDOR CITRIX Nom du démon vendeur Citrix. Ne modifiez pas ce nom.
vendor_daemon_path 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 ses données, les IDhôte indiqués aux lignes SERVER et des données sélectionnées par Citrix. Les lignes INCREMENT utilisent des barres obliques inverses ( \ ) pour couper de longues lignes de texte.
Syntaxe
INCREMENT fonctionnalité vendor date_expiration_SA date_exp nombre_lic \ SIGN=signature [attributs_facultatifs]
Attention : ne modifiez pas les six champs qui suivent le mot-clé de la ligne INCREMENT. Ils sont nécessaires et sont disposés selon un ordre immuable.
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.
SA_expiry_date Indique la date jusqu’à laquelle vous avez droit à des mises à niveau du produit. Si vous n’êtes pas adhérent au programme Subscription Advantage ou s’il ne s’agit pas d’une licence Subscription Advantage, 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 Subscription Advantage 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 Subscription Advantage
  • La deuxième date est la SA_expiry_date

Exemple :

INCREMENT MPS_ENT_CCU CITRIX 2005.0311 2007.0311 permanent 1000 \

Pour plus d’informations, veuillez consulter la section Lignes UPGRADE.

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 « 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.
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 nouveau 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
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 l'abonnement au programme Citrix Subscription Advantage s'affiche en rouge (format : AAAA.MMJJ)
  • Le nombre de licences (utilisateurs, connexions) s'affiche en VERT
Syntaxe
keyword=value
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 ..." 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 définie par Citrix.
Attributs facultatifs dans les lignes INCREMENT
Les lignes INCREMENT contiennent plusieurs attributs pouvant être ajoutés, modifiés ou supprimés. Il est également possible d'en ajouter. Par exemple, vous pouvez insérer un identificateur d'immobilisation ou un numéro de commande à côté de chaque licence dans un fichier. De même, vous pouvez ajouter des attributs désignant un groupe de licences attribué à un service dans votre société.
Certains peuvent avoir été insérés par Citrix ou par votre distributeur à valeur ajoutée.
Les attributs facultatifs sont répertoriés dans le tableau ci-dessous. Comme les attributs propres à Citrix, les attributs facultatifs ont une syntaxe de type keyword=value, keyword étant en minuscules. Vous pouvez établir la différence entre les attributs facultatifs et obligatoires en fonction de la casse : les attributs facultatifs ont des lettres en minuscule.
Attribut Description
asset_info= "..." Informations supplémentaires pouvant être ajoutées pour la gestion des immobilisations
dist_info= "..." Informations supplémentaires fournies par le distributeur de logiciel
user_info= "..." Informations supplémentaires fournies par l'administrateur de licences
vendor_info= "..." Informations supplémentaires fournies par Citrix

Lignes UPGRADE

Une ligne UPGRADE indique la date à laquelle une adhésion Subscription Advantage a été renouvelée et sa date d'expiration.
Attention : ne modifiez pas cette ligne.
Syntaxe
UPGRADE fonctionnalité CITRIX date_début_Subscription_Advantage date_renouvellement_Subscription_Advantagelic_num_date_exp \[options ... ] SIGN=signature
Toutes les données sont les mêmes pour la ligne INCREMENT, si ce n'est l'ajout du champ from_Subscription_Advantage_date. Une ligne UPGRADE permet de supprimer le nombre de licences spécifiées pour une ancienne version (>= from_Subscription_Advantage_date) et de créer une nouvelle version avec le même nombre de licences.
Exemple 1
Par exemple, les lignes suivantes renouvellent l’adhésion Subscription Advantage de la société ABCD pour 1 000 licences MPS_ENT_CCU pour une année (jusqu’au 11 mars 2006) :
 INCREMENT MPS_ENT_CCU CITRIX 2005.0311 permanent 1000 \ VENDOR_STRING=;LT=Retail;GP=96;CL=ENT,ADV,STD;SA=1;ODP=0 \ DUP_GROUP=V ISSUED=12-Mar-2004 NOTICE="ABCD Corporation" \ SN=LA-0000150712-12345:123 START=11-mar-2004 SIGN="1234567"
UPGRADE MPS_ENT_CCU CITRIX 2005.0311 2006.0311 permanent 1000 \ VENDOR_STRING=;LT=Retail;GP=96;CL=ENT,ADV,STD;SA=1;ODP=0 \ DUP_GROUP=V ISSUED=12-Mar-2005 NOTICE="ABCD Corporation" \ SN=RE-0000164638-12345:123 START=11-mar-2005 SIGN="1234567"
Exemple 2
Par exemple, les lignes suivantes renouvellent l’adhésion Subscription Advantage de la société ABCD pour 1 000 licences MPS_ENT_CCU pour une année (jusqu’au 11 mars 2006) :
 INCREMENT MPS_ENT_CCU CITRIX 2005.0311 permanent 1000 \ VENDOR_STRING=;LT=Retail;GP=96;CL=ENT,ADV,STD;SA=1;ODP=0 \ DUP_GROUP=V ISSUED=12-Mar-2004 NOTICE="ABCD Corporation" \ SN=LA-0000150712-12345:123 START=11-mar-2004 SIGN="1234567"
UPGRADE MPS_ENT_CCU CITRIX 2005.0311 2006.0311 permanent 1000 \ VENDOR_STRING=;LT=Retail;GP=96;CL=ENT,ADV,STD;SA=1;ODP=0 \ DUP_GROUP=V ISSUED=12-Mar-2005 NOTICE="ABCD Corporation" \ SN=RE-0000164638-12345:123 START=11-mar-2005 SIGN="1234567"
Une ligne UPGRADE s'applique à la ligne INCREMENT la précédant de plus près et dont la date Subscription Advantage est supérieure ou égale à from_Subscription_Advantage_date et inférieure à to_Subscription_Advantage_renewal_date.
Les lignes INCREMENT utilisent des barres obliques inverses ( \ ) pour couper de longues lignes de texte. Lorsque vous utilisez des fichiers de licences avec une ligne UPGRADE, conservez les fichiers de licences cités dans les lignes INCREMENT initiales dans le même dossier.