M-PS 7.2 Guide d'installation ( UNIX/LINUX)

Sommaire

1 PREREQUIS
2 PROCEDURE D’INSTALLATION
3 GESTIONNAIRE D’ENVIRONNEMENTS M-PROCESSING SERVER
4 ACTIVATION LOGICIELLE
5 PROCEDURE DE MISE A JOUR
6 PROCEDURE DE DESINSTALLATION
7 PREMIERS DEPANNAGES
8 PROCEDURE DE DUPLICATION

PREREQUIS

Ce guide décrit les procédures d’installation, mise à jour ou suppression du logiciel M-Processing Server sur les systèmes UNIX et LINUX. Pour rappel, il est vivement conseillé de mettre également à jour les autres logiciels de la suite Mapping afin d’éviter les conflits de version.

Une partie de ce guide aborde la procédure de duplication d’une instance de M-Processing Server, en réponse aux besoins de :

Changement de serveur
Mise en place d’un serveur de backup
Mise en place d’une architecture en Haute Disponibilité

MATERIEL

Le moteur M-Processing Server en version 7.2 est compatible avec les versions d’OS suivantes :

AIX : AIX 5L (5.1, 5.2 et 5.3), AIX 6.1, AIX 7.1
LINUX : toutes les distributions certifiées par le LSB (Linux Standard Base), en version 5 ou 6 de libc

Espace disque requis sur AIX :

Au moins 1 Go pour la décompression du package d’installation
Au moins 500 Mo pour l’installation

Espace disque requis sur LINUX :

Au moins 1 Go pour la décompression du package d’installation
Au moins 500 Mo pour l’installation

LOGICIEL

La présence d’un serveur Web de type Apache (v1.3 et supérieures, v2.2 conseillée) est requise, son installation doit avoir été faite avant d’installer le logiciel M-Processing Server. Les chemins d’accès aux binaires et au fichier de configuration d’Apache seront demandés lors de l’installation. L’accès au serveur en FTP (ou SFTP) et en telnet est requis. Le logiciel M-Processing Server étant compilé en version 32 bits, il faudra prévoir l’installation préalable de packages de compatibilité pour les librairies C (libc) et STDC++ (libstdc++) sur des systèmes d’exploitation en 64 bits.

M-Processing Server adresse 3 ports pour ses communications internes (entre processus) et externes (interface Web d’administration). Les ports utilisés par défaut sont :

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 M-Processing Server, ou d’en choisir de nouveaux lors de l’installation du logiciel. Ainsi, le serveur LPD/LPR du système devra être stoppé pour libérer le port 515.

Base de données :

Oracle : le driver OCI (Oracle Call Interface) doit être installé et démarré, le nom de l’instance Oracle doit être connu, un compte utilisateur (login / mot de passe) est requis pour établir la connexion.
MySQL : la base de données doit être installée, le nom de l’instance MySQL doit être connu, un compte utilisateur (login / mot de passe) est requis pour établir la connexion.

SECURITE

L’installation du logiciel M-Processing 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.

PROCEDURE 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 ». Exemple : AIX_autogenbuild_v7.2.0.29105.tar.gz

Pour installer le logiciel M-Processing Server, l’archive doit être déposée en FTP, en mode binaire, sur le serveur AIX ou Linux, dans le répertoire de votre choix (exemple : /tmp). Puis, sous le profil root, l’archive doit être décompressée :

gzip -d AIX_autogenbuild_v7.2.0.29105.tar.gz
tar –xvf AIX_autogenbuild_v7.2.0.29105.tar
cd autogenbuild_v7.2.0.29105
gzip -d mapping_install_AIX_autogenbuild_v7.2.0.29105.tar.gz
tar –xvf mapping_install_AIX_autogenbuild_v7.2.0.29105.tar

Un répertoire « 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 de M-Processing Server. Ci-dessous, un exemple typique de dialogue :

Control user permissions
Checking installation files folder
Do you want to update mappingenv binary
yes | no ?
yes

