ONYX - 9.0 - Installation - Guide d'installation de ONYX Serveur de licence
Différence entre versions
(→Configuration du client) |
|||
(25 révisions intermédiaires par 3 utilisateurs non affichées) | |||
Ligne 1 : | Ligne 1 : | ||
− | L'utilisation d'un serveur de licence remplace | + | <languages/> |
+ | <translate> | ||
+ | <!--T:1--> | ||
+ | L'utilisation d'un serveur de licence remplace l'utilisation des clés traditionnelles (contractées auprès de Mapping).<br/> | ||
Il permet à des serveurs ONYX d'obtenir leur licence à la demande.<br/> | Il permet à des serveurs ONYX d'obtenir leur licence à la demande.<br/> | ||
Par exemple, cela peut permettre de gérer un parc de serveurs ONYX pouvant se mettre à l'échelle en fonction du besoin instantané. | Par exemple, cela peut permettre de gérer un parc de serveurs ONYX pouvant se mettre à l'échelle en fonction du besoin instantané. | ||
+ | <!--T:2--> | ||
Un serveur de licences est un serveur centralisé devant rester accessible à l'ensemble des machines du parc.<br/> | Un serveur de licences est un serveur centralisé devant rester accessible à l'ensemble des machines du parc.<br/> | ||
Chaque serveur ONYX s'y rattache comme client. | Chaque serveur ONYX s'y rattache comme client. | ||
− | =='''Serveur''' de licences== | + | =='''Serveur''' de licences== <!--T:3--> |
− | Il détient des clés mapping et les | + | <!--T:4--> |
+ | Il détient des clés mapping et les distribue aux clients qui lui en font la demande.</br> | ||
− | ===Installation=== | + | ===Installation=== <!--T:5--> |
==== Linux==== | ==== Linux==== | ||
===== Prérequis ===== | ===== Prérequis ===== | ||
Sur le serveur d'installation, il faut avoir installé et être à jour des librairies suivantes : | Sur le serveur d'installation, il faut avoir installé et être à jour des librairies suivantes : | ||
− | * openssl1.0 (ou | + | * ''openssl1.0'' (ou équivalent, le binaire recherché est ''libcrypto.so.1'') |
− | * libcap-progs (ou libcap2-bin sur certains | + | * ''libcap-progs'' (ou libcap2-bin sur certains systèmes) |
− | ===== Etapes ===== | + | ===== Etapes ===== <!--T:6--> |
− | Le serveur de licence est fourni sous la forme d'un fichier .tar.gz | + | Le serveur de licence est fourni sous la forme d'un fichier ''.tar.gz'' |
− | # Décompresser le fichier : tar -xvf Setup_LicenseServer_linux_xxxxxxxxx.tar.gz | + | <!--T:7--> |
− | # Lancer le script install.sh (avec les droits root) | + | # Décompresser le fichier : <code>tar -xvf Setup_LicenseServer_linux_xxxxxxxxx.tar.gz</code> |
+ | # Lancer le script <code>install.sh</code> (avec les droits root) | ||
# Suivre les instructions | # Suivre les instructions | ||
+ | L'installation va créer un utilisateur ''mapadmin'' s'il n'existe pas. | ||
+ | <!--T:8--> | ||
Extrait d'une installation classique : | Extrait d'une installation classique : | ||
Where do you want to install the application? [/apps/M-LicenseServer/] | Where do you want to install the application? [/apps/M-LicenseServer/] | ||
− | > | + | > /apps/M-LicenseServer/ |
Installation directory: /apps/M-LicenseServer/ | Installation directory: /apps/M-LicenseServer/ | ||
same for data directory: /apps/M-LicenseServer/ | same for data directory: /apps/M-LicenseServer/ | ||
Which listening port for this server? [2005] | Which listening port for this server? [2005] | ||
− | > | + | > 2005 |
Listening port: 2005 | Listening port: 2005 | ||
− | The application was | + | The application was successfully installed! |
Do you want to start the service now? [Y/n] | Do you want to start the service now? [Y/n] | ||
− | > | + | > Y |
Starting M-LicenseServer... | Starting M-LicenseServer... | ||
done. | done. | ||
Service started. | Service started. | ||
− | ===Saisie de clés serveur=== | + | ===Saisie de clés serveur=== <!--T:9--> |
Pour activer le serveur de licence, il convient de saisir les clés (fournies par Mapping), via la commande suivante : | Pour activer le serveur de licence, il convient de saisir les clés (fournies par Mapping), via la commande suivante : | ||
M-LicenseServer -key | M-LicenseServer -key | ||
+ | <!--T:10--> | ||
L'interface propose alors de saisir les clés : | L'interface propose alors de saisir les clés : | ||
Your serial number: DEADD00D | Your serial number: DEADD00D | ||
Ligne 54 : | Ligne 63 : | ||
Enter the key: | Enter the key: | ||
+ | <!--T:11--> | ||
Les informations "numéro de série" et "type de processeur" sont à transmettre à Mapping afin d'obtenir les clés permettant d'activer le serveur. | Les informations "numéro de série" et "type de processeur" sont à transmettre à Mapping afin d'obtenir les clés permettant d'activer le serveur. | ||
− | ===Lancement en mode service=== | + | Attention : les clés dédiées aux serveurs de licence doivent absolument être définies pour 65000 serveurs (devices) maximum. |
+ | |||
+ | ===Lancement en mode service=== <!--T:12--> | ||
==== Linux==== | ==== Linux==== | ||
systemctl start M-LicenseServer | systemctl start M-LicenseServer | ||
+ | |||
+ | Il existe également les actions ''stop'', ''restart'' et ''status''. | ||
+ | |||
==== Windows==== | ==== Windows==== | ||
Un nouveau point d'entrée intitulé <code>Mapping Licence server</code> a été créé dans la liste des services de l'OS. | Un nouveau point d'entrée intitulé <code>Mapping Licence server</code> a été créé dans la liste des services de l'OS. | ||
− | ===Lancement en mode interactif=== | + | ===Lancement en mode interactif=== <!--T:13--> |
− | + | Le mode de lancement interactif est conseillé, par exemple, sur un conteneur Docker : | |
M-LicenseServer -debug | M-LicenseServer -debug | ||
+ | <!--T:14--> | ||
Ce mode ne rend pas la main. | Ce mode ne rend pas la main. | ||
− | ===Configuration=== | + | ===Configuration=== <!--T:15--> |
====Linux==== | ====Linux==== | ||
− | L'emplacement du fichier de configuration (mapping.conf) | + | L'emplacement du fichier de configuration (mapping.conf) est indiqué dans le fichier <code>/etc/mappinglstab</code> |
− | ====Windows==== | + | ====Windows==== <!--T:16--> |
− | L'emplacement du fichier de configuration (mapping.conf) | + | L'emplacement du fichier de configuration (mapping.conf) est indiqué dans la base de registre : |
− | HKLM\SOFTWARE | + | HKLM\SOFTWARE\Mapping\Licence server\ConfigFileFullpath |
+ | (Ou à un emplacement similaire comme WOW6432Node, HKCU...) | ||
+ | =='''Client''' (ONYX Server) ayant besoin d'une clé== <!--T:17--> | ||
+ | Le rôle de réclamer une clé est affecté à un binaire spécifique : '''LicenseRequester'''. | ||
− | + | <!--T:18--> | |
− | |||
Ce binaire est fourni avec l'ensemble des binaires Mapping. | Ce binaire est fourni avec l'ensemble des binaires Mapping. | ||
− | + | ===Configuration du client=== <!--T:19--> | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | ===Configuration du client=== | ||
La configuration du client se trouve dans le même fichier de configuration (mapping.conf) que les autres modules ONYX Server. | La configuration du client se trouve dans le même fichier de configuration (mapping.conf) que les autres modules ONYX Server. | ||
+ | <!--T:20--> | ||
Pour activer l'utilisation d'un serveur de licence au niveau du client, il suffit d'ajouter le bloc suivant dans le fichier mapping.conf : | Pour activer l'utilisation d'un serveur de licence au niveau du client, il suffit d'ajouter le bloc suivant dans le fichier mapping.conf : | ||
<block name="LICENSESSERVER"> | <block name="LICENSESSERVER"> | ||
Ligne 101 : | Ligne 114 : | ||
</block> | </block> | ||
+ | <!--T:21--> | ||
Et renseigner les éléments suivants : | Et renseigner les éléments suivants : | ||
− | * LICENSE_SERVER : ON (permet d'activer le mode serveur de licence) | + | * <code>LICENSE_SERVER</code> : ON/OFF (permet d'activer ou non le mode serveur de licence) |
− | * LICENSE_SERVER_IP : adresse IP du serveur de licence (ne fonctionne pas avec une adresse DNS) | + | * <code>LICENSE_SERVER_IP</code> : adresse IP du serveur de licence (ne fonctionne pas avec une adresse DNS) |
− | * LICENSE_SERVER_PORT : port d'écoute du serveur de licence. | + | * <code>LICENSE_SERVER_PORT</code> : port d'écoute du serveur de licence. |
+ | |||
+ | ===Execution=== <!--T:22--> | ||
+ | '''LicenseRequester''' est invoqué automatiquement dès lors qu'un module Mapping a besoin d'une clé pour fonctionner. | ||
+ | |||
+ | <!--T:23--> | ||
+ | Cependant, il est également possible de lancer manuellement une demande de clés : | ||
+ | LicenseRequester -claim | ||
+ | </translate> |
Version actuelle datée du 2 janvier 2020 à 15:50
L'utilisation d'un serveur de licence remplace l'utilisation des clés traditionnelles (contractées auprès de Mapping).
Il permet à des serveurs ONYX d'obtenir leur licence à la demande.
Par exemple, cela peut permettre de gérer un parc de serveurs ONYX pouvant se mettre à l'échelle en fonction du besoin instantané.
Un serveur de licences est un serveur centralisé devant rester accessible à l'ensemble des machines du parc.
Chaque serveur ONYX s'y rattache comme client.
Serveur de licences
Il détient des clés mapping et les distribue aux clients qui lui en font la demande.
Installation
Linux
Prérequis
Sur le serveur d'installation, il faut avoir installé et être à jour des librairies suivantes :
- openssl1.0 (ou équivalent, le binaire recherché est libcrypto.so.1)
- libcap-progs (ou libcap2-bin sur certains systèmes)
Etapes
Le serveur de licence est fourni sous la forme d'un fichier .tar.gz
- Décompresser le fichier :
tar -xvf Setup_LicenseServer_linux_xxxxxxxxx.tar.gz
- Lancer le script
install.sh
(avec les droits root) - Suivre les instructions
L'installation va créer un utilisateur mapadmin s'il n'existe pas.
Extrait d'une installation classique :
Where do you want to install the application? [/apps/M-LicenseServer/] > /apps/M-LicenseServer/ Installation directory: /apps/M-LicenseServer/ same for data directory: /apps/M-LicenseServer/ Which listening port for this server? [2005] > 2005 Listening port: 2005 The application was successfully installed! Do you want to start the service now? [Y/n] > Y Starting M-LicenseServer... done. Service started.
Saisie de clés serveur
Pour activer le serveur de licence, il convient de saisir les clés (fournies par Mapping), via la commande suivante :
M-LicenseServer -key
L'interface propose alors de saisir les clés :
Your serial number: DEADD00D Your type of processor: x86_x86_ Enter the product number: Enter the key:
Les informations "numéro de série" et "type de processeur" sont à transmettre à Mapping afin d'obtenir les clés permettant d'activer le serveur.
Attention : les clés dédiées aux serveurs de licence doivent absolument être définies pour 65000 serveurs (devices) maximum.
Lancement en mode service
Linux
systemctl start M-LicenseServer
Il existe également les actions stop, restart et status.
Windows
Un nouveau point d'entrée intitulé Mapping Licence server
a été créé dans la liste des services de l'OS.
Lancement en mode interactif
Le mode de lancement interactif est conseillé, par exemple, sur un conteneur Docker :
M-LicenseServer -debug
Ce mode ne rend pas la main.
Configuration
Linux
L'emplacement du fichier de configuration (mapping.conf) est indiqué dans le fichier /etc/mappinglstab
Windows
L'emplacement du fichier de configuration (mapping.conf) est indiqué dans la base de registre :
HKLM\SOFTWARE\Mapping\Licence server\ConfigFileFullpath
(Ou à un emplacement similaire comme WOW6432Node, HKCU...)
Client (ONYX Server) ayant besoin d'une clé
Le rôle de réclamer une clé est affecté à un binaire spécifique : LicenseRequester.
Ce binaire est fourni avec l'ensemble des binaires Mapping.
Configuration du client
La configuration du client se trouve dans le même fichier de configuration (mapping.conf) que les autres modules ONYX Server.
Pour activer l'utilisation d'un serveur de licence au niveau du client, il suffit d'ajouter le bloc suivant dans le fichier mapping.conf :
<block name="LICENSESSERVER"> <group> <element> <info name="[LICENSE_SERVER]">ON</info> <info name="[LICENSE_SERVER_IP]">192.168.10.11</info> <info name="[LICENSE_SERVER_PORT]">2005</info> </element> </group> </block>
Et renseigner les éléments suivants :
LICENSE_SERVER
: ON/OFF (permet d'activer ou non le mode serveur de licence)LICENSE_SERVER_IP
: adresse IP du serveur de licence (ne fonctionne pas avec une adresse DNS)LICENSE_SERVER_PORT
: port d'écoute du serveur de licence.
Execution
LicenseRequester est invoqué automatiquement dès lors qu'un module Mapping a besoin d'une clé pour fonctionner.
Cependant, il est également possible de lancer manuellement une demande de clés :
LicenseRequester -claim