ONYX:MMC:ONYX Mapping Management Console

Introduction

La console centralisée de MAPPING (Mapping Management Console : MMC) donne la possibilité de monitorer plusieurs serveurs MAPPING à la fois.

prérequis

• Un (ou plusieurs) serveur Mapping Onyx installé(s) et configuré(s)
• Installer NodeJS (v14 minimum) (Node.js )

Exemple d’installation de NodeJS sur centos :

curl -sL https://rpm.nodesource.com/setup_14.x | bash - &&  yum -y install nodejs

Installation

Command de mapping-spooler-api

La commande s’installe avec npm (gestionnaire de paquet, installé avec NodeJS). Le registre npm utilisé est privé, et nécessite donc une authentification.

Authentification

npm login --registry http://npm-registry.mappingsuite.com:4873

username : partnermappingsuite
password : (voir sur LastPass : [M-S] IT> NPM Registry for Partner )
email : partner_mappingsuite@mappingsuite.com

Installation

npm install -g mapping-spooler-api --registry http://npm-registry.mappingsuite.com:4873

Configuration

Une fois la commande installée il faut configurer chaque serveur Onyx pour définir le port http utilisé par l’api Spooler.

Ceci peut se faire en ajoutant une entrée SPOOLER_API_PORT au mapping.conf de chacun des serveurs MAPPING à monitorer.

Cette valeur doit être unique pour chaque serveur Onyx présent sur la VM.

Exemple

<block name="WEB CONFIG">
 <group>
  <element>
   <info name="[SPOOLER_API_PORT]">8080</info>
  </element>
 </group>
</block>

Note:Ces numéros de port seront utiles lors de l’ajout du serveur dans l’interface de la MMC.

Démarrage

Pour démarrer l’api http il suffit de lancer la commande mapping-spooler-api, en ayant au préalable défini la variable d’environnement MAPPING_PATH correspondant au serveur Onyx désiré.

Cela peut se faire en appelant la commande mappingenv pour sélectionner l’environnement Onyx, puis lancer la commande mapping-spooler-api.

La commande mapping-spooler-api ne rend pas la main et ne dispose pas d’option natives pour s’exécuter en arrière plan. Pour lancer la commande en arrière plan on peut utiliser ce genre de chose :

mapping-spooler-api > /dev/null 2>&1 &

(Ou utiliser un outils comme supervisor) L’option SPOOLER_API_PORTdu mapping.conf est optionnelle. Si l’entrée n’est pas trouvé l’api cherchera une variable d’environnement PORT.