Enter installation path of mappingenv binary
default: /bin
[Enter]
Do you confirm this path: /bin
yes | no ?
yes
Detecting existing version
-> No version has been found
Do you want to search for mapping.conf files?
Warning: this operation can be long...
yes | no ?
no

Do you want to:
1: install a new version?
2: exit?
> 1 | 2 ?
1
Do you confirm the installation of a new version?
yes | no ?
yes

Installing a new M-Processing Server version...
Initializing System variables default values...
Initializing installation variables...

Enter matching values
If the propositions are correct, validate with "Enter"

Enter system type : AIX, Linux
default: AIX
[Enter]
Enter system version : AIX: 6.1, Linux: Linux
default: 5.2
[Enter]
Enter owner name
default: mapadmin
[Enter]
Enter group name

Remarque : Nom proposé par défaut pour toute installation de M-Processing Server. Modifiable.

default: mapadmin
[Enter]
Enter language to be used
default: english
[Enter]
Enter your company name
default: COMPANY
MAPPING
Enter server IP address
default: aix49
127.0.0.1

Remarque : Valeur conseillée afin de faciliter l’éventuelle duplication d’environnement par la suite, y compris sur un nouveau serveur.

Enter port to be used for web server
default: 8002
[Enter]

Remarque : Le script contrôle que le port renseigné n’est pas déjà utilisé par un autre environnement M-Processing Server. Il en demandera un autre si besoin.

Enter connection address to the spooler
default: aix49
127.0.0.1

Remarque : Valeur conseillée afin de faciliter l’éventuelle duplication d’environnement par la suite, y compris sur un nouveau serveur.

Enter connection port to the spooler
default: 2000
[Enter]
Enter port to be used for LPD server
default: 515
[Enter]
Enter environment name
default: MAPPING-autogenbuild_v7-2-0-29105
MAPPING_720
Enter path and name of the apache configuration file
default: /usr/HTTPServer/conf/httpd.conf
/opt/freeware/apache/conf/httpd.conf
Enter path and exact name of the executable htpasswd
default: /usr/HTTPServer/bin/htpasswd
/opt/freeware/apache/bin/htpasswd
Enter path and exact name of the executable apachectl
default: /usr/HTTPServer/bin/apachectl
/opt/freeware/apache/bin/apachectl
Do you want to connect Infoprint Manager to M-PROCESSING SERVER?
default: no
yes | no ?
no

Enter path to M-PROCESSING SERVER root directory
default: /apps/mapping
/apps/mapping_720

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 M-Processing Server dans un seul et même répertoire. Chaque chemin est malgré tout modifiable, suivant l’architecture ciblée.

Enter path to M-PROCESSING SERVER configuration directory
default: /apps/mapping_720/conf
[Enter]
Enter path to M-PROCESSING SERVER executables directory
default: /apps/mapping_720/bin
[Enter]
Enter path to M-PROCESSING SERVER web server directory
default: /apps/mapping_720/MapHTTPServer
[Enter]
Enter path to M-PROCESSING SERVER import directory
default: /apps/mapping_720/import
[Enter]
Enter path to M-PROCESSING SERVER temporary files directory
default: /apps/mapping_720/temp
[Enter]
Enter path to M-PROCESSING SERVER production files directory
default: /apps/mapping_720/map400
[Enter]
Enter path to M-PROCESSING SERVER spooler files directory
default: /apps/mapping_720/spool
[Enter]
Enter path to M-PROCESSING SERVER spooler log files directory
default: /apps/mapping_720/spool/logs
[Enter]
Enter path to stderr.txt and stdout.txt directory
default: /apps/mapping_720/temp
[Enter]

Enter path to M-PROCESSING SERVER archive files directory
default: /apps/mapping_720/mapout
[Enter]
Enter path to web server log files directory
default: /apps/mapping_720/spool/logs
[Enter]

