ONYX - 9.0 - Installation
Installation ONYX Server sur Linux
Sommaire
Introduction
Ce guide explique comment installer ONYX Server pour Linux. En règle générale, il est recommandé de mettre à jour également les autres modules logiciels de la suite afin d'éviter tout conflit de version.
Pré-requis
Matériel
ONYX Server Linux est compatible avec les versions d’OS suivantes :
- Red Hat Enterprise Linux 7
- CentOS 7
Espace disque requis sur Linux :
- Au moins 1 Go pour la décompression du package d’installation
- Au moins 500 Mo pour l’installation
Système :
- 2 VCPU
- Type de processeur x86-32 ou x86-64
- RAM: 2 Go minimum, 4 Go recommandés. Et potentiellement plus en fonction de la complexité de l'architecture
Logiciel
- Apache
- La présence d’un serveur Web Apache en version 2.2 ou 2.4 est requise, son installation devant avoir été réalisée avant d’installer ONYX Server. Les chemins d’accès aux binaires et au fichier de configuration d’Apache seront demandés lors de l’installation.
- Exemple :
#yum install httpd
- Désactivation de SELinux
- Afin de pouvoir démarrer Apache sur des DocumentRoot situés dans les arborescences Mapping, il est nécessaire de désactiver SELinux
- Exemple :
#setenforce 0
- Pour que la désactivation soit effective à chaque démarrage, il faut modifier le fichier /etc/selinux/config comme suit :
SELINUX=disabled
- sFTP
- L’accès au serveur en sFTP (ssh) est requis.
- Bibliothèques 32bits
- ONYX Server 9.0 étant compilé en 32 bits, il faudra prévoir l’installation préalable de packages de compatibilité 32 bits (i686) pour les librairies C (libc) et STDC++ (libstdc++) sur des systèmes d’exploitation en 64 bits.
- Exemple :
#yum install libstdc++.i686 #yum install glibc.i686
- Ports réseaux
- ONYX Server adresse 3 ports pour ses communications internes (entre processus) et externes (interface Web d’administration).
- Les ports utilisés par défaut sont les suivants :
- 8002 (port Web)
- 515 (port d’écoute LPD)
- 2000 (port interne du Spooler Mapping)
- Il conviendra de vérifier que ces ports sont ouverts et disponibles (non utilisés) pour ONYX Server, ou d’en choisir de nouveaux lors de l’installation. Ainsi, le serveur LPD/LPR du système devra être stoppé pour libérer le port 515.
- Sécurité
- L’installation d'ONYX Server doit se faire sous un profil disposant des droits Administrateur sur le serveur, soit le compte root. Deux nouveaux comptes utilisateurs seront automatiquement créés si besoin lors de l’installation du logiciel : mapadmin (nom par défaut, modifiable) et nobodyma.
Procédure d'installation
Les packages d’installation du logiciel sont disponibles en téléchargement sur le serveur technique Mapping, à l’adresse : https://serveur.mappingsuite.com. Ils sont nommés « [OS]_[version].tar.gz ».
Pour installer le logiciel ONYX Server, l’archive doit être déposée en FTP en mode binaire sur le serveur Linux dans le répertoire de votre choix (exemple : /tmp). Puis, sous le profil root, l’archive doit être décompressée :
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
Un dossier «mapping_install» est créé dans lequel le script d’installation doit être exécuté (toujours sous le profil root):
cd mapping_install ./mapinst.sh
Le script guide l’utilisateur tout au long de la procédure d’installation en demandant toutes les informations nécessaires au paramétrage de l’installation d'ONYX Server.
Remarque : Localhost(127.0.0.1) est une valeur conseillée afin de faciliter l’éventuelle duplication d’environnement par la suite, y compris sur un nouveau serveur.
Remarque : Le script construit ensuite tous les chemins d’installation par défaut à partir de ce répertoire racine afin de disposer de tous les fichiers ONYX Server dans un seul et même répertoire. Chaque chemin est malgré tout modifiable, suivant l’architecture ciblée.
Lancement de l'interface
Une fois l'installation terminée, il est nécessaire de redémarrer le service Apache avant de pouvoir accéder à l'interface Web d'administration d'ONYX Server.
httpd -k restart
1. Ouvrir une page de navigateur internet
2. Saisir dans l'URL :
- Depuis le serveur en local :
http://127.0.0.1:8002
- Depuis un poste en réseau :
http://<ip.du.serveur>:8002
8002
étant le port configuré par défaut lors de l'installation
Erreurs fréquemment rencontrées
Si le port 8002 est déjà occupé
Dans ce cas, Apache ne peut pas redémarrer. Il suffit alors de modifier le port utilisé pour accéder à l'interface Web du serveur Mapping :
- Ouvrir le fichier de configuration d'Apache, httpd.conf (il se trouve dans le dossier conf, référencé lors de l'installation)
- Chercher le bloc de configuration situé entre #BEGIN_MAPPING et #END_MAPPING (généralement en bas du fichier)
- Modifier le port d'écoute 8002 dans les lignes suivantes :
- Listen 8002
- NameVirtualHost *:8002
- <VirtualHost *:8002>
Puis, redémarrer le service Apache.
Message d'erreur à l'ouverture de la page
Il est possible qu'une erreur se produise à l'ouverture de la page Mapping. Si la version 2.4 d'Apache a été installée, il faut procéder à une petite modification du fichier httpd.conf d'apache, dans la section ajoutée automatiquement lors de l'installation de Mapping.
Pour cela :
- Ouvrir le fichier de configuration d'Apache, httpd.conf (il se trouve dans le dossier conf, référencé lors de l'installation)
- Chercher la section contenant
#BEGIN_MAPPING_
- Remplacer les 2 lignes suivantes :
Order allow,deny
Allow from all
- par
Require all granted
- Attention, ces 2 lignes sont présentes 2 fois dans la section
#BEGIN_MAPPING
. D'autre part, si le serveur comporte plusieurs instances Mapping, il est possible qu'il y ait plusieurs section Mapping dans le fichier httpd.conf.
- Attention, ces 2 lignes sont présentes 2 fois dans la section
Enfin, redémarrer le service Apache.
httpd -k restart
Gestionnaire d’environnements ONYX Server
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 (commande mappingenv), à 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).