Démarrer, installer et configurer le serveur de licences

Important :

• Nous ne prenons pas en charge l’exécution de démons de fournisseurs tiers sur le serveur de licences Citrix, ni le démon de fournisseur Citrix sur des serveurs de licences tiers.

• Nous vous recommandons d’exécuter la dernière version du serveur de licences. Nous ne fournissons pas de correctifs pour les composants du serveur de licences et ne prenons pas en charge les anciens serveurs de licences avec les nouveaux produits. La dernière version du serveur de licences contient souvent des résolutions aux problèmes apparus dans les versions antérieures. Lorsque vous mettez à niveau ou installez de nouveaux produits Citrix, mettez également à niveau les composants de gestion des licences. Les nouveaux serveurs de licences sont rétrocompatibles et prennent en charge les produits et fichiers de licences plus anciens. Cependant, les nouveaux produits nécessitent souvent le serveur de licences le plus récent pour extraire correctement les licences. Vous pouvez trouver la dernière version sur le site Téléchargements Citrix.

Pour connaître les nouvelles fonctionnalités de cette version, consultez Nouveautés.

• Nous ne prenons pas en charge l’installation du serveur de licences à partir d’un chemin UNC (\\\server\share). Installez le serveur de licences à partir d’une copie locale.

Étape 1 : Vérifiez vos prérequis

Avant de commencer à installer et à configurer votre serveur de licences, consultez la section Configuration système requise.

Étape 2 : Octroyez une licence à votre produit

L’octroi de licences à votre produit comprend les étapes suivantes :

1. Assurez-vous de disposer de la dernière version du serveur de licences.
2. Vérifiez la configuration système requise.
3. Installez les licences.
4. Obtenez les fichiers de licences depuis Mon compte ou, si vous disposez d’un code de licence, utilisez le gestionnaire de licences Citrix.
5. Installez votre produit Citrix (ou, s’il est déjà installé, redémarrez les produits Citrix pour que les nouvelles licences soient reconnues).
6. Configurez les paramètres de communication de licence côté produit qui n’ont pas été définis lors de l’installation du produit, le cas échéant. Cette configuration inclut la définition de l’édition de produit correcte dans le produit. Pour plus d’informations, consultez Éléments de licence et Services.

Assurez-vous que le paramètre d’édition côté produit correspond correctement aux licences que vous avez achetées. Par exemple, si vous avez acheté des licences d’édition Premium, assurez-vous que le paramètre d’édition dans le produit indique Premium et non Advanced.

• Pour un aperçu des composants et du processus de licence, consultez Présentation technique et Éléments de licence.

Important :

Le serveur de licences ne nécessite pas d’appartenance à un domaine. Vous pouvez installer le serveur de licences dans un groupe de travail et continuer à exécuter toutes les fonctions de licence pour le compte des produits Citrix. Pour gérer les utilisateurs du gestionnaire de licences Citrix ayant des utilisateurs ou des groupes Active Directory, les utilisateurs doivent faire partie d’un domaine. Sinon, utilisez des utilisateurs et des groupes Windows locaux.

• Étape 3 : Vérifiez votre sécurité et votre pare-feu

Considérations de sécurité

Nous vous recommandons de mettre à niveau le serveur de licences vers la dernière version lorsque vous mettez à niveau ou installez de nouveaux produits Citrix. Les nouveaux serveurs de licences sont rétrocompatibles et prennent en charge les produits et fichiers de licences plus anciens. Chaque fois qu’un nouveau serveur de licences est publié, il peut contenir de meilleures fonctionnalités de sécurité que les versions précédentes. Nous vous recommandons également les considérations de sécurité suivantes lors de la configuration de votre environnement.

• Configurez l’environnement du serveur de licences de manière à ce que seuls les administrateurs autorisés sur un réseau de confiance puissent accéder au port du gestionnaire de licences Citrix. Vous y parvenez en utilisant un pare-feu réseau ou basé sur l’hôte configuré de manière appropriée.
• Lorsque vous utilisez le gestionnaire de licences Citrix, évitez de visiter des sites Web non fiables ou de cliquer sur des URL non fiables.