Do you want to validate following parameters:
M-PROCESSING SERVER User: mapadmin
M-PROCESSING SERVER Group: mapadmin
Use of Infoprint: no
OS System: AIX
OS Version: 5.2
Apache configuration file: /opt/freeware/apache/conf/httpd.conf
Executable htpasswd: /opt/freeware/apache/bin/htpasswd
M-PROCESSING SERVER web log files: /apps/mapping_720/spool/logs
Language: english
Company name: MAPPING
Server IP address: 127.0.0.1
WEB server connection port: 8002
LPD well-known port: 515
Connection address to the spooler: 127.0.0.1
Connection port to the spooler: 2000
M-PROCESSING SERVER environment name: MAPPING_720
M-PROCESSING SERVER root directory: /apps/mapping_720
M-PROCESSING SERVER configuration directory: /apps/mapping_720/conf
M-PROCESSING SERVER binary directories: /apps/mapping_720/bin
M-PROCESSING SERVER web configuration directory: /apps/mapping_720/MapHTTPServer
M-PROCESSING SERVER import directory: /apps/mapping_720/import
M-PROCESSING SERVER temporary directory: /apps/mapping_720/temp
M-PROCESSING SERVER archive directory: /apps/mapping_720/mapout
M-PROCESSING SERVER production directory: /apps/mapping_720/map400
M-PROCESSING SERVER spooler directory: /apps/mapping_720/spool
M-PROCESSING SERVER std files directory: /apps/mapping_720/temp
M-PROCESSING SERVER logs directory: /apps/mapping_720/spool/logs
yes | no ?
yes
Do you want to create this group: mapadmin?
yes | no ?
yes
Do you want to create this user: mapadmin?
yes | no ?
yes
Installing...
Working directory creation
Binaries installation in /apps/mapping_720/bin
Web server installation in /apps/mapping_720/MapHTTPServer
Configuration files installation in /apps/mapping_720/conf
Usage files installation in /apps/mapping_720/map400/help/
Production files installation
Updating M-Processing Server environment
Web environment update script creation
Execute ./envcfg.sh to configure this environment
Do you want to update the configuration file of Apache web server for this environment?
yes | no ?
yes
Passwords configuration
Enter web password for mapadmin:
New password: **********
Re-type new password: **********
Adding password for user mapadmin
Do you want to update system password for mapadmin?
yes | no ?
yes

Changing password for "mapadmin"
mapadmin’s New password: **********
Enter the new password again: **********

Web access files configuration
Translation files installation
Registering version in the version manager...

Installation finished!

To use this environment in telnet mode:
MAPPING_PATH=/apps/mapping_720/conf/mapping.conf
export MAPPING_PATH
or use the command:
mappingenv

Thanks for choosing MAPPING

GESTIONNAIRE D’ENVIRONNEMENTS M-PROCESSING SERVER

INTRODUCTION

L’une des particularités des systèmes Unix/Linux est la possibilité d’installer et d’utiliser plusieurs environnements M-Processing 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 M-Processing Server se fait grâce au programme mappingenv.

ENVIRONNEMENT M-PROCESSING SERVER

Sur le serveur, les différents environnements M-Processing 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, avec 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 M-Processing Server ne peuvent pas avoir ni le même nom, ni le même port Web, ni le même fichier de configuration.

SELECTION D’UN ENVIRONNEMENT DE TRAVAIL

Avant toute utilisation de M-Processing Server, il est nécessaire de charger l’environnement dans lequel le travail doit être effectué, même si un seul environnement M-Processing Server est installé sur le serveur.

EN MODE CONSOLE (SESSION TELNET)

Le chargement d’un environnement M-Processing Server se fait grâce au binaire mappingenv. Lors de l’installation de M-Processing Server, 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 M-Processing Server en mode console. Pour charger un environnement M-Processing Server en ligne de commande, après s’être connecté en Telnet sur le serveur, exécuter la commande mappingenv, puis saisir le nom ou le numéro de l’environnement voulu :

AIX Version 5
(C) Copyrights by IBM and by others 1982, 2007.
login: mapadmin
mapadmin's Password: *******
********************************************************************
*                                                                  *
*  Welcome to AIX Version 5.2!                                     *
*                                                                  *
********************************************************************

bash-3.00$ /bin/mappingenv
Quel environnement voulez-vous charger :

