Voir la source de M-PS 7.2 Guide d'installation ( WIN)

==PREREQUIS==
Ce guide décrit les procédures d’installation, mise à jour ou suppression du logiciel M-Processing Server sur un système Windows. Pour rappel, il est vivement conseillé de mettre également à jour les autres logiciels de la suite Mapping afin d’éviter les erreurs 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 :
*Windows Server 2003
*Windows Server 2008 R2
*Windows Server 2012

Remarque :
Sur les systèmes Windows Server 2008 et supérieurs, les versions antérieures à M-PS 7.1 ne sont pas compatibles.

Afin d’assurer le bon fonctionnement de la Suite Mapping, le système hôte doit disposer au minimum de la configuration matérielle recommandée et des dernières mises à jour fournies par l’éditeur du système d’exploitation.
Environ 200 Mo d’espace disque disponible seront nécessaires pour l’installation du logiciel.

===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.

M-Processing Server est compilé en version 32 bits, mais il est pleinement compatible avec des systèmes d’exploitation en 64 bits.

M-Processing Server adresse 3 ports pour ses communications internes (entre processus) ou externes (interface Web d’administration et d’exploitation). Les ports par défaut utilisés 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 pour M-Processing Server, ou d’en choisir de nouveaux lors de l’installation (installation de type « Custom » dans ce cas).
Ainsi, le serveur LPD 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===

Les droits Administrateur sont nécessaires afin de pouvoir installer le logiciel.

==PROCEDURE D’INSTALLATION==

Les programmes 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 « M-Processing_Server_setup_autogenbuild_v7.2.0.xxxxx.exe ».

*Lancer l'exécutable d'installation
*Après l’extraction des fichiers d'installation, cliquer sur « Next » pour démarrer l’installation
*Accepter l'accord de Licence
*Choisir le répertoire d'installation
*Choisir le type d'installation

Remarque :
Une installation de type « Typical » se déroule en conservant tous les paramètres par défaut pour le logiciel M-Processing Server. Ce mode d’installation est vivement conseillé, à moins que certains paramètres (tels que les ports de communication par exemple) doivent être personnalisés. L’installation de type « Custom » demande à ce que chaque paramètre nécessaire à l’installation et au fonctionnement du logiciel soit renseigné.
*Localiser le fichier de configuration ainsi que le répertoire des binaires du serveur Web Apache.
*Renseigner le nom de la société, ainsi que le nom et l’adresse IP du serveur (récupéré sur le système) :
*Laisser l'installation se dérouler jusqu'à son terme, puis cliquer sur « Finish » pour terminer l'installation.

Le programme d’installation crée deux raccourcis dans le menu « Démarrer » du serveur :
*Tous les programmes > MappingSuite > Software activation (application pour l’activation logicielle)
*Tous les programmes > MappingSuite > M-Processing Server (interface Web d’administration de la solution)

Des entrées sont également ajoutées dans la base de registre Windows.

==BASE DE REGISTRE WINDOWS==

Un certain nombre de valeurs sont sauvegardées dans la base de registre Windows lors de l’installation de M-Processing Server : « HKEY_LOCAL_MACHINE\SOFTWARE\Mapping\MAPPING ».

Note :
Sur les systèmes en 64 bits, le chemin dans la base de registre est :
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Mapping\MAPPING

La plupart des valeurs ne sont qu’à titre informatif, sans utilité fonctionnelle.
Certaines seront lues et utilisées lors de futures mises à jour ou désinstallation.
Une seule valeur est réellement importante et utilisée : MAPPING_PATH, qui pointe sur le fichier de configuration de M-Processing Server.

Dans tous les cas, il est déconseillé de modifier manuellement quoi que ce soit dans la base de registre 

==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.

===IDENTIFIANTS DU SERVEUR===

====MODE CONSOLE====
En mode console, saisir la commande <b>mapkey.exe</b> dans le répertoire des binaires Mapping. Cette commande permet de saisir les licences, mais affiche également les identifiants du serveur, requis pour le calcul des clés :

 C:\>cd "MAPPING\M-Processing Server\Applications"
 C:\MAPPING\M-Processing Server\Applications>mapkey.exe
 L'identifiant de votre machine : 0511104

====MODE GRAPHIQUE====

En mode graphique, l’application de saisie des clés propose également un affichage de l’identifiant serveur.

===SAISIE DES LICENCES D’ACTIVATION===

