ONYX Server installation on Linux

Autres langues :

English • ‎français

Sommaire

1 Introduction
2 Requirements
- 2.1 Setup
- 2.2 Software
3 Installation Process
4 Managing the ONYX Server environment
- 4.1 ONYX Environments
- 4.2 Selecting a work environment
5 Activating the software
- 5.1 Identifiant serveur
- 5.2 Saisie des licences d'activation

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.

Managing the ONYX Server environment

With Linux systems, several ONYX Server environments can be installed and used on the same server. Each environment is then entirely independent from the others and has its own configuration, processings, engine version, activation licenses. Managing these different ONYX Server environments can be done using the program mappingenv.

ONYX Environments

On the server, the different ONYX Server environments are saved in a file: mappingtab, which is by default in the /etc folder. If this file is in another folder, it needs to be specified in the following command lines, using the argument -pathconf:XXX. An environment consists of a name, a connection port (Web port via the Apache server) and a configuration file (path of the mapping.conf file). Each parameter must be unique. On the same server, two ONYX Server environments must not have the same name, neither Web port, nor configuration file.

Selecting a work environment

Before using the ONYX Server,load the environment in which works must be carried out, even if there is only ONYX Server installed on the server.

Console mode (telnet session)

An ONYX Server environment is loaded with the binary mappingenv. During the installation, you will be asked if you want to copy this binary on the system. Coying this binary is essential to save and use the environment installed. The mappingenv program must be accessible to all users running the ONYX Server in console mode. To load an ONYX Server environment in command lines, once you are connected in Telnet on the server, run command mappingenv then, enter the name or the number of the desired environment.

In console mode (SSH)

In graphic mode (Web interface)

Connection to the Web interface of ONYX Server on a particular port is enough to identify and load the work environment.

Example: the address http://192.168.217.17:8002 loads the MAPPING environment

In the scripts

To write any script, before running the ONYX Server commands, loading the work environment is also necessary. The binary mappingenv (interactive mode) cannot be used in such cases. You need to export the environment variable MAPPING_PATH, which identifies the configuration file of the ONYX Server in which the execution is done.

Example of a script to start the ONYX Server Spooler of the MAPPING environment:

#!/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

Activating the software

Once the software is installed, it must be activated by entering software keys. These licenses are dependent on system information of the serveur. To obtain these licenses:

Retrieve the server id
Contact Technical Support, or log on to https://server.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).