ONYX:9.0:Installation:Installation ONYX Server sur Linux/en

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 they 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 should they have the same Web port, nor configuration file.

Selecting a work environment

Before using the ONYX Server,load the environment in which jobs 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. Copying this binary is essential to save and use the environment installed. The mappingenv program must be accessible to all users running 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, loading the work environment is also necessary before running the ONYX Server commands. 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 server. To obtain these licenses:

• Retrieve the server id
• Contact Technical Support, or log on to https://server.mappingsuite.com

Server ID

bash-4.2$ mappingenv
Which environment do you want to load:

1 : MAPPING  /apps/mapping/conf/mapping.conf    8002    Active
2 : MAPPING_test  /apps/mapping_test/conf/mapping.conf    8003    Active
Enter the name or number of the environment: 1

bash-4.5$ /apps/mapping/bin/mapkey
Serial number of your device: FFD8F1E6
Your processor type: x86_x86_

Entering license keys

Once Mapping provided you with the licenses, repeat the previous steps to enter each key you obtained. Each key Mapping provided is identified by a product number (from 1 to 5) and a key value (44 hexadecimal characters, separated or not by formatting dashes).