ONYX Server installation on Windows

This page explains how to install ONYX Server on Windows.

Requirements

• ONYX Server 9.0 runs under Windows Server 2012 R2, 2016 or 2019
• The Web Apache server version 2.2 or 2.4 must be installed on the server before ONYX Server is installed
• If you wish to call ONYX Server functions via the additional API REST module (web service), install Node.js version 8.10 or more beforehand.

Installing the Mapping server

Launch Setup_ONYX_Server_XXXXX.exe. The setup will execute itself in the following order:

1. Home page
2. M-Processing Server loading page: this can load for a couple minutes; once it is loaded, a second window opens to install the M-Processing Server
3. M-Processing Server Home page
4. Terms of use
5. Requirements and recommendations: read this page carefully to set the installation environment properly
6. Installation folder: choose the M-Processing Server folder, a standard installation path is already filled in by default, however we would recommend you to install it in a folder which is specific to the root of your system drive, ex: C:\Mapping\M-ProcessingServer
7. Installation mode: two installation modes are available, Custom or Typical. In both cases, the installation is done in the file chosen previously but the specific configuration options are available in Custom mode. We recommend you to choose the Typical installation mode. You can always come back to the options of the Custom mode and change them after the installation.
8. Apache configuration folder: specify the path of the Apache conf folder
9. Apache binary folders: specify the path of the Apache bin folder
10. Installation parameters: three parameters are required. This data is used to parameter the M-processing Server in the Apache configuration folder: name of the company, name of the server on which the software is installed, IP address of the serveur (we recommend you to use the local loop address "127.0.0.1")
11. Installation of the software. Once the software is installed, the end page is displayed, click on the Finish button, ONYX Server is then installed and the following page lets you parameter the basic setup
12. Extensions available: list of all the extensions available. Caution: some extensions may need you to abide by some requirements!
13. Leave the setup: If no extensions are needed, you leave the setup via the Cancel button in image 12, a popup window will appear, click on Yes to leave the setup.

• 

  1.Page de bienvenue

• 

  2.Chargement du setup M-Processing Server

• 

  3.Page de bienvenue de M-Processing Server

• 

  4.Conditions d'utilisation

• 

  5.Prérequis et recommandations

• 

  6.Dossier d'installation

• 

  7.Mode d'installation

• 

  8.Chemin du dossier de configuration d'Apache

• 

  9.Chemin du dossier des binaires d'Apache

• 

  10.Paramètres d'installation

• 

  12.Extensions disponibles

• 

  13.Quitter le setup

Installing the API REST extension

Requirements

Node.js version 8.10 or higher must be installed on the server.

Installation

1. Lien de téléchargement de Node.js : si Node.js n'est pas installé sur le serveur, ce lien vous redirigera vers la page de téléchargement
2. Paramètres d'installation : le port d'écoute depuis lequel l'API REST sera disponible
3. Confirmation de l'installation : après avoir cliqué sur le bouton Installer, une page de chargement s'affichera pendant l'installation jusqu'à la page de fin du setup
4. Page de chargement : cette page indique la progression de l'installation, le chargement peut prendre plusieurs minutes. L'installation débouchera sur la page de fin de setup

• 

  1.Lien de téléchargement de Node.js

• 

  2.Paramètres d'installation

• 

  3.Confirmation de l'installation

• 

  4.Page de chargement

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.

1. Ouvrir l'application Software activation dans la liste des applications
2. 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

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.

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 :

1. Ouvrir le fichier de configuration d'Apache, httpd.conf (il se trouve dans le dossier conf, référencé lors de l'installation)
2. Chercher le bloc de configuration situé entre #BEGIN_MAPPING et #END_MAPPING (généralement en bas du fichier)
3. 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 activer le module mod_access_compat dans le fichier de configuration d'Apache httpd.conf.

Pour cela :

1. Ouvrir le fichier de configuration d'Apache, httpd.conf (il se trouve dans le dossier conf, référencé lors de l'installation)
2. Chercher la ligne contenant mod_acces_compat.so

Supprimer le caractère # en début de ligne comme illustré dans l'exemple suivant :

#LoadModule access_compat_module /usr/lib/apache/mod_access_compat.so

LoadModule access_compat_module /usr/lib/apache/mod_access_compat.so

Puis, redémarrer le service Apache.

Démarrer le Spooler Mapping

Pour activer le spooler Mapping :

1. Ouvrir l'interface de M-processing Server
2. 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 M-Processing Server

1. Lancer le setup et de choisir l'option Repair
2. Si la question "Do you confirm the update of this environment?" apparaît, cliquer Oui
3. La mise a jour se déroule, si une erreur concernant map_daemon.exe apparaît, vérifier que le service Mapping_Spooler est bien arrêté. L'arrêter s'il est toujours actif.
4. Cliquer sur Finish pour terminer la mise à jour de M-Processing Server et afficher la fenêtre des extensions.

• 

  1.Choisir l'option mise à jour

• 

  3.Chargement de la mise à jour

• 

  4.Termine la mise à jour

Mise à jour de l'extension API REST

Si l'extension est déjà installée, seule la mise à jour est disponible.

1. Cliquer sur Suivant mettra à jour les extensions.

• 

  1.Mettre à jour l'extension