Chaque licence fournie par Mapping est identifiée par un numéro de produit (de 1 à 5 en version illimitée, ou de 250 à 254 en tarification au volume) et une valeur de clé (44 caractères hexadécimaux, séparés ou non par des tirets de mise en forme).

====MODE CONSOLE====

 C:\>cd "MAPPING\M-Processing Server\Applications"
 C:\MAPPING\M-Processing Server\Applications>mapkey.exe
 
 L'identifiant de votre machine : 0511104
 
 Entrez le numéro du produit : 254
 Entrez la clé : CE1FCF-1BCF1A-CA2AFE-2AFE2A-01D501-55012A-FED4FE-2A
 C:\MAPPING\M-Processing Server\Applications>

Remarques :

Les caractères ‘-‘ ne sont pas obligatoires lors de la saisie.

Lorsque la saisie est correcte, la commande rend la main. Sinon, elle redemande une nouvelle saisie de valeur de clé.

====MODE GRAPHIQUE====

En mode graphique, sélectionner « Clé logicielle », puis renseigner le numéro de produit ainsi que la valeur de la clé.
 
===RECHARGES DE PAGES===
La tarification au volume (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.

=====MODE CONSOLE=====

Exécuter la commande ‘<b>mapaddpts.exe -create</b>’ :

 C:\>cd "MAPPING\M-Processing Server\Applications"
 C:\MAPPING\M-Processing Server\Applications>mapaddpts.exe -create
 Votre Id : efb24a00(0)
 Votre machine : VALID (0511104)
 Votre fichier : VALID (C:\MAPPING\M-Processing Server\map400\key\map_key.key)
 Prochaine remise à zéro : Fri May 15 15:01:26 2015
 Points restants : 0.0
 Points acquis : 0.0

=====MODE GRAPHIQUE=====

Sélectionner « Recharge de pages » puis cliquer sur « + d’infos ».

====SAISIE DE LA RECHARGE====

Une recharge de pages M-Processing Server 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.

=====MODE CONSOLE=====

 C:\>cd "MAPPING\M-Processing Server\Applications"
 C:\MAPPING\M-Processing Server\Applications>mapaddpts.exe
 Votre Id : efb24a00(0)
 Votre machine : VALID (0511104)
 Votre fichier : VALID (C:\MAPPING\M-Processing Server\map400\key\map_key.key)
 Prochaine remise à zéro : Fri May 15 15:01:26 2015
 Points restants : 0.0
 Points acquis : 0.0
 
 Entrez le type de clé : 1
 Entrez la clé : FED2F24CACCEB57C10CEF6F3FFCFFFCEFFFFCE
 C:\MAPPING\M-Processing Server\Applications>

Remarque :

Lorsque la saisie est correcte, la commande rend la main. Sinon, elle redemande une nouvelle saisie de valeur de clé.

A tout moment, un état des lieux du compteur de pages restantes peut être obtenu et affiché.

En mode console, par la commande <b>mapreadpts.exe </b>:

 C:\MAPPING\M-Processing Server\Applications>
 C:\MAPPING\M-Processing Server\Applications>C:\MAPPING\M-Processing Server\Applications>mapreadpts.exe
 Votre Id : efb24a00(1)
 Votre machine : VALID (0511104)
 Votre fichier : VALID (C:\MAPPING\M-Processing Server\map400\key\map_key.key)
 Prochaine remise à zéro : Fri May 15 15:01:26 2015
 Points restants : 3794803.0
 Points acquis : 4000000.0

=====MODE GRAPHIQUE=====

Sélectionner « Recharge de pages », renseigner numéro de produit et valeur de clé, puis « Valider ».
En mode graphique, un état des lieux du compteur de pages restantes est affiché par « Recharge de pages », puis « + d’infos ».

==PROCEDURE DE MISE A JOUR==

Après avoir arrêté tous les Services M-Processing Server, exécuter le nouveau Setup obtenu ou téléchargé, autoriser l’élévation de droits si besoin, puis sélectionner l’option « Repair ».

Le programme met à jour l’ensemble des binaires utilisés par l’application dans les répertoires Applications et MapHTTPServer\cgi-bin, les fichiers de description et d’affichage des interfaces Web dans les répertoires MapHTTPServer\JS_Common et Settings\menu.

Il ne modifie ni les fichiers de configuration du Serveur M-Processing Server, ni les déclarations des différents objets : robots, files d’attentes, workflows, droits d’accès, etc.

==PROCEDURE DE DESINSTALLATION==

Pour désinstaller le logiciel du serveur, après avoir arrêté tous les Services M-Processing Server, il suffit d’exécuter le Setup, puis de sélectionner l’option « Remove ».

Le programme, une fois à son terme, supprime :
*Tous les fichiers du répertoire d’installation, sauf le fichier de log des installations (install.log)
*Les deux raccourcis dans le menu « Démarrer » du serveur
*Les entrées dans la base de registre

==PREMIERS DEPANNAGES==
===Problème d’installation / Fichier de configuration M-Processing Server incomplet===

Après installation, des messages d’erreur indiquant des variables manquantes dans le mapping.conf apparaissent, lors de l’exécution de commandes M-Processing Server.

<b>Explication</b>: En fin de Setup, des commandes sont exécutées afin de construire le fichier de configuration (mapping.conf) de M-Processing Server. Toutes ces commandes sont inscrites dans un fichier de log, situé dans le répertoire Settings de M-Processing Server : <b>install.log</b>.

<b>Solution</b> : Après avoir identifié et corrigé les erreurs d’appel de ces commandes (exemples : argument manquant ou sans valeur, un chemin terminé par un antislash final…), elles peuvent être relancées dans une fenêtre de commandes MS-DOS en tant qu’Administrateur, afin de reconstruire correctement le fichier de configuration Mapping.

===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.

<b>Solution</b>: Après installation ou mise à jour de M-PS, 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.

<b>Solution</b> : 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’informations, 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.

<b>Explication</b> : 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).<br />
<b>Solution</b> : 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’informations, et contactez le Support Technique.