Considérations relatives au pare-feu

Déterminez si vous avez besoin d’un pare-feu entre le serveur de licences et les serveurs de produits avant d’installer les licences. Les considérations relatives au pare-feu peuvent avoir un impact sur l’emplacement d’installation du serveur de licences.

Si vous disposez de pare-feu matériels dans votre environnement, vous devez créer les règles nécessaires manuellement.

S’il existe un pare-feu entre votre produit et le serveur de licences, configurez les numéros de port. Ce processus de configuration implique :

• Déterminer les numéros de port à modifier. Vous pouvez modifier les numéros de port pendant le processus d’installation ou après.
  • Ouvrir les ports du pare-feu. Ouvrez tous les ports du pare-feu que vous avez modifiés afin que le trafic puisse circuler. Les versions actuelles configurent automatiquement le pare-feu intégré.
  • Modifier les paramètres côté produit. Configurez votre produit Citrix pour qu’il utilise les mêmes numéros de port que ceux du gestionnaire de licences Citrix. Si vous ne modifiez pas le numéro de port référencé dans le produit, le produit ne pourra pas contacter le serveur de licences. Vous pouvez modifier les paramètres côté produit pendant et après l’installation du produit. Consultez la documentation de votre produit pour plus d’informations sur ces paramètres.

Pour plus d’informations sur l’autorisation des URL et des ports enregistrés via le pare-feu et une liste des URL ouvertes, consultez Enregistrer et annuler l’enregistrement auprès de Citrix Cloud.

Étape 4 : Installez les composants de licence, le serveur et le certificat

Lors de l’installation, des caractères localisés dans le chemin d’installation peuvent entraîner l’échec de l’installation. Acceptez le chemin d’installation par défaut ou saisissez uniquement des caractères alphabétiques ASCII pour le répertoire d’installation.

Étape 4A Installer les composants de licence

Vous pouvez installer les composants de licence sur un serveur séparé et dédié ou sur un serveur qu’ils partagent avec une autre application. Vous pouvez également utiliser un serveur web ou d’applications. Cependant, les emplacements mentionnés plus loin dans cet article sont moins gourmands en ressources. Si vous utilisez moins de 50 serveurs ou 10 000 licences, vous pouvez installer le serveur de licences sur le même serveur que votre produit. Pour déterminer si le déplacement du serveur de licences vers un autre système est nécessaire, surveillez la charge du processeur et de la mémoire (lmgrd.exe et CITRIX.exe).

-  > **Important :** > -  > -  > Utilisez le fichier `CitrixLicensing.exe` pour toutes les futures installations, à l'exception des déploiements Active Directory. Dans ce cas, utilisez le fichier .msi. Assurez-vous que les fichiers `.exe` et `.msi` sont tous deux présents pour l'installation.

• Étape 4B Installer le serveur de licences et la console à l’aide de l’interface graphique

• 1. Téléchargez le serveur de licences depuis Téléchargements Citrix et démarrez le programme d’installation du serveur de licences, CitrixLicensing.exe, en tant qu’administrateur ou membre du groupe Administrateurs.
     • 1. Suivez les instructions du programme d’installation sur l’interface graphique pour accepter le dossier de destination.
     • Les composants de licence sont installés dans C:\Program Files\Citrix\Licensing sur un ordinateur 32 bits et dans C:\Program Files (x86)\Citrix\Licensing sur un ordinateur 64 bits.
     • 1. Sur la page Configurer, acceptez ou modifiez les numéros de port par défaut utilisés par les composants de licence. Choisissez d’autoriser ou non le programme d’installation à configurer l’exception du Pare-feu Windows. Si nécessaire, vous pouvez modifier les numéros de port après l’installation. Si vous choisissez de terminer l’installation sans configurer le serveur de licences, redémarrez le programme d’installation CitrixLicensing.exe. Vous pouvez également utiliser l’outil de configuration du serveur de licences pour configurer les paramètres après l’installation. Ouvrez l’outil de configuration à partir de : C:\Program Files\Citrix\Licensing\LS\resource\Licensing.Configuration.Tool.exe.
     • Le numéro de port du serveur de licences est 27000
     • Le numéro de port du démon du fournisseur est 7279
     • Le numéro de port des services web pour les licences est 8083

