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:

Some values are saved into the Windows registry during the installation and when using Designer.

Some basic values are written from the installation of the software in HKEY_LOCAL_MACHINE\SOFTWARE\Mapping\M-Designer\Settings

In 64 bits systems, the path in the Windows registry is HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Mapping\M-Designer\Settings

Most values then remain linked to the user connected on the computer which runs the application in its context.

These are then written in HKEY_CURRENT_USER\Software\Mapping\M-Designer

4 subfolders are created:

• Recent File List: list of recently opened projects
• Server: list of M-Processing Server servers configured in the Designer Preferences
• Settings: application configuration and usage settings
• Workspace: display settings of the different design interfaces

Updating process

Updating designer

The Designer software must not be running on the workstation. Launch the new Setup executable you obtained or downloaded, accept for the access rights to be unrestricted if need be, then select the "Repair" option:

The program updates the application files in the installation folder.

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