1 : MAPPING_720  /apps/mapping_720/conf/mapping.conf    8002    Active
2 : MAPPING_7.1  /apps/mapping_7.1/conf/mapping.conf    8003    Active
Entrez le nom ou le numéro de l'environnement : MAPPING_720
$

EN MODE GRAPHIQUE (INTERFACE WEB)

Le fait de se connecter à l’interface Web de M-Processing Server sur un port particulier suffit à identifier et charger l’environnement de travail. Exemple : l’adresse http://192.168.216.100:8002 charge l’environnement MAPPING_720.

DANS LES SCRIPTS

Pour la rédaction de tout script devant exécuter des commandes M-Processing 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 M-Processing Server dans lequel l’exécution doit se dérouler.

Exemple de script pour démarrer le Spooler M-Processing Server de l’environnement MAPPING_720 :

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

TIMESTAMP=$(date +"%Y/%m/%d-%H.%M.%S")
echo "Mapping is starting at $TIMESTAMP"
/apps/mapping_720/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 notre Support Technique, ou se connecter sur https://serveur.mappingsuite.com.

IDENTIFIANTS SU SERVEUR

En mode console, charger l’environnement d’exécution puis saisir la commande mapkey dans le répertoire des binaires M-Processing Server. Cette commande permet de saisir les licences, mais affiche également les identifiants du serveur, requis pour le calcul des clés :

bash-3.00$ /bin/mappingenv
Quel environnement voulez-vous charger :

1 : MAPPING_720  /apps/mapping_720/conf/mapping.conf    8002    Active
2 : MAPPING_7.1  /apps/mapping_7.1/conf/mapping.conf    8003    Active
Entrez le nom ou le numéro de l'environnement : 1

bash-3.00$ /apps/mapping_720/bin/mapkey
Le numéro de série de votre machine : 000593BA
Votre type de processeur : aix49

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, ou de 250 à 254 en tarification « à la page ») et une valeur de clé (44 caractères hexadécimaux, séparés ou non par des tirets de mise en forme).

Exemple (après chargement de l’environnement) :

bash-3.00$ /apps/mapping_720/bin/mapkey

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, ou de 250 à 254 en tarification « à la page ») et une valeur de clé (44 caractères hexadécimaux, séparés ou non par des tirets de mise en forme).

Entrez le numéro du produit : 5
Entrez la clé : 
FE158D-609021-8B15FE-15FE15-7615AA-6CFE85-FF10FE-15
bash-3.00$

Le numéro de série de votre machine : 000593BA
Votre type de processeur : aix49

Entrez le numéro du produit : 5
Entrez la clé : FE158D-609021-8B15FE-15FE15-7615AA-6CFE85-FF10FE-15
bash-3.00$

Le numéro de série de votre machine : 000593BA
Votre type de processeur : aix49

Entrez le numéro du produit : 5
Entrez la clé : FE158D-609021-8B15FE-15FE15-7615AA-6CFE85-FF10FE-15
bash-3.00$

RECHARGES DE PAGES

La tarification « On Demand » de Mapping, évolutive en fonction des volumes de documents traités, permet de se rapprocher au plus près des besoins des clients. Elle implique également de saisir un deuxième type de licence, appelée recharge de pages, afin d’initialiser le volume de pages annuel que M-Processing Server pourra traiter. Cette nouvelle clé est calculée à partir d’informations dépendantes du système.

Pour initialiser l’utilisation On Demand de M-Processing Server et récupérer les informations nécessaires au calcul de la recharge, exécuter en mode console et dans l’environnement de travail voulu la commande

‘mapaddpts -create’

bash-3.00$ /apps/mapping_720/bin/mapaddpts -create
Votre Id : d51da800(0)
Votre machine : VALID (aix49)
Votre fichier : VALID (/apps/mapping_720/map400/key/map_key.key)
Prochaine remise à zéro : Thu May 14 16:23:47 2015
Points restants : 0.0
Points acquis : 0.0
bash-3.00$

