ONYX - 9.0 - Installation
Guide d'installation de ONYX Serveur de licence
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 divulgues aux clients qui lui en font demande.
Installation
Linux
Prérequis
Sur le serveur d'installation, il faut avoir installé et être à jour des librairies suivantes :
- openssl1.0 (ou equivalent, le binaire recherché est libcrypto.so.1)
- libcap-progs (ou libcap2-bin sur certains systemes)
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
Extrait d'une installation classique :
Where do you want to install the application? [/apps/M-LicenseServer/] > Installation directory: /apps/M-LicenseServer/ same for data directory: /apps/M-LicenseServer/ Which listening port for this server? [2005] > Listening port: 2005 The application was succefully installed! Do you want to start the service now? [Y/n] > 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.
Lancement en mode service
Linux
systemctl start M-LicenseServer
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
C'est ce mode de lancement qui est conseillé 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