ONYX Designer installation

Requirements

Setup

The ONYX Designer software is compatible with the following operating system versions:

• Windows 7, Windows 8, Windows 10
• Windows Server 2003, 2008 R2, 2012

To ensure proper functioning of the ONYX Suite, the host system must match the minimum hardware set up requirements and must feature the latest updates made available by the operating system's software publisher.

About 50 Mo of available disk space are needed to install Mapping software.

The Designer software is build in 32 bits, but is fully compatible with 64 bits operating systems.

System

Admin rights are required to install the software. Read and write rights on the installation folder are necessary for all users who are likely to use the software from this computer. Read and write rights on the working folder of the Opale Server are also necessary.

Connection to the server can be established via FTP or SFTP transfer, UNC path or network drive.

Depending on the configuration of the client architecture, Designer project source files can be stored on a file server which is shared by all users of the application.

Read and write rights on this sharing folder are required.

Installation process

Installation programs of the software are available for download on the Mapping technical server at: http://serveur.mappingsuite.com.

They are called "M-Designer_setup_version onyx".

• Launch the installation executable.

On Windows 7 and up, the installation program will ask for user rights to be unrestricted, this needs to be authorized:

• Once installation files have been unzipped, click on "Next" to start the installation:
• Agree to the license terms.
• Choose the installation folder.

Important advice:

On Windows 7 and up, even if it does not hinder functioning, it is highly recommended not to install the software in the default suggested folder C:\Program Files (x86)\M-ProcessingServer because of the stringent security restrictions put in place by Microsoft.

For instance, C:\MAPPING\M-Designer", is a better option.

• Let the installation executable run until the installation is complete, then click on "Finish" to conclude the installation:

The installation program creates a shortcut in the "Start" menu of the computer.

Entries are also added to the Windows Registry of the computer.

Windows registry:

Un certain nombre de valeurs sont sauvegardées dans la base de registre Windows lors de l’installation et de l’utilisation de M-Designer.

Quelques valeurs de base sont écrites dès l’installation du logiciel dans HKEY_LOCAL_MACHINE\SOFTWARE\Mapping\M-Designer\Settings

Sur les systèmes en 64 bits, le chemin dans la base de registre est HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Mapping\M-Designer\Settings

La plupart des valeurs restent ensuite liées à l’utilisateur connecté sur le PC et exécutant l’application dans son contexte.

Elles sont alors écrites dans HKEY_CURRENT_USER\Software\Mapping\M-Designer

4 sous-répertoires sont créés :

• Recent File List : liste des derniers projets ouverts
• Server : liste des serveurs M-Processing Server configurés dans les Préférences de M-Designer
• Settings : paramètres de configuration et d’utilisation de l’application
• Workspace : paramètres d’affichage des différentes vues de l’interface

Procédure de mise à jour

Mise à jour

Le logiciel M-Designer ne doit pas être en cours d’exécution sur le poste. Lancer 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 les fichiers de l’application dans le répertoire d’installation.

Mise à niveau

A l’exécution du nouveau Setup obtenu, le process scrute la base de registre du poste afin de récupérer le contexte. Dans le chemin HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\Mapping, la détection de la version courante installée sur le poste est réalisée dans cet ordre :

• Si présence d’une clé M-designer, une mise à jour classique est faite.
• Si présence d’une clé Mapdraw , un upgrade de MapDraw version 7 vers M-Designer est effectué.

Lors d’une mise à niveau, le répertoire d’installation de la version antérieure est récupéré dans la base de registre, puis le processus se poursuit en mettant à jour les fichiers de l’application. Les exécutables de l’ancienne version sont supprimés et remplacés par le nouveau M-Designer.exe, les anciens raccourcis du menu Démarrer sont remplacés par le nouveau, et l’entrée « M-Designer » est rajoutée dans la base de registre.

Procédure de désinstallation

Pour désinstaller le logiciel M-Designer de l’ordinateur, il suffit simplement de relancer le Setup, puis de sélectionner l’option « Remove » : Le programme supprime les fichiers de l’application, puis détruit le répertoire d’installation (sauf si des fichiers ont été modifiés manuellement) et supprime le raccourci dans le menu « Démarrer » de l’ordinateur.

En revanche, il ne supprime pas les entrées de la base de registre, ceci afin de retrouver toute les préférences lors d’une éventuelle réinstallation du logiciel. Si besoin, les 2 entrées dans HKLM et HKCU peuvent être supprimées manuellement.

Les valeurs à supprimer sont stockées à ces différents emplacement dans la base de Registre Windows :

• HKEY_CURRENT_USER \SOFTWARE\Mapping\M-Designer
• HKEY_LOCAL_MACHINE\SOFTWARE\Mapping\M-Designer (si le logiciel a été installé avec un système d’exploitation en 32bits).
• HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432NODE\Mapping\M-Designer (si le logiciel a été installé avec un système d’exploitation en 64bits).