Une fois la recharge de pages obtenue, exécuter une nouvelle fois la commande mapaddpts, sans argument pour rester dans le mode interactif. Une recharge de pages Mapping est identifiée par un numéro ou type de clé (1) et une valeur de clé (38 caractères hexadécimaux). Chaque recharge reçue de Mapping s’accompagne d’une réserve de sécurité (type de clé = 1), à n’utiliser qu’en cas de besoin.

bash-3.00$ /apps/mapping_720/bin/mapaddpts
Votre Id : d51da800(0)
Votre machine : VALID (aix49)
Votre fichier : VALID (/apps/mapping_720/map400/key/map_key.key)
Prochaine remise à zéro : Thu May 14 16:23:47 2015
Points restants : 0.0
Points acquis : 0.0

Entrez le type de clé : 1
Entrez la clé : 0118B0C15341A85CD541097C00400041000041
bash-3.00$

A tout moment, un état des lieux du compteur de pages restantes peut être obtenu et affiché par la commande mapreadpts :

bash-3.00$ /apps/mapping_720/bin/mapreadpts
Votre Id : d51da800(1)
Votre machine : VALID (aix49)
Votre fichier : VALID (/apps/mapping_720/map400/key/map_key.key)
Prochaine remise à zéro : Thu May 14 17:11:05 2015
Points restants : 3794803.0
Points acquis : 4000000.0

PROCEDURE DE MISE A JOUR

Après avoir arrêté tous les processus M-Processing Server, répéter les premières étapes de la procédure d’installation pour le dépôt de l’archive et sa décompression. Dans le répertoire « mapping_install » créé, exécuter le script d’installation (sous le profil root) :

cd mapping_install
./mapinst.sh

Le script guide l’utilisateur tout au long du processus de mise à jour d’un environnement Onyx Server. La sauvegarde éventuelle de l’environnement avant mise à jour est laissée à la charge de l’utilisateur. Ci-dessous, un exemple typique de dialogue :

Control user permissions
Checking installation files folder
Do you want to update the binary mappingenv
yes | no ?
yes
Enter installation path of mappingenv binary
default: /bin
[Enter]
Do you confirm this path: /bin
yes | no ?
yes
Detecting existing version
1 : MAPPING_DEV  /apps/mappingdev/conf/mapping.conf    8002    Active
2 : MAPPING_PROD /apps/mapping/conf/mapping.conf       8003    Active
Do you want to use one of the above versions?
yes | no ?
yes
Enter the name of the version you want to use or ":q" to exit
MAPPING_DEV

Do you want to:
1 : install a new version ?
2 : update current version ?
3 : uninstall current version ?
4 : exit ?
> 1 | 2 | 3 | 4 ?

Do you confirm the update of this environment?
yes | no ?
yes

Updating current version...

Initializing installation variables...
Searching environment variables...
Do you want to validate following parameters:
M-PROCESSING SERVER User: mapadmin
M-PROCESSING SERVER Group: mapadmin
Use of Infoprint: no
OS System: Linux
OS Version: 5.2
Apache configuration file: /opt/freeware/apache/conf/httpd.conf
Executable htpasswd: /opt/freeware/apache/bin/htpasswd
M-PROCESSING SERVER web log files: /apps/mappingdev/spool/logs
Language: french
Company name: MAPPING
Server IP address: 127.0.0.1
WEB server connection port: 8002
LPD well-known port: 515
Connection address to the spooler: 127.0.0.1
Connection port to the spooler: 2000
M-PROCESSING SERVER environment name: MAPPING_DEV
M-PROCESSING SERVER root directory: /apps/mappingdev
M-PROCESSING SERVER configuration directory: /apps/mappingdev/conf
M-PROCESSING SERVER binaries directory: /apps/mappingdev/bin
M-PROCESSING SERVER web configuration directory: /apps/mappingdev/MapHTTPServer
M-PROCESSING SERVER import directory: /apps/mappingdev/import
M-PROCESSING SERVER temporary directory: /apps/mappingdev/temp
M-PROCESSING SERVER archive directory: /apps/mappingdev/mapout
M-PROCESSING SERVER production directory: /apps/mappingdev/map400
M-PROCESSING SERVER spooler directory: /apps/mappingdev/spool
M-PROCESSING SERVER std files directory: /apps/mappingdev/temp
M-PROCESSING SERVER logs directory: /apps/mappingdev/spool/logs
yes | no ?
yes
Updating...
Update binaries in /apps/mappingdev/bin
Update web server in /apps/mappingdev/MapHTTPServer
Update configuration files in /apps/mappingdev/conf
Update usage files in files in /apps/mappingdev/map400/help/
Update production files
Updating M-Processing Server environment
Translation files installation
Execute ./envcfg.sh to configure this environment
Do you want to update configuration file of Apache web server for this environment?
yes | no ?
yes