1. Le serveur de licences ajoute l’administrateur par défaut pour Citrix Licensing Manager en fonction de la manière dont vous êtes connecté. Si vous êtes dans un domaine, le serveur de licences ajoute l’utilisateur qui effectue l’installation (domaine\utilisateur) en tant qu’administrateur par défaut du serveur de licences ou de Citrix Licensing Manager. Si vous êtes un utilisateur Windows local, le serveur de licences ajoute l’utilisateur qui effectue l’installation (ordinateur\utilisateur) en tant que compte administrateur par défaut. Le groupe BUILTIN\administrators, qui permet à tout administrateur de gérer les licences, est ajouté par défaut. Vous pouvez supprimer BUILTIN\administrators pour restreindre les licences à des utilisateurs spécifiques.
2. Choisissez de démarrer Citrix Licensing Manager et de participer ou non au programme d’amélioration de l’expérience client Citrix.

Étape 4C Installer les licences à l’aide de la ligne de commande Windows

Important :

• Le programme Citrix Service Provider™ nécessite le programme d’amélioration de l’expérience client (CEIP) et Call Home. Si vous êtes un fournisseur de services Citrix, vous ne pouvez pas désactiver le CEIP ou Call Home.

• Lorsque vous utilisez la commande CitrixLicensing.exe pour installer les licences, définissez les propriétés en ajoutant Propriété=valeur sur la ligne de commande, n’importe où, sauf entre une option et son argument.

• Assurez-vous d’exécuter la ligne de commande avec des privilèges d’administrateur. Pour démarrer l’invite de commandes avec des privilèges élevés, choisissez Démarrer, cliquez avec le bouton droit sur Invite de commandes, puis choisissez Exécuter en tant qu’administrateur.
• La ligne de commande d’exemple suivante installe les licences en mode silencieux. Ajoutez les propriétés que vous souhaitez définir.
  • Saisissez la commande sur une seule ligne, sans retour à la ligne. L’exemple suivant est sur plusieurs lignes en raison de limitations d’espace.

    <Configurations>
      <EncoreConfiguration>
        <SamplingPeriod>15</SamplingPeriod>
        <RetentionTime>180</RetentionTime>
        <Enabled>true</Enabled>
      </EncoreConfiguration>
-  <Proxy>10.211.55.5:808</Proxy>
    -  </Configurations>
<!--NeedCopy-->

Où :

-  **/quiet** spécifie une installation silencieuse.
-  **/l** spécifie l'emplacement du fichier journal

• INSTALLDIR est l’emplacement où l’exécutable du serveur de licences est stocké. Paramètre facultatif. La valeur par défaut est c:\program files\citrix\licensing ou c:\program files (x86)\citrix\licensing.
• WSLPORT est le numéro de port utilisé pour les services web de licences. Paramètre facultatif. La valeur par défaut est 8083.
• LSPORT est le numéro de port utilisé pour le serveur de licences. Paramètre facultatif. La valeur par défaut est 27000.
• VDPORT est le numéro de port utilisé pour le démon du fournisseur. Paramètre facultatif. La valeur par défaut est 7279.
• CEIPOPTIN spécifie si, et comment, participer au programme d’amélioration de l’expérience client (CEIP) de Citrix ou à Call Home. Paramètre facultatif. La valeur par défaut est ANON.
  • DIAG - Call Home
  • ANON - CEIP
  • NONE

Vous pouvez modifier le choix du CEIP et de Call Home à l’aide de Citrix Licensing Manager.

Utilisation de la ligne de commande pour installer les licences pour un déploiement Active Directory

Lorsque vous utilisez la commande msiexec pour installer les licences, définissez les propriétés en ajoutant Propriété=”valeur” sur la ligne de commande, n’importe où, sauf entre une option et son argument. Le clustering n’est pas pris en charge dans le fichier .msi.

Remarque :

