ONYX Server installation on Linux

Introduction

This guide explains how to install ONYX Server on Linux. It is also generally recommended to update other software modules in the suite to prevent any version conflict.

Requirements

Setup

ONYX Server Linux is compatible with the following operating system versions:

• Red Hat Enterprise Linux 7
• CentOS 7

Required disk space on Linux:

• 1 Go minimum to unzip the installation package
• 500 Mo minimum for the installation

System:

• 2 VCPU
• Processor type x86-32 or x86-64
• RAM: 2 Go minimum, 4 Go recommended. Possibly more depending on the complexity of your architecture

Software

• Apache

An Apache Web server, version 2.2 or 2.4 is required. It must be installed before installing ONYX Server. Path to the binary and configuration file is asked upon installation.

Example: #yum install httpd

• Deactivating SELinux

To start up Apache on DocumentRoots located in Mapping folders, SELinux must be deactivated

Example: #setenforce 0

For it to be deactivated at every start-up, edit the file /etc/selinux/config as follows: SELINUX=disabled

• sFTP

Access to the server in sFTP (ssh) is required.

• 32bits Libraries

ONYX Server 9.0 is built in 32 bits, 32 bits (i686) packages must be installed beforehand for the librairies C (libc) and STDC++ (libstdc++) on operating systems in 64 bits.

Example:

 #yum install libstdc++.i686
 #yum install glibc.i686

• Network Ports

ONYX Server uses 3 ports for internal communications (between processes) and external ones (admin Web interface).

The following ports are used by default:

• 8002 (Web port)
• 515 (LPD listening port)
• 2000 (internal port of the Mapping Spooler)

Check that these ports are opened and available (that are not already used) for ONYX Server, if not, choose other ports for the installation. The LPD/LPR server of the system must then be stopped to clear the port 515.

• Security

ONYX Server must be installed with either a profile which has admin rights on the server, or the root account. If necessary, two new user accounts will be automatically created upon installation: mapadmin (default name, this can be changed) and nobodyma.

Installation Process

Installation packages of the software can be downloaded on the Mapping technical server, at: https://serveur.mappingsuite.com. They are called "[OS]_[version].tar.gz".

To install ONYX Server software, the archive file must be in FTP in binary mode on the Linux server in a folder you chose (example: /tmp). The archive file must then be unzipped with the root profile:

gzip -d Setup_Onyx_Server_Linux_v9.0.0b.37402.tar.gz
tar –xvf Setup_Onyx_Server_Linux_v9.0.0b.37402.tar
cd v9.0.0b.37402
gzip -d mapping_install_Linux_v9.0.0b.37402.tar.gz
tar –xvf mapping_install_Linux_v9.0.0b.37402.tar

A "mapping_install" folder, in which the installation script must be run, is created (always with the root profile):

cd mapping_install 
./mapinst.sh

The script guides the user during the installation process by asking for all the necessary information to configure the installation of the ONYX Server.

Note: Localhost(127.0.0.1) is a recommended value so that duplicating the environment afterwards is easier, even on a new server.

Note: The script then builds all the default installation paths from the root folder to place all the ONYX Server files in the same folder. Each path can however be changed depending on the targeted architecture.

ONYX Server environment manager

L’une des particularités des systèmes Linux est la possibilité d’installer et d’utiliser plusieurs environnements ONYX Server en parallèle sur le même serveur. Chaque environnement est alors complètement indépendant des autres et possède sa propre configuration, ses propres traitements, sa propre version du moteur, ses propres licences d’activation. La gestion de ces différents environnements ONYX Server se fait grâce au programme mappingenv.

Environnements ONYX

Sur le serveur, les différents environnements ONYX Server sont enregistrés dans un fichier : mappingtab, situé par défaut dans le répertoire /etc. Si ce fichier est dans un autre répertoire, il faudra le préciser, dans les lignes de commandes suivantes, à l'aide de l’argument -pathconf:XXX. Un environnement est constitué d'un nom, d'un port de connexion (port Web à travers le serveur Apache) et d'un chemin de configuration (chemin complet du fichier mapping.conf). Chaque paramètre doit être unique. Ainsi, sur un même serveur, deux environnements ONYX Server ne peuvent avoir ni le même nom, ni le même port Web, ni le même fichier de configuration.

Sélection d'un environnement de travail

Avant toute utilisation d'ONYX Server, il est nécessaire de charger l’environnement dans lequel les travaux doivent être effectués, même si un seul environnement ONYX Server est installé sur le serveur.

En mode console (session telnet)

Le chargement d’un environnement ONYX Server se fait grâce au binaire mappingenv. Lors de l’installation, la copie de ce binaire sur le système est proposée. Il est indispensable de copier ce binaire pour enregistrer et utiliser l’environnement installé. Le programme mappingenv doit être accessible par tous les utilisateurs exécutant ONYX Server en mode console. Pour charger un environnement ONYX Server en ligne de commande, après s’être connecté en Telnet sur le serveur, il faut exécuter la commande mappingenv puis saisir le nom ou le numéro de l’environnement voulu.

En mode console (SSH)

En mode graphique(interface Web)

Le fait de se connecter à l’interface Web d'ONYX Server sur un port particulier suffit à identifier et charger l’environnement de travail.

Exemple : l’adresse http://192.168.217.17:8002 charge l’environnement MAPPING

Dans les scripts

Pour la rédaction de tout script avant d'exécuter des commandes ONYX Server, il est également nécessaire de charger l’environnement de travail. Il n’est pas possible d’utiliser le binaire mappingenv (mode interactif) dans ces cas-là. L’équivalent est l’exportation de la variable d’environnement MAPPING_PATH, identifiant le fichier de configuration de l’environnement ONYX Server dans lequel l’exécution doit se dérouler.

Exemple de script pour démarrer le Spooler ONYX Server de l’environnement MAPPING :

#!/usr/bin/ksh
################################################################
# Mapping Suite Spooler Start                                  #
################################################################
export MAPPING_PATH=/apps/mapping/conf/mapping.conf

TIMESTAMP=$(date +"%Y/%m/%d-%H.%M.%S")
echo "Mapping is starting at $TIMESTAMP"
/apps/mapping/bin/map_daemon start

Activation logicielle

Après avoir installé le logiciel, celui-ci doit être activé en saisissant des clés logicielles. Ces licences sont dépendantes d’informations systèmes du serveur. Pour obtenir les licences :

• Récupérer les identifiants du serveur
• Puis contacter le Support Technique, ou se connecter sur https://serveur.mappingsuite.com.

Identifiant serveur

bash-4.2$ mappingenv
Quel environnement voulez-vous charger :

1 : MAPPING  /apps/mapping/conf/mapping.conf    8002    Active
2 : MAPPING_test  /apps/mapping_test/conf/mapping.conf    8003    Active
Entrez le nom ou le numéro de l'environnement : 1

bash-4.5$ /apps/mapping/bin/mapkey
Le numéro de série de votre machine : FFD8F1E6
Votre type de processeur : x86_x86_

Saisie des licences d'activation

Une fois les licences calculées par Mapping, répéter les étapes précédentes pour saisir chaque clé obtenue. Chaque clé fournie par Mapping est identifiée par un numéro de produit (de 1 à 5) et une valeur de clé (44 caractères hexadécimaux, séparés ou non par des tirets de mise en forme).