Update finished!

To use this environment in telnet mode:
MAPPING_PATH=/apps/mappingdev/conf/mapping.conf
export MAPPING_PATH
or use the command:
mappingenv

Thanks for choosing MAPPING

PROCEDURE DE DESINSTALLATION

Après avoir arrêté tous les processus M-Processing Server, répéter les premières étapes de la procédure d’installation pour le dépôt de l’archive et sa décompression.

Dans le répertoire « mapping_install » créé, exécuter le script d’installation (sous le profil root) :

cd mapping_install
./mapinst.sh

Le script guide l’utilisateur tout au long du processus de désinstallation, notamment pour identifier l’environnement à désinstaller, ainsi que les répertoires (et leur contenu) à supprimer ou non. Ci-dessous, un exemple typique de dialogue :

Control user permissions
Checking installation files folder
Do you want to update mappingenv binary?
yes | no ?
yes

Remarque : Le binaire mappingenv est le gestionnaire d’environnements M-Processing Server. Il est fortement conseillé de le mettre à jour lors d’une désinstallation, afin de correctement effacer l’environnement supprimé.

Enter installation path of mappingenv binary
default: /bin
[Enter]
Do you confirm this path: /bin
yes | no ?
yes
Detecting existing version
1 : MAPPING_DEV  /apps/mappingdev/conf/mapping.conf    8002    Active
2 : MAPPING_PROD /apps/mapping/conf/mapping.conf       8003    Active
Do you want to use one of the above versions?
yes | no ?
yes
Enter the name of the version you want to use or ":q" to exit
MAPPING_DEV

Do you want to:
1 : install a new version?
2 : update current version?
3 : uninstall current version?
4 : exit?
> 1 | 2 | 3 | 4 ?
3
Do you confirm the removal of this environment?
yes | no ?
yes

Removing current version...
Searching environment variables...
Removing version...
Careful: some folders may hold files that do not belong to M-Processing Server.
Check them before deleting
List of folders to be deleted:
/apps/mappingdev/temp
/apps/mappingdev/spool/logs
/apps/mappingdev/conf
/apps/mappingdev/bin
/apps/mappingdev/MapHTTPServer
/apps/mappingdev/import
/apps/mappingdev/temp
/apps/mappingdev/mapout
/apps/mappingdev/map400
/apps/mappingdev/spool
/apps/mappingdev
Confirm removal or ":q" to exit
Do you want to delete sdterr.txt and stdout.txt folder (/apps/mappingdev/temp)?
yes | no ?
yes
Do you want to delete log files folder (/apps/mappingdev/spool/logs)?
yes | no ?
yes
Do you want to delete web log files folder (/apps/mappingdev/spool/logs)?
yes | no ?
yes
Do you want to delete configuration files folder (/apps/mappingdev/conf)?
yes | no ?
yes
Deleting version in the version manager
Do you want to delete binaries folder (/apps/mappingdev/bin)?
yes | no ?
yes
Do you want to delete web configuration files folder (/apps/mappingdev/MapHTTPServer)?
yes | no ?
yes
Do you want to delete import files folder (/apps/mappingdev/import)?
yes | no ?
yes
Do you want to delete temporary files folder (/apps/mappingdev/temp)?
yes | no ?
yes
Do you want to delete archive files folder (/apps/mappingdev/mapout)?
yes | no ?
yes
Do you want to delete production files folder (/apps/mappingdev/map400)?
yes | no ?
yes
Do you wish to delete spooler folder (/apps/mappingdev/spool)?
yes | no ?
yes
Do you want to delete M-Processing Server root folder (/apps/mappingdev)?
yes | no ?
yes