Assurez-vous d’exécuter la ligne de commande avec des privilèges d’administrateur. Pour démarrer l’invite de commandes avec des privilèges élevés, choisissez Démarrer, cliquez avec le bouton droit sur Invite de commandes, puis choisissez Exécuter en tant qu’administrateur.

La ligne de commande d’exemple suivante installe les licences en mode silencieux et crée un fichier journal pour capturer toute information concernant cette opération. Ajoutez les propriétés que vous souhaitez définir après les commutateurs.

Saisissez la commande sur une seule ligne, sans retour à la ligne. L’exemple suivant est sur plusieurs lignes en raison de limitations d’espace.

[[CODE_BLOCK_1]]

Où :

• /l*v est l’emplacement du journal d’installation. Paramètre facultatif.
• /qn spécifie une installation silencieuse.
• INSTALLDIR est l’emplacement où l’exécutable du serveur de licences est stocké. Paramètre facultatif. La valeur par défaut est c:\program files\citrix\licensing ou c:\program files (x86)\citrix\licensing.
• LICSERVERPORT est le numéro de port utilisé pour le serveur de licences. Paramètre facultatif. La valeur par défaut est 27000.
• VENDORDAEMONPORT est le numéro de port utilisé pour le démon du fournisseur. Paramètre facultatif. La valeur par défaut est 7279.
• WEBSERVICESLICENSINGPORT est le numéro de port utilisé pour le Citrix Licensing Manager. Paramètre facultatif. La valeur par défaut est 8083.

• CEIPOPTIN spécifie si, et comment, participer au programme d’amélioration de l’expérience client (CEIP) de Citrix ou à Call Home. Paramètre facultatif. La valeur par défaut est ANON.

  • DIAG - Call Home
  • ANON - CEIP
  • NONE

Vous pouvez modifier le choix CEIP et Call Home à l’aide du Citrix Licensing Manager.

Utilisation de la ligne de commande pour désactiver ou activer le service de gestion des licences

Le service de gestion des licences fonctionne automatiquement au sein du serveur de licences et permet la gestion et le support des licences. Nous vous recommandons d’utiliser le service de gestion des licences pour gérer votre environnement de licences, mais vous pouvez le désactiver à tout moment après l’installation. Pour plus d’informations, consultez Citrix License Management Service dans Présentation technique.

Syntaxe :

    <Configurations>
      <EncoreConfiguration>
        <SamplingPeriod>15</SamplingPeriod>
        <RetentionTime>180</RetentionTime>
        <Enabled>true</Enabled>
      </EncoreConfiguration>
      <Proxy>10.211.55.5:808</Proxy>
    </Configurations>
<!--NeedCopy-->

Où :

• -enable active la gestion des licences. Le premier téléchargement vers Citrix a lieu sept jours après l’installation du serveur de licences.
• -disable désactive la gestion des licences. Nous vous recommandons d’utiliser le service de gestion des licences pour gérer votre environnement de licences.
• -query affiche la configuration actuelle.

Étape 4D Installer manuellement un certificat utilisé par le Citrix Licensing Manager et les services Web pour les licences

Remarque :

Utilisez cette procédure si vous ne souhaitez pas utiliser le certificat auto-signé généré lors de l’installation.

Pour installer un certificat, il y a trois étapes :

1. Obtenez un fichier .pfx, qui contient le certificat et la clé privée. Vous pouvez utiliser l’une des deux méthodes pour obtenir le fichier .pfx.
2. Extrayez le certificat et la clé privée du fichier .pfx.
3. Installez le certificat et la clé privée sur le serveur de licences.

Méthode 1 - Comment obtenir le fichier .pfx à l’aide d’un certificat de domaine

Connectez-vous à un serveur du domaine, ouvrez la console MMC et suivez ces étapes :

1. Créez un répertoire c:\ls_cert pour y stocker le fichier .pfx exporté.
2. Ajoutez le composant logiciel enfichable Certificats en sélectionnant Fichier > Ajouter/Supprimer un composant logiciel enfichable > Certificats > Compte d’ordinateur > Ordinateur local.