==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 logiciel 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 *.bat 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 setup 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 devront être 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 conseillé 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 « C:\MAPPING\M-ProcessingServer » (variable <b>PATH_BASE_MAPPING</b> du fichier de configuration).

====DUPLICATION DE LA CONFIGURATION====

*déclaration des files d’attente dans le Spooler M-Processing Server (requis)
C:\MAPPING\M-ProcessingServer\Settings\queues\*
*déclaration des Workflows de traitements M-Processing Server (requis – excepté le sous-répertoire backup)
C:\MAPPING\M-ProcessingServer\Settings\rules\workflow\*
*déclarations des profils de conversion des documents XPS, notamment pour l’impression (requis)
C:\MAPPING\M-ProcessingServer\Settings\XPSConfig.conf
*déclarations des robots ‘Scanfolder’ M-Processing Server (si modifié)
C:\MAPPING\M-ProcessingServer\Settings\robot.conf
*déclarations des robots ‘Serveurs d’écoute’ M-Processing Server (si modifié)
C:\MAPPING\M-ProcessingServer\Settings\maprawd.conf
*déclarations des groupes d’utilisateurs M-Processing Server (si modifié)
C:\MAPPING\M-ProcessingServer\Settings\GROUPS.conf
*déclarations des utilisateurs M-Processing Server (si modifié)
C:\MAPPING\M-ProcessingServer\Settings\USERS.conf
*déclarations des différentes méthodes de visualisation des travaux dans le Spooler (si modifié)
C:\MAPPING\M-ProcessingServer\Settings\viewSettings.conf
*méthodes de déploiement d’un serveur à un autre (si modifié)
C:\MAPPING\M-ProcessingServer\Settings\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 pages dépendants de chaque serveur.

*objets décrivant les formats M-Connect et M-Designer en production (requis)
C:\MAPPING\M-ProcessingServer\map400\*
*ressources externes (images, XPS, traductions) utilisées dans les formats M-Designer (requis si utilisé)
C:\MAPPING\M-ProcessingServer\Import\lgobitmap\*
*ressources externes (traductions) utilisées dans les formats M-Connect (requis si utilisé)
C:\MAPPING\M-ProcessingServer\Import\lang\*

====AUTRES DUPLICATIONS====

*Fichiers sources des projets M-Connect / M-Designer (si sauvegardés sur le serveur M-Processing Server)
C:\MAPPING\M-ProcessingServer\Import\docpc\*
*Répertoire des archives (si utilisé par M-Storage)
C:\MAPPING\M-ProcessingServer\Archive\*
*Répertoire des logs du Spooler (optionnel, car elles peuvent être considérées comme propre à chaque serveur)
C:\MAPPING\M-ProcessingServer\Spooler\logs\*
*Répertoire des travaux du Spooler (optionnel, car ils peuvent être considérés comme propre à chaque serveur)
C:\MAPPING\M-ProcessingServer\Spooler\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.