Installation ONYX Server pour Windows
Installation d'ONYX Server sous Windows : prérequis, procédure d'installation, extension API REST et mise à jour.
Prérequis
ONYX Server 9.0 fonctionne sous Windows Server 2012 R2, 2016 ou 2019
Le serveur Web Apache version 2.4 doit être installé sur le serveur avant d’installer ONYX Server
Si vous souhaitez appeler les fonctions d’ONYX Server via le module complémentaire API REST (web service), il convient d’installer Node.js version 8.10 ou supérieure au préalable
Installation du serveur Mapping
Lancer Setup_ONYX_Server_XXXXX.exe. Le setup s’exécutera dans cet ordre :
Mode d’installation
deux modes d’installation sont disponibles, Custom ou Typical. Dans les deux cas, l’installation se fera toujours dans le dossier précédemment choisi mais des options de configuration spécifiques seront disponibles en mode Custom. Nous vous recommandons de choisir le mode d’installation Typical. Les options du mode Custom seront toujours modifiables après l’installation.

Paramètres d’installation
trois paramètres sont demandés. Ces données serviront pour le paramétrage de ONYX Server dans le fichier de configuration d’Apache : nom de société, nom du serveur sur lequel est installé le logiciel, adresse IP du serveur (il est fortement conseillé d’utiliser l’adresse de boucle locale “127.0.0.1”)

Installation de l’extension API REST
Prérequis
Node.js version 8.10 ou supérieur doit être installé sur le serveur.
Installation
Configuration post-installation sur Windows
Clés de licence
Une fois l’installation terminée, la première chose à faire est de saisir les clés de licence.
Ouvrir l’application Software activation dans la liste des applications

Saisir les clés de licence : cocher Clé logicielle, deux champs de saisie apparaissent.

Dans le premier champ : saisir le numéro de produit (chiffre allant de 1 à 5)
Dans le deuxième champ : saisir la clé de licence (combinaison de chiffres et de lettres en majuscules, séparés par des tirets)
Ouvrir Software activation
Saisir les clés
Modification de la configuration Apache dans le cas d’une version 2.4
Si, comme cela est préconisé, 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.
La section Mapping du httpd.conf est identifiée par le mot clé #BEGIN_MAPPING_...
Pour cela :- Supprimer le noeud <Directory C:\xxxxx\xxxxx\MapHTTPServer\cgi-bin> du fichier httpd.conf (c’est-à-dire le noeud xml complet avec tout son contenu et la balise de fin </Directory>)- Supprimer les instructions suivantesNameVirtualHost ...``AllowOverride all``Order allow,deny``Allow from all– Ajouter les instruction présentes dans le fichier MapHTTPServer\.htaccess directement dans le noeud <Directory C:\xxxx\xxxx\MapHTTPServer>– Remonter l’instruction ServerName en début de bloc, avant la balise - Supprimer (mettre en commentaire) le module “mod_access_compat.so” si jamais il était activé- Supprimer (ou renommer) le fichier MapHTTPServer\.htaccess
La section Mapping du fichier httpd.conf devrait alors ressembler à ceci (exemple basé sur une installation effectuée dans “C:\Mapping\MappingServer”) :
Blocs de configuration optionnels (modèles)
Il s’agit de configurations optionnelles pouvant être ajoutées directement dans le noeud décrit ci-dessus.
Pour lister le contenu des dossiers de configuration du serveur
Cette configuration permet de parcourir les fichiers de configuration Mapping directement depuis l’interface, avec accès limité à l’utilisateur mapadmin. Pour l’utiliser, il suffit d’ajouter “/dir” derrière l’url.
Exemple : http://monserveurmapping:8002/dir
Pour protéger l’accès à l’interface de Workflow
Cette configuration permet limiter l’accès à l’interface du Workflow uniquement à l’utilisateur mapadmin.
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.
Ouvrir une page de navigateur internet
Saisir dans l’URL :
Depuis le serveur en local :
http://127.0.0.1:8002Depuis un poste en réseau :
http://<ip.du.serveur>:8002
8002 étant le port configuré par défaut lors de l’installation
S’ils n’ont pas été modifiés lors de l’installation, les identifiants de connexion sont les suivants :
Nom d’utilisateur : mapadmin
Mot de passe : mapadmin
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, mais que la modification relative à sa configuration n’a pas été faite (voir ci-dessus) ou que Apache n’a pas été redémarré correctement.
L’interface du Workflow ne se lance pas
Il est possible que les redistribuables nécessaire à l’exécution du binaire mapsoapserver.exe ne soient pas installés sur la machine hôte (en fonction de la version de Windows utilisée). Pour valider l’origine du problème, il suffit d’exécuter le binaire mapsoapserver.exe (situé dans le dossier C:\Mapping\MappingServer\MapHTTPServer\cgi-bin) et constater un message d’erreur lié à une dll manquante.
Les packages redistribuables Visual C++ pour Visual Studio 2013 sont disponibles à la page suivante : https://www.microsoft.com/fr-FR/download/details.aspx?id=40784 Le package concerné est le fichier “vcredist_x86.exe” qu’il faut télécharger et installer. Il n’est pas nécessaire de relancer l’installation de Mapping Onyx Server.
Démarrer le Spooler Mapping
Pour activer le spooler Mapping :
Ouvrir l’interface de ONYX Server
Cliquer sur les icônes suivantes dans l’ordre :
Menu d’Administration
Gestion des Impressions
Gestion du Spooler
Démarrer le Spooler
Une fois le spooler démarré, un service nommé Mapping_spooler apparaît dans la liste des services Windows (services.msc)
Mise à jour de ONYX Server
Mise à jour de l’extension API REST
Si l’extension est déjà installée, seule la mise à jour est disponible.
Cliquer sur Suivant mettra à jour les extensions.

Mis à jour