Removal finished!

PREMIERS DEPANNAGES

Interface Web : Erreur de chargement de la page

Après installation ou mise à jour du logiciel, l’interface Web de M-Processing Server ne s’affiche pas.

Le navigateur affiche un message : « Internet Explorer ne peut pas afficher cette page Web » (ou « La connexion a échoué » dans Firefox), sans demander aucun identifiant de connexion.

Solution : après installation ou mise à jour de M-Processing Server, il convient de redémarrer le serveur Apache, son fichier de configuration ayant été modifié.

Interface Web : Après authentification, affichage d’une page blanche

Au lancement de l’interface Web de M-Processing Server, le serveur Apache demande les identifiants de connexion, puis affiche une page blanche.

Solution : vérifier les paramètres de sécurité du navigateur Internet, rajouter l’adresse IP du serveur (ou 127.0.0.1 en local) dans les sites de confiance.

Si cela ne résout pas le phénomène, consulter les fichiers de log du serveur Apache (error_log et access_log) pour davantage d’information, et contactez le Support Technique.

Interface Web : Après authentification, affichage d’une popup de téléchargement

Au lancement de l’interface Web de M-Processing Server, le serveur Apache demande les identifiants de connexion, puis une fenêtre s’ouvre pour proposer le téléchargement du fichier mapweb_secure.exe.

Explication : ce programme M-Processing Server est exécuté pour afficher les différents menus de l’interface Web, et permettre la navigation dans ces menus. Le serveur Apache doit supporter et autoriser l’exécution de tels programmes générateurs de contenus externes dynamiques (appelés programmes CGI). Solution : vérifier la configuration du serveur Apache (fichier httpd.conf), et plus précisément que le module permettant l’exécution de scripts CGI est bien disponible et chargé. Une directive correcte doit ressembler à ceci :

LoadModule cgi_module modules/mod_cgi.so

Si la configuration d’Apache doit être modifiée pour activer ce module, il conviendra de redémarrer le Service Apache. Si cela ne résout pas le phénomène, consulter les fichiers de log du serveur Apache (error.log et access.log) pour davantage d’information, et contactez le Support Mapping.

PROCEDURE DE DUPLICATION

CONTEXTE

Cette partie de la documentation guide un utilisateur expérimenté du logiciel pour dupliquer à l’identique une instance fonctionnelle de M-Processing Server (A) sur un autre serveur (B). Les besoins adressés par cette procédure peuvent être :

Changement de serveur
Mise en place d’un serveur de backup
Mise en place d’une architecture en Haute Disponibilité

PREREQUIS

Le moteur M-Processing Server doit être installé correctement sur le serveur A. L’ensemble du paramétrage de la solution doit être parfaitement connu et identifié.

La version d'OS doit être la même sur les 2 serveurs, ainsi que la version du serveur Web Apache. Si ce n’est pas le cas, il est préférable de contacter le Support Technique Mapping afin de s’assurer de la compatibilité du logiciel dans son nouvel environnement.

Si des bases de données ou des applications externes sont utilisées dans le moteur, leurs chemins d’accès doivent être identiques (exemple : appel d’un script *.sh dans un Workflow ou une tâche planifiée du serveur).

PROCEDURE

Dans M-Processing Server, toute la configuration est stockée sur fichiers (aucune base de données n’est requise pour l’utilisation de la solution). La procédure de migration d’un serveur à un autre consiste essentiellement à de la copie de fichiers. Il convient néanmoins de respecter les étapes suivantes.

INSTALLATION DU SERVEUR B

Installer M-Processing Server sur le nouveau serveur B (installation identique) à l'aide du même package d’installation qui a servi pour le serveur A. Idéalement, il est préférable de choisir le même chemin d’installation et de conserver la même arborescence, afin de faciliter les copies et reprises ultérieures. Bien entendu, les informations propres au serveur seront différentes (adresse IP...).