• 1. Dans le volet gauche, sous Certificats, cliquez avec le bouton droit sur Personnel et choisissez Toutes les tâches > Demander un nouveau certificat, puis Suivant.
• 1. Dans l’assistant Stratégie d’inscription de certificat, choisissez Stratégie d’inscription Active Directory, puis Suivant. Cochez la case en regard de Ordinateur et sélectionnez Détails à droite.

1. Sélectionnez Propriétés et, sous l’onglet Général, tapez un nom convivial et une description.
2. Sous l’onglet Objet, sous Type d’objet, choisissez Nom commun dans le menu Type. Tapez un nom convivial dans la zone de texte, choisissez Ajouter, puis Appliquer.
3. Sous l’onglet Extensions, choisissez Utilisation de la clé dans le menu, ajoutez Signature numérique et Chiffrement de clé à la zone d’options Sélectionné.
4. Dans le menu Utilisation améliorée de la clé, ajoutez Authentification du serveur et Authentification du client à la zone d’options Sélectionné.
5. Sous l’onglet Clé privée et dans le menu Options de clé, assurez-vous que la taille de la clé est de 2048. Cochez la case Clé exportable, puis Appliquer.
6. Sous l’onglet Autorité de certification, assurez-vous que la case CA est cochée, puis OK > Inscrire > Terminer.
7. Dans la console Certificats, sélectionnez Personnel > Certificats, choisissez le certificat que vous avez créé. Sélectionnez Toutes les tâches > Exporter > Suivant, puis sélectionnez le bouton radio Oui, exporter la clé privée, puis Suivant.
8. Sous Échange d’informations personnelles - PKCS #12(.PFX), cochez la case pour inclure tous les certificats, choisissez Suivant, créez un mot de passe, puis choisissez Suivant.
9. Cliquez sur Parcourir, accédez à C:\ls_cert et tapez server.PFX, puis suivez l’assistant pour terminer.

Méthode 2 - Comment obtenir le fichier .pfx en envoyant une demande à une autorité de certification (CA)

Ces étapes peuvent varier en fonction de votre autorité de certification.

1. Connectez-vous au serveur de licences, ouvrez la console MMC et suivez ces étapes :

   1. Ajoutez le composant logiciel enfichable Certificats en sélectionnant Fichier > Ajouter/Supprimer un composant logiciel enfichable > Certificats > Compte d’ordinateur > Ordinateur local.
   2. Dans le volet gauche, sous Certificats, cliquez avec le bouton droit sur Personnel et choisissez Toutes les tâches > Opérations avancées > Créer une demande personnalisée, puis Suivant.
   3. Dans l’assistant Stratégie d’inscription de certificat, choisissez Continuer sans stratégie d’inscription sous Demande personnalisée, puis Suivant.
   4. Sur l’écran Demande personnalisée, choisissez (Aucun modèle) Clé CNG dans le menu et PKCS#10 pour le format de demande, puis Suivant.
   5. Sur l’écran Informations sur le certificat, choisissez Détails, puis Propriétés.
   6. Sous l’onglet Général, tapez un nom convivial et une description.
   7. Sous l’onglet Objet, sous Nom de l’objet, choisissez Nom commun et tapez une valeur dans la zone de texte.
   8. Sous l’onglet Extensions, choisissez Utilisation de la clé dans le menu, ajoutez Signature numérique et Chiffrement de clé.
   9. Sous l’onglet Extensions, choisissez Utilisation améliorée de la clé dans le menu, ajoutez Authentification du serveur et Authentification du client.
   10. Sous l’onglet Clé privée, sous Fournisseur de services cryptographiques, choisissez RSA, Microsoft Software Key Storage Provider (par défaut). Dans le menu Options de clé, assurez-vous que la taille de la clé est de 2048, cochez la case Clé exportable, puis Appliquer.
   11. Enregistrez le fichier dans un fichier .req, soumettez le fichier .req à une autorité de certification (CA) et enregistrez le fichier .cer.
