Guide d'installation de ONYX Serveur de licence

L'utilisation d'un serveur de licence remplace le fonctionnement par 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

1. Décompresser le fichier : tar -xvf Setup_LicenseServer_linux_xxxxxxxxx.tar.gz
2. Lancer le script install.sh (avec les droits root)
3. 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.

Execution simple

C'est ce mode de lancement qui est conseillé sur un conteneur Docker :

M-LicenseServer -debug

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.

Configuration

Windows

Stocké en base de registre

HKLM\SOFTWARE\WOW6432Node\Mapping\Licence server\ConfigFileFullpath

qui doit pointer vers un fichier mapping.conf.

Linux

Un chemin standardisé pointe vers le fichier de conf mapping.conf

/etc/mappinglstab

Le fichier de configuration, quant à lui, est similaire à ceux utilisés sur M-PS, au format XML :

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<config name="mapping_configuration">
  <block name="LICENCESSERVER">
    <group>
      <element>
        <info name="[TEMP_DIR_FULLPATH]">/apps/M-LicenseServer/temp</info>
        <info name="[LOG_DIR_FULLPATH]">/apps/M-LicenseServer/logs</info>
        <info name="[SERVER_LOG_FILE_PATH]">server.log</info>
        <info name="[PORT]">2005</info>
        <info name="[UCINFO_FILE_FULLPATH]">/apps/M-LicenseServer/conf/ucinfo</info>
        <info name="[MAPKEY_FILE_FULLPATH]">D:\MappingInstall\M-ProcessingServer\Settings\mapkey.txt</info>         
      </element>
    </group>
  </block>
</config>

A souligner : à des fins de test / debug, il est possible d'ajouter une entrée <info name="[DBG_MAX]">10</info> qui va surcharger le nombre de devices (instances Onyx Server) autorisés par les clés renseignées au sein du serveur de licences

Conception

Ce serveur est destiné à n'être lancé que par l'utilisateur mapadmin et à n'être executé que sous forme de service.

Ainsi, c'est le script des services (init.d systemd) qui est en charge d'interdire les lancements en double.

Client (M-PS) qui réclame 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.

Execution

Réclamer une clé valide pour la configuration Mapping courante :

LicenseRequester -claim

Configuration

Le client est configuré sur la même base que le M-PS qu'il exécute. C'est à dire qu'il utilise sa variable d'environnement MAPPING_PATH qui pointe un fichier mapping.conf sur le disque.

Ce fichier mapping.conf est un XML de même format qu'une configuration de M-PS, mais un seul bloc intéresse le serveur de licence :

<block name="LICENSESSERVER">
  <group>
    <element>
      <info name="[LICENSE_SERVER]">ON</info>
      <info name="[LICENSE_SERVER_IP]">127.0.0.1</info>
      <info name="[LICENSE_SERVER_PORT]">2005</info>
    </element>
   </group>
 </block>