Ces informations peuvent être retrouvées, sur le serveur A, dans le fichier de configuration de M-Processing Server (mapping.conf).

Appliquer successivement sur le serveur B tous les patchs et mises à jour éventuels qui ont été appliqués sur le serveur A. Dans la majorité des cas, il est préférable de commencer par faire une mise à jour de M-Processing Server sur le serveur A, avec une version plus récente intégrant nativement l’ensemble des correctifs, puis d’installer la même version sur le serveur B.

Activer le logiciel sur le serveur B (clés logicielles, et éventuellement recharge de pages).

Récupérer la configuration et le paramétrage M-Processing Server du serveur A sur le serveur B, par simple copie des fichiers et/ou dossiers suivants. Les chemins indiqués ici sont ceux par défaut pour une installation du logiciel dans le répertoire de base « /apps/mapping » (variable PATH_BASE_MAPPING du fichier de configuration).

DUPLICATION DE LA CONFIGURATION

Attention : Les fichiers de configuration suivants, situés dans le répertoire de configuration de M-Processing Server, ne doivent surtout pas être copiés du serveur A vers le serveur B :

mapping.conf : fichier de configuration de M-Processing Server. Les modifications effectuées dans ce fichier doivent être reprises une à une, par comparaison des 2 fichiers.
mapkey.txt et ucinfo.txt : fichiers de clés logicielles, dépendants de chaque serveur.

déclaration des files d’attente dans le Spooler M-Processing Server (requis)

/apps/mapping/conf/queues/*

déclaration des Workflows de traitements M-Processing Server (requis – excepté le sous-répertoire backup)

/apps/mapping/conf/rules/workflow/*

déclarations des profils de conversion des documents XPS, notamment pour l’impression (requis)

/apps/mapping/conf/XPSConfig.conf

déclarations des robots ‘Scanfolder’ M-Processing Server (si modifié)

/apps/mapping/conf/robot.conf

déclarations des robots ‘Serveurs d’écoute’ M-Processing Server (si modifié)

/apps/mapping/conf/maprawd.conf

déclarations des groupes d’utilisateurs M-Processing Server (si modifié)

/apps/mapping/conf/GROUPS.conf

déclarations des utilisateurs M-Processing Server (si modifié)

/apps/mapping/conf/USERS.conf

déclarations des différentes méthodes de visualisation des travaux dans le Spooler (si modifié)

/apps/mapping/conf/viewSettings.conf

méthodes de déploiement d’un serveur à un autre (si modifié)

/apps/mapping/conf/exportSettings.conf

DUPLICATION DES FORMATS M-DESIGNER / M-CONNECT

Attention : Le sous répertoire « key » dans map400 ne doit surtout pas être copié du serveur A vers le serveur B. Il contient les fichiers des recharges de page, dépendants de chaque serveur.

objets décrivant les formats M-Connect et M-Designer en production (requis)

/apps/mapping/map400/*

ressources externes (images, XPS, traductions) utilisées dans les formats M-Designer (requis si utilisé)

/apps/mapping/import/lgobitmap/*

ressources externes (traductions) utilisées dans les formats M-Connect (requis si utilisé)

/apps/mapping/import/lang/*

AUTRES DUPLICATIONS

Fichiers sources des projets M-Connect / M-Designer (si sauvegardés sur le serveur M-Processing Server)

/apps/mapping/import/docpc/*

Répertoire des archives (si utilisé par M-Storage)

/apps/mapping/mapout/*

Répertoire des logs du Spooler (optionnel, car elles peuvent être considérées comme propre à chaque serveur)

/apps/mapping/spool/logs/*

Répertoire des travaux du Spooler (optionnel, car ils peuvent être considérés comme propre à chaque serveur)

/apps/mapping/spool/global/*

Suivant l’utilisation globale de la solution, d’autres éléments peuvent devoir être dupliqués, notamment des scripts appelés dans les Workflows de traitements M-Processing Server, des tâches planifiées d’épuration ou de déclenchement de traitements, etc. Ces éléments étant spécifiques à chaque client, ils ne peuvent être listés ici, et doivent impérativement être identifiés par l’utilisateur.