Guide d'installation ONYX Designer/en

<languages/>
==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. 

Les droits en Lecture et Écriture sur ce répertoire de partage sont requis.

==Procédure d'installation==

Les programmes d’installation du logiciel sont disponibles en téléchargement sur le serveur technique Mapping, à l’adresse : http://serveur.mappingsuite.com.

Ils sont nommés « M-Designer_setup_version onyx ».

*Lancer l'exécutable d'installation.

Sur Windows 7 et supérieur, le programme d’installation demandera une élévation de droits, qu’il faudra autoriser :
 
*Après l’extraction des fichiers d'installation, cliquer sur « Next » pour démarrer l’installation :
*Accepter l'accord de Licence.
*Choisir le répertoire d'installation.


Conseil important :

Sur Windows 7 et supérieur, et bien que cela n’empêche pas le fonctionnement, il est vivement conseillé de ne pas installer le logiciel dans le répertoire proposé par défaut <code>C:\Program Files (x86)\M-ProcessingServer </code> en raison des restrictions de sécurité très élevées mises en place par Microsoft.

On pourra préférer par exemple <code>C:\MAPPING\M-Designer"</code>

*Laisser l'installation se dérouler jusqu'à son terme, puis cliquer sur « Finish » pour terminer l'installation :

Le programme d’installation crée un raccourci dans le menu « Démarrer » de l’ordinateur.

Des entrées sont également ajoutées dans la base de registre Windows du PC.


<u>Base de registre Windows</u> :

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 <code>HKEY_LOCAL_MACHINE\SOFTWARE\Mapping\M-Designer\Settings</code>

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

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 <code>HKEY_CURRENT_USER\Software\Mapping\M-Designer</code>


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 <code>HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\Mapping</code>, 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 <code>HKLM</code> et <code>HKCU</code> peuvent être supprimées manuellement.
 
Les valeurs à supprimer sont stockées à ces différents emplacement dans la base de Registre Windows : 
* <code>HKEY_CURRENT_USER \SOFTWARE\Mapping\M-Designer</code>
* <code>HKEY_LOCAL_MACHINE\SOFTWARE\Mapping\M-Designer</code> (si le logiciel a été installé avec un système d’exploitation en 32bits). 
* <code>HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432NODE\Mapping\M-Designer</code> (si le logiciel a été installé avec un système d’exploitation en 64bits).