Différence entre versions

Version actuelle datée du 22 juillet 2019 à 10:22

Autres langues :

English • ‎français

Sommaire

1 Requirements
- 1.1 Setup
- 1.2 System
2 Installation process
3 Updating process
- 3.1 Updating designer
- 3.2 Update
4 Uninstalling the software

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.

Update

When running the new Setup executable obtained, the program analyses the Windows registry of the workstation to retrieve the context. In the path HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\Mapping, the current version installed is detected on the workstation following these steps:

If an M-designer key is detected, a standard update is made.
If a Mapdraw key is detected, MapDraw version 7 is updated to M-Designer.

During an update, the installation folder of the previous version is retrieved in the registry, then the process carries on updating the application's files. The executables of the previous version are deleted and replaced with the new M-Designer.exe, previous Start Menu shortcuts are also replaced with a new one. Finally, the "M-Designer" entry is added to the registry.

Uninstalling the software

To uninstall the M-Designer software from the computer, the Setup needs to be relaunched, then select option "Remove": The program deletes the application's files, then erases the installation folder (except if files were manually modified) and deletes the "Start" Menu shortcut of the computer.

However, it does not delete entries in the registry so as to retrieve all preferences during a potential reinstallation of the software. If need be, the two entries in HKLM and HKCU can be manually deleted.

Values to delete are stored in these different locations in the Windows registry:

HKEY_CURRENT_USER \SOFTWARE\Mapping\M-Designer
HKEY_LOCAL_MACHINE\SOFTWARE\Mapping\M-Designer (if the software was installed with a 32bits operating system).
HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432NODE\Mapping\M-Designer (if the software was installed with a 64bits operating system).

@@ Ligne 32 : / Ligne 32 : @@
 They are called "M-Designer_setup_version onyx".
-*Lancer l'exécutable d'installation.
+*Launch the installation executable.
-Sur Windows 7 et supérieur, le programme d’installation demandera une élévation de droits, qu’il faudra autoriser :
+On Windows 7 and up, the installation program will ask for user rights to be unrestricted, this needs to be authorized:
-*Après l’extraction des fichiers d'installation, cliquer sur « Next » pour démarrer l’installation :
+*Once installation files have been unzipped, click on "Next" to start the installation:
-*Accepter l'accord de Licence.
+*Agree to the license terms.
-*Choisir le répertoire d'installation.
+*Choose the installation folder.
-Conseil important :
+Important advice:
-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 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 <code>C:\Program Files (x86)\M-ProcessingServer </code> because of the stringent security restrictions put in place by Microsoft.
-On pourra préférer par exemple <code>C:\MAPPING\M-Designer"</code>
+For instance, <code>C:\MAPPING\M-Designer"</code>, is a better option.
-*Laisser l'installation se dérouler jusqu'à son terme, puis cliquer sur « Finish » pour terminer l'installation :
+*Let the installation executable run until the installation is complete, then click on "Finish" to conclude the installation:
-Le programme d’installation crée un raccourci dans le menu « Démarrer » de l’ordinateur.
+The installation program creates a shortcut in the "Start" menu of the computer.
-Des entrées sont également ajoutées dans la base de registre Windows du PC.
+Entries are also added to the Windows Registry of the computer.
-<u>Base de registre Windows</u> :
+<u>Windows registry</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.
+Some values are saved into the Windows registry during the installation and when using Designer.
-Quelques valeurs de base sont écrites dès l’installation du logiciel dans <code>HKEY_LOCAL_MACHINE\SOFTWARE\Mapping\M-Designer\Settings</code>
+Some basic values are written from the installation of the software in <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>
+In 64 bits systems, the path in the Windows registry is <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.
+Most values then remain linked to the user connected on the computer which runs the application in its context.
-Elles sont alors écrites dans <code>HKEY_CURRENT_USER\Software\Mapping\M-Designer</code>
+These are then written in <code>HKEY_CURRENT_USER\Software\Mapping\M-Designer</code>
-sous-répertoires sont créés :
+subfolders are created:
-*Recent File List : liste des derniers projets ouverts
+*Recent File List: list of recently opened projects
-*Server : liste des serveurs M-Processing Server configurés dans les Préférences de M-Designer
+*Server: list of M-Processing Server servers configured in the Designer Preferences
-*Settings : paramètres de configuration et d’utilisation de l’application
+*Settings: application configuration and usage settings
-*Workspace : paramètres d’affichage des différentes vues de l’interface
+*Workspace: display settings of the different design interfaces
-==Procédure de mise à jour==
+==Updating process==
-===Mise à jour===
+===Updating designer===
-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 » :
+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:
-Le programme met à jour les fichiers de l’application dans le répertoire d’installation.
+The program updates the application files in the installation folder.
-===Mise à niveau===
+===Update===
-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 :
+When running the new Setup executable obtained, the program analyses the Windows registry of the workstation to retrieve the context. In the path  <code>HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\Mapping</code>, the current version installed is detected on the workstation following these steps:
-*     Si présence d’une clé '''M-designer''', une mise à jour classique est faite.
+*     If an '''M-designer''' key is detected, a standard update is made.
-*     Si présence d’une clé '''Mapdraw''' , un upgrade de MapDraw version 7 vers '''M-Designer''' est effectué.
+*     If a '''Mapdraw''' key is detected, MapDraw version 7 is updated to '''M-Designer'''.
-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.
+During an update, the installation folder of the previous version is retrieved in the registry, then the process carries on updating the application's files.
-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
+The executables of the previous version are deleted and replaced with the new M-Designer.exe, previous Start Menu shortcuts are also replaced with a new one. Finally, the "M-Designer" entry is added to the registry.
-nouveau, et l’entrée « M-Designer » est rajoutée dans la base de registre.
-==Procédure de désinstallation==
+==Uninstalling the software==
-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.
+To uninstall the '''M-Designer''' software from the computer, the Setup needs to be relaunched, then select option "Remove": The program deletes the application's files, then erases the installation folder (except if files were manually modified) and deletes the "Start" Menu shortcut of the computer.
-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.
+However, it does not delete entries in the registry so as to retrieve all preferences during a potential reinstallation of the software. If need be, the two entries in <code>HKLM</code> and <code>HKCU</code> can be manually deleted.
-Les valeurs à supprimer sont stockées à ces différents emplacement dans la base de Registre Windows :
+Values to delete are stored in these different locations in the Windows registry:
 * <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\Mapping\M-Designer</code> (if the software was installed with a 32bits operating system).
-* <code>HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432NODE\Mapping\M-Designer</code> (si le logiciel a été installé avec un système d’exploitation en 64bits).
+* <code>HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432NODE\Mapping\M-Designer</code> (if the software was installed with a 64bits operating system).