Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Installation d'une licence de production Les sections suivantes de cette rubrique décrivent comment acheter et utiliser une licence de production (licence perpétuelle ou abonnement). **Topics** + [Étape 1 : Installation du serveur RLM](#install-rlm) + [Étape 2 : obtenir l'ID d'hôte pour le serveur RLM](#hostid-rlm) + [Étape 3 : acheter la licence perpétuelle ou l'abonnement](#license-purchase) + [Étape 4 : modifier le fichier de licence](#setting-up-production-license-file) + [Étape 5 : configurer le serveur RLM](#setting-up-rlm-server) + [Étape 6 : Configuration du serveur Amazon DCV](#setting-up-dcv-server) ## Étape 1 : Installation du serveur RLM Lorsque vous achetez une licence perpétuelle ou un abonnement, vous obtenez un fichier de licence qui définit les termes de votre licence. Vous devez installer le fichier de licence sur un serveur RLM (Reprise License Manager). Pour en savoir plus sur RLM, consultez le site web [Reprise Software](https://reprisesoftware.com/products/reprise-license-manager-rlm/). **Topics** + [Installation du serveur RLM sous Windows](#install-rlm-windows) + [Installation du serveur RLM sous Linux](#install-rlm-linux) ### Installation du serveur RLM sous Windows **Pour installer le serveur RLM sous Windows** 1. Sur votre serveur RLM, téléchargez la solution groupée d'administration de licences RLM à partir du [site web Reprise Software](https://reprisesoftware.com/support/admin/license-administration-bundle/). **Note** À partir de la version 2022.1 d'Amazon DCV, le serveur RLM >= 14 est requis. Les versions précédentes nécessitent un RLM supérieur ou égal à 12. L'installation de la dernière version stable du bundle d'administration des licences RLM est recommandée. 1. Installez la solution d'administration de licences RLM sur `C:\RLM`. ### Installation du serveur RLM sous Linux **Pour installer le serveur RLM sous Linux** 1. Sur votre serveur RLM, téléchargez la solution groupée d'administration de licences RLM à partir du [site web Reprise Software](https://reprisesoftware.com/support/admin/license-administration-bundle/). **Note** À partir de la version 2022.1 d'Amazon DCV, le serveur RLM >= 14 est requis. Les versions précédentes nécessitent un RLM supérieur ou égal à 12. L'installation de la dernière version stable du bundle d'administration des licences RLM est recommandée. 1. Créer un groupe d'utilisateurs et un utilisateur `rlm`. Il peut s'agir de n'importe quel utilisateur ou compte de service valide. Nous vous recommandons vivement de ne pas utiliser le compte root pour cette valeur. ``` $ groupadd -r rlm ``` ``` $ useradd -r -g rlm -d "/opt/nice/rlm" -s /sbin/nologin -c "RLM License Server" rlm ``` 1. Créez les répertoires `/opt/nice/rlm/license` et `/opt/nice/rlm` requis pour le serveur RLM. ``` $ mkdir -p /opt/nice/rlm/license ``` 1. Extrayez le contenu de la solution groupée d'administration de licences RLM dans `/opt/nice/rlm/` et vérifiez que les fichiers appartiennent à l'utilisateur `rlm`. ``` $ tar xvf x64_l1.admin.tar.gz -C /opt/nice/rlm/ --strip-components 1 ``` ``` $ chown -R rlm:rlm /opt/nice/rlm ``` ## Étape 2 : obtenir l'ID d'hôte pour le serveur RLM Après avoir installé le serveur RLM, vous devez obtenir l'ID hôte du serveur RLM. Vous devez fournir cet identifiant d'hôte lors de l'achat d'une licence perpétuelle ou d'un abonnement. ### Obtenez l'ID d'hôte du serveur RLM sous Windows **Pour obtenir l'ID d'hôte du serveur, ouvrez l'invite de commande,** Accédez à `C:\RLM\`, puis exécutez la commande suivante. ``` C:\> rlmutil.exe rlmhostid ether ``` La commande renvoie l'ID d'hôte pour le serveur RLM comme suit. ``` Hostid of this machine: 06814example ``` Prenez note de l'identifiant de l'hôte. Vous en aurez besoin à l'étape suivante. ### Obtenez l'ID d'hôte du serveur RLM sous Linux **Pour obtenir l'ID d'hôte du serveur, retour unique** 1. Accédez à `/opt/nice/rlm/`. 1. Exécutez la commande suivante : ``` $ ./rlmutil rlmhostid ether ``` La commande renvoie l'ID d'hôte du serveur RLM pour chaque interface réseau comme suit. 1. Enregistrez l'ID d'hôte. Vous en aurez besoin à l'étape suivante. **Example** Cette procédure a été exécutée et l'identifiant unique suivant a été renvoyé : ``` Hostid of this machine: 0a1b2c3d4e5f ``` Cet identifiant est ensuite enregistré et sera utilisé pour acheter la licence DCV. **Pour obtenir l'ID d'hôte du serveur, plusieurs retours** 1. Accédez à `/opt/nice/rlm/`. 1. Exécutez la commande suivante : ``` $ ./rlmutil rlmhostid ether ``` Plusieurs IDs seront renvoyés dans une liste de IDs. 1. Exécutez la commande suivante. ``` iface=$(route -n | grep " UG " | tr -s " " | cut -d" " -f8) ip link show $iface | grep link/ether | tr -s " " | cut -d" " -f3 | tr -d ":" ``` La commande doit renvoyer l'ID d'hôte du serveur RLM pour l'interface réseau Gateway. 1. Enregistrez l'ID d'hôte. Vous en aurez besoin à l'étape suivante. **Example** La procédure a été exécutée et plusieurs IDs ont été renvoyés dans une liste de plusieurs identifiants : ``` Hostid of this machine: 0a1b2c3d4e5f 1b2c3d4e5f6a 2c3d4e5f6a7b 3d4e5f6a7b8c ``` La commande d'interface est exécutée et renvoie l'ID suivant : ``` Hostid of this machine: 0a1b2c3d4e5f ``` Cet identifiant est ensuite enregistré et sera utilisé pour acheter la licence DCV. ## Étape 3 : acheter la licence perpétuelle ou l'abonnement Pour plus d'informations sur l'achat d'une licence perpétuelle ou d'un abonnement Amazon DCV, consultez [Comment acheter](https://www.nice-software.com/index.html#buy) sur le site Web d'Amazon DCV et trouvez un distributeur ou un revendeur Amazon DCV dans votre région. Vous devez fournir l'ID d'hôte de votre serveur RLM. L'ID d'hôte est intégré au fichier de licence fourni par Amazon DCV. ## Étape 4 : modifier le fichier de licence Lorsque vous achetez une licence perpétuelle ou un abonnement Amazon DCV, vous recevez un `license.lic` fichier qui définit la licence. Le fichier `license.lic` inclut les informations suivantes : + Le nom d'hôte du serveur RLM. + L'ID d'hôte du serveur RLM que vous avez fourni lors de l'achat de la licence. + Numéro de port TCP du serveur RLM. La valeur par défaut est `5053`. + Numéro de port ISV. Il s'agit d'un port facultatif sur lequel le serveur RLM écoute les demandes de licence Amazon DCV. S'il n'est pas spécifié, un port aléatoire est sélectionné par RLM au démarrage. + Les produits Amazon DCV couverts par la licence, ainsi que les informations suivantes pour chaque produit : + Version majeure couverte par la licence (par exemple, `2017` pour les produits Amazon DCV 2017). + La date d'expiration. `Permanent`indique que la licence n'expire pas. + Nombre maximal de sessions simultanées (par exemple, `10` pour 10 sessions simultanées sur le serveur). + Le total de contrôle de la licence. + La signature de la licence. Le bloc de code suivant illustre le format du fichier `license.lic` : ``` HOST {{RLM_server_hostname}} {{RLM_server_host_id}} {{RLM_server_port}} ISV nice port={{port_number}} LICENSE {{product_1}} {{major_version}} {{expiration_date}} {{concurrent_sessions}} share=hi _ck={{checksum}} sig="{{signature}}" LICENSE {{product_2}} {{major_version}} {{expiration_date}} {{concurrent_sessions}} share=hi _ck={{checksum}} sig="{{signature}}" ``` Le bloc de code suivant montre un exemple de fichier `license.lic` avec le port ISV omis. Le fichier de licence inclut les licences de deux produits Amazon DCV, DCV et dcv-gl. ``` HOST My-RLM-server abcdef123456 5053 ISV nice LICENSE nice dcv 2017 permanent 10 share=hi _ck=456789098a sig="abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqrstuvwxyz1234567890ab" LICENSE nice dcv-gl 2017 permanent 10 share=hi _ck=123454323x sig="1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqrstuvwxyz12" ``` **Pour modifier le fichier `license.lic`** 1. Ouvrez le fichier dans l’éditeur de texte de votre choix. 1. Ajoutez le nom d'hôte de votre serveur RLM et le numéro de port TCP à la première ligne du fichier, qui commence par `HOST`. **Avertissement** {{RLM\_server\_host\_id}}Il s'agit de l'identifiant d'hôte que vous avez fourni lors de l'achat de la licence. Vous ne pouvez pas modifier le{{RLM\_server\_host\_id}}. 1. (Facultatif) Ajoutez le numéro de port ISV dans la ligne du fichier qui commence par`ISV`, en ajoutant`port={{port_number}}`. Ce port est nécessaire pour permettre la communication avec le serveur DCV. Si vous ne souhaitez pas spécifier de port ISV, `port={{port_number}}` omettez-le. Si vous ne spécifiez pas de port ISV, un port aléatoire est utilisé par RLM à chaque démarrage. **Avertissement** Si un pare-feu est configuré pour empêcher l'utilisation d'un port sélectionné au hasard, vous devez spécifier ce port et configurer le pare-feu pour l'activer, en plus du port RLM indiqué dans la `HOST` ligne. 1. Enregistrez et fermez le fichier . **Avertissement** La modification d'une autre partie de la licence endommage la signature du fichier et invalide la licence. ## Étape 5 : configurer le serveur RLM Après avoir modifié le fichier de licence, vous devez le placer sur votre serveur RLM, puis démarrer le service RLM. **Topics** + [Configurer le serveur RLM sur Windows](#prep-windows) + [Configuration du serveur RLM sous Linux](#prep-linux) ### Configurer le serveur RLM sur Windows **Pour configurer le serveur RLM sous Windows** 1. Connectez-vous à votre serveur RLM. 1. Copiez le fichier `license.lic` modifié dans `C:\RLM\license\`. 1. Copiez le `C:\Program Files\NICE\DCV\Server\license\nice.set` fichier depuis votre serveur Amazon DCV et placez-le dans le `C:\RLM\` dossier de votre serveur RLM. 1. Installez le serveur RLM en tant que service Windows. ``` C:\> rlm.exe -nows -dlog C:\RLM\rlm.log -c C:\RLM\license -install_service -service_name dcv-rlm ``` Pour plus d'informations sur les options de démarrage du RLM, consultez la page produit [Reprise Software License Manager (RLM)](https://reprisesoftware.com/products/reprise-license-manager-rlm/). 1. Démarrez le serveur RLM : ``` C:\> net start dcv-rlm ``` 1. Vérifiez que le serveur RLM est en cours d'exécution. 1. Ouvrez le fichier `C:\RLM\nice.dlog` avec l'éditeur de texte de votre choix et vérifiez qu'il contient la ligne suivante. ``` {{date_time}} (nice) Server started on license1 (hostid: {{host_id}}) for: dcv dcv-gl ``` **Note** Le contenu du fichier `rlm.log` peut varier légèrement selon la version du serveur RLM. 1. Exécutez la commande suivante. ``` C:\RLM\rlmutil rlmstat -a -c {{rlm_server_hostname}}@5053 ``` La commande renvoie des informations sur le serveur RLM. ### Configuration du serveur RLM sous Linux **Pour configurer le serveur RLM sous Linux** 1. Copiez le fichier `license.lic` modifié dans `/opt/nice/rlm/license/`. 1. Copiez le `/usr/share/dcv/license/nice.set` fichier depuis votre serveur Amazon DCV et placez-le `/opt/nice/rlm` sur votre serveur RLM. 1. Créez un service de serveur RLM et assurez-vous qu'il se lance automatiquement au démarrage. 1. Créez un fichier sous le nom `dcv-rlm` dans le dossier `/opt/nice/rlm/` : ``` $ touch /opt/nice/rlm/dcv-rlm ``` 1. Ouvrez le fichier à l'aide de l'éditeur de texte de votre choix et ajoutez le script suivant. Enregistrez et fermez le fichier . ``` #! /bin/sh # chkconfig: 35 99 01 # description: The Reprise License Manager daemon. # processname: dcv-rlm ### BEGIN INIT INFO # Provides: dcv-rlm # Required-Start: $local_fs $remote_fs $syslog # Required-Stop: $local_fs $remote_fs $syslog # Default-Start: 3 4 5 # Default-Stop: 0 1 2 6 # Short-Description: The Reprise License Manager daemon. # Description: A service that runs the Reprise License Manager daemon. ### END INIT INFO # user used to run the daemon RLM_USER="rlm" # root of rlm installation RLM_ROOT="/opt/nice/rlm" # license directory (license files should have .lic extension) RLM_LICENSE_DIR="/opt/nice/rlm/license" # log file RLM_LOG_FILE="/var/log/rlm.log" _getpid() { pidof -o $$ -o $PPID -o %PPID -x "$1" } start() { echo -n "Starting rlm: " touch ${RLM_LOG_FILE} chown "${RLM_USER}" ${RLM_LOG_FILE} su -p -s /bin/sh "${RLM_USER}" -c "${RLM_ROOT}/rlm -c ${RLM_LICENSE_DIR} \ -nows -dlog +${RLM_LOG_FILE} &" if [ $? -ne 0 ]; then echo "FAILED" return 1 fi echo "OK" } stop() { echo -n "Stopping rlm: " pid=`_getpid ${RLM_ROOT}/rlm` if [ -n "$pid" ]; then kill $pid >/dev/null 2>&1 sleep 3 if [ -d "/proc/$pid" ] ; then echo "FAILED" return 1 fi fi echo "OK" } status() { pid=`_getpid ${RLM_ROOT}/rlm` if [ -z "$pid" ]; then echo "rlm is stopped" return 3 fi echo "rlm (pid $pid) is running..." return 0 } restart() { stop start } case "$1" in start) start ;; stop) stop ;; status) status ;; restart) restart ;; *) echo $"Usage: $0 {start|stop|status|restart}" exit 1 esac exit $? # ex:ts=4:et: ``` 1. Rendez le script exécutable, copiez-le dans `/etc/init.d/`, puis ajoutez-le à l'utilitaire `chkconfig` : ``` chmod +x /opt/nice/rlm/dcv-rlm ``` ``` cp -a /opt/nice/rlm/dcv-rlm /etc/init.d/ ``` ``` chkconfig --add dcv-rlm ``` 1. Démarrez le serveur RLM : ``` $ service dcv-rlm start ``` 1. Vérifiez que le serveur RLM est en cours d'exécution et qu'il fonctionne comme prévu. Ouvrez le fichier `var/log/rlm.log` avec l'éditeur de texte de votre choix et vérifiez qu'il contient la ligne suivante : ``` {{date_time}} (nice) Server started on license1 (hostid: {{host_id}}) for: dcv dcv-gl ``` **Note** Le contenu du fichier `rlm.log` peut varier légèrement selon la version du serveur RLM. ## Étape 6 : Configuration du serveur Amazon DCV Configurez votre serveur Amazon DCV pour utiliser le serveur RLM. Pour ce faire, vous devez configurer le paramètre `license-file` de configuration sur votre serveur Amazon DCV. Le `license-file` paramètre doit être défini selon les spécifications du serveur RLM auquel se connecter, au format`{{RLM_server_port}}@{{RLM_server}}`. Le serveur RLM peut être spécifié sous forme de nom d'hôte ou d'adresse IP. S'il n'est pas configuré explicitement, le port du serveur RLM est utilisé par défaut`5053`. Si plusieurs serveurs RLM sont utilisés, vous pouvez spécifier une liste des spécifications de plusieurs serveurs RLM, séparées par sous `:` Linux et par `;` sous Windows. Le serveur essaiera ensuite de se connecter à chacun d'eux à tour de rôle, jusqu'à ce qu'une connexion puisse être établie avec le serveur RLM correspondant. Cela peut être particulièrement utile, par exemple, lors de l'utilisation d'un serveur de basculement RLM pour prendre le relais au cas où le serveur RLM principal ne serait pas accessible. Dans ce cas, vous pouvez spécifier la licence au format suivant : `{{RLM_primary_server_port}}@{{RLM_primary_server}}:{{RLM_failover_server_port}}@{{RLM_failover_server}}` **Note** Si le serveur Amazon DCV est installé sous Windows, vous devez séparer les entrées de la spécification par`;`. **Topics** + [Configuration du serveur Windows Amazon DCV](#config-win) + [Configuration du serveur Linux Amazon DCV](#config-linux) ### Configuration du serveur Windows Amazon DCV **Pour configurer le paramètre de configuration `license-file` sur un serveur Windows** 1. Ouvrez l’Éditeur du Registre Windows. 1. **Accédez à la **clé HKEY\_USERS \\ S-1-5-18 \\ Software \\ \\ com\\nicesoftware GSettings \\ dcv \\ license \\ et sélectionnez le paramètre du fichier** de licence.** S'il n'existe pas de paramètre `license-file` dans la clé de Registre, vous devez en créer un : 1. Ouvrez le menu contextuel (clic droit) pour la clé **licence** dans le volet de gauche, puis choisissez **Nouveau** et **Valeur chaîne**. 1. Pour **Nom**, saisissez `license-file` et appuyez sur **Entrée**. 1. Ouvrez le paramètre **license-file**. Pour **Données de la valeur**, saisissez le numéro de port et le nom d'hôte du serveur RLM au format `{{RLM_server_port}}@{{RLM_server}}`. Consultez la note ci-dessus si vous devez configurer une connexion à plusieurs serveurs RLM. 1. Choisissez **OK**, puis fermez l'Éditeur du Registre Windows. ### Configuration du serveur Linux Amazon DCV **Pour configurer le paramètre de configuration `license-file` sur un serveur Linux** 1. Accédez à `/etc/dcv/` et ouvrez `dcv.conf` avec l'éditeur de texte de votre choix. 1. Recherchez le paramètre `license-file` dans la section `[license]`. Remplacez ensuite le chemin existant par le port et le nom d'hôte du serveur RLM au `{{RLM_server_port}}@{{RLM_server}}` format. S'il n'existe pas de paramètre `license-file` dans la section `[license]`, ajoutez-le manuellement en respectant le format suivant : ``` license-file = "{{RLM_server_port}}@{{RLM_server}}" ``` Consultez la note ci-dessus si vous devez configurer une connexion à plusieurs serveurs RLM. 1. Enregistrez et fermez le fichier .