2. Dans la MMC, sous Certificats, cliquez avec le bouton droit sur Personnel et choisissez Toutes les tâches > Importer. Dans l’assistant d’importation, sélectionnez le fichier .cer.
3. Créez un répertoire c:\ls_cert pour contenir le fichier .pfx exporté.
4. Dans la console Certificats, choisissez Personnel > Certificats, puis choisissez le certificat que vous avez importé. Sélectionnez Toutes les tâches > Exporter > Suivant, puis sélectionnez le bouton radio Oui, exporter la clé privée et Suivant.
5. Sous Échange d’informations personnelles - PKCS #12(.PFX), cochez la case pour inclure tous les certificats, choisissez Suivant, créez un mot de passe, puis choisissez Suivant.
6. Choisissez Parcourir, accédez à C:\ls_cert et tapez server.PFX, puis suivez l’assistant pour terminer.

Comment extraire le certificat et la clé privée

Cette étape nécessite OpenSSL ou un autre outil permettant d’extraire le certificat et la clé privée d’un fichier .pfx. La version d’OpenSSL fournie avec le serveur de licences ne prend pas en charge l’extraction des certificats et des clés privées. Pour plus d’informations sur le téléchargement d’OpenSSL, accédez à www.openssl.org. Citrix recommande d’installer OpenSSL sur un poste de travail distinct pour effectuer ces étapes :

1. Accédez au dossier <openssl directory>\bin.
2. Exécutez openssl pkcs12 -in C:\ls_cert\server.pfx -out server.crt -nokeys

   Remarque :

   Le serveur de licences utilise uniquement le format de certificat .crt.

3. Saisissez le mot de passe créé lors du processus d’exportation (mot de passe).
4. Exécutez openssl pkcs12 -in C:\ls_cert\server.pfx -out server.key -nocerts -nodes
5. Saisissez le mot de passe créé lors du processus d’exportation (mot de passe).

Comment installer les fichiers .crt et .key sur le serveur de licences

Windows - Services Web pour les licences :

1. Arrêtez le service Citrix Web Services for Licensing.
2. Copiez les fichiers server.crt et server.key créés précédemment dans cette procédure vers c:\program files (x86)\citrix\licensing\WebServicesForLicensing\Apache\conf\.
3. Démarrez le service Citrix Web Services for Licensing.

Windows - Console d’administration des licences :

Remarque :

• La console d’administration des licences a été supprimée du serveur de licences Windows v11.16.6.0 build 31000 et versions ultérieures. Pour plus d’informations, consultez Nouveautés.
• Le serveur de licences VPX utilise toujours la console d’administration des licences.

1. Arrêtez le service de licences Citrix.
2. Copiez les fichiers server.crt et server.key créés précédemment dans cette procédure vers c:\Program Files (x86)\Citrix\Licensing\LS\conf.
3. Démarrez le service de licences Citrix.

Étape 5 Configurer un serveur proxy

Vous pouvez utiliser un proxy avec Citrix Licensing Manager, CEIP et Call Home. Lorsque vous configurez un serveur proxy, les requêtes de téléchargement de licences et de chargement des données Call Home sont envoyées via un serveur proxy.

Important :

Les composants de licences Citrix nécessitant des communications Web sortantes peuvent hériter des paramètres de proxy réseau à l’aide de la détection automatique de proxy Windows. Nous ne prenons pas en charge les proxys authentifiés. Pour plus d’informations sur la détection automatique de proxy Windows, consultez Fonctions WinHTTP AutoProxy.

Comment configurer un serveur proxy manuellement

1. Modifiez le fichier SimpleLicenseServiceConfig.xml, qui se trouve dans le répertoire <Citrix Licensing>\WebServicesForLicensing.
2. Ajoutez une ligne XML au fichier au format <Proxy>nom du serveur proxy:numéro de port</Proxy>

Important :

Les balises .xml sont sensibles à la casse.

    <Configurations>
      <EncoreConfiguration>
        <SamplingPeriod>15</SamplingPeriod>
        <RetentionTime>180</RetentionTime>
        <Enabled>true</Enabled>
      </EncoreConfiguration>
      <Proxy>10.211.55.5:808</Proxy>
    </Configurations>
<!--NeedCopy-->

Étapes suivantes

• Citrix Licensing Manager
• Guides de licences spécifiques aux produits