ONYX - 9.0 - Installation

ONYX Server installation on Windows

De MappingDoc
Révision datée du 17 juillet 2019 à 13:48 par Alestoquoi (discussion | contributions) (Page créée avec « ==Launching the interface== Once the installation is finished, the Apache service needs to be restarted before accessing the managing web interface of ONYX Server. »)
Autres langues :
English • ‎français

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.

Installing the API REST extension

Requirements

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

Installation

  1. Link to download Node.js: if Node.js is not installed on the server, this link redirects you to the download page
  2. Installation parameters: the listening port from which the API REST is available
  3. Confirm the installation: once you have clicked on the installation button, a loading page appears as the extension is installed
  4. Loading page: this page shows the state of the installation, this can take a few minutes. Once the extension is installed, an ending page is displayed

post-installation configuration on Windows

Software keys

Once the installation is finished, the first thing you have to do is enter the license keys.

  1. Open the Software activation application in the list of applications
  2. Enter the license keys: check the Software key box, two input fields appear.
  • In the first field: enter the product number (number from 1 to 5)
  • In the second field: enter the license keys (combination of numbers and uppercase letters, separated by dashes)

Launching the interface

Once the installation is finished, the Apache service needs to be restarted before accessing the managing web interface of 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.

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.