Changes

Jump to: navigation, search

Patch Installation Guide

2,644 bytes added, 13:09, 4 May 2021
no edit summary
{{Note| Patch installation of {{IMSMANG}} v 6.0 is '''ONLY''' possible to use when {{IMSMANG}} v 6.0 is already installed and the database is '''ALREADY''' upgraded to v 6.0.TOC right}}
{{Note| Patch installation of {{IMSMANG}} v 6.0 is '''ONLY''' possible to use when {{IMSMANG}} v 6.0 is already installed.}} ==Part 1. Preparations==__NOEDITSECTION__ {{Warning| Read this section carefully because the patch installation will change configuration files.}} [[Image:PatchInstallationGuideStep1.png|center|500px|''Running Preparation before running the IMSMA Patch Installer'']]==Part 1. Preparations==
<ol>
<li>Stop the {{IMSMANG}} client and server.
<li>If you have made any changes to the [[Install IMSMANG Version 6#Part 5 Type of configuration| client and/or server configuration]], note them down.
<li>Take a backup of the {{IMSMANG}} database.
<li>Stop Exit the {{IMSMANG}} client, server and TrayLauncherIMSMA Control Centre.<li>Take a copy of the two main PostGreSQL configuration file files ''C:\IMSMAng\pgsql\data\pg_hba.conf'' and ''C:\IMSMAng\pgsql\data\postgresql.conf''. These contain any custom configurations, e.g. allowing remote database access, etc.<li>If you have set up [[PgSQL_Replication|SQL replication]], you also should take a copy of ''recovery.conf'' on the standby server, as well as the above mentioned configuration files on '''both the master and the standby server'''.</ol> ==Part 2. Run the {{IMSMANG}} Patch Installer==__NOEDITSECTION__ [[Image:PatchInstallationGuideStep2.png|center|500px|''Running the IMSMA Patch Installer'']]
==Part 2. Run the {{IMSMANG}} Installer==
[[Image:Cmd NG.png|center|400px]]
<ol>
<li>Double-click the '''Install_IMSMA.exe''' file in the patch installation package.</li>
<li>When the command window displays, follow the instructions.
[[Image:Graphic NG.png|center|200px]]</li>
 
<li>On the Language Selection window, select the language you want to use during installation and click '''OK'''.
[[Image:1st panel NG.png|center|400px]]</li>
<li>In the Welcome panel, click '''Next'''.</li>
<li>Select the ''I accept the terms of this license agreement'' option, and click '''Next'''.</li>
<li>We strongly recommend to use the default installation path for {{IMSMANG}}. Click '''Next'''.</li>
<li>If the target folder does not already exist a message will be shown, click '''OK'''.</li>
<li>In the packages selection panel, click '''Next'''.</li>
<li>Wait for the installation progress bar to finish, then click '''Next'''.</li>
</ol>
==Part 3. Set Permissions for the Tray LauncherIMSMA Control Centre==__NOEDITSECTION__ [[Image:PatchInstallationGuideStep2PatchInstallationGuideStep3.png|center|500px|''Setting Tray Launcher IMSMA Control Centre Permissions'']]
<div align="center">
</div>
<li>In the IMSMA Tray Launcher Properties window, select the '''Shortcut''' tab, then click '''Advanced'''. </li>
<li>In the Advanced Properties window, check the '''Run as administrator''' checkbox, then click '''OK'''. It is important to use ''Run as administrator'' the first time {{IMSMANG}} is started since other installation programs will be triggered. Depending on how much user permissions are limited, it might be better to not Run as administrator.</li>
<li>Back in the IMSMA Tray Launcher Properties window, click '''OK'''. It is important to set this property since you will start other applications with the Tray Launcher.</li></ol>==Part 4. PostGreSQL configuration==__NOEDITSECTION__ [[Image:PatchInstallationGuideStep4.png|center|500px|''PostGreSQL configuration'']] If there have been any changes done in the PostGreSQL configuration files# C:\IMSMAng\pgsql\data\pg_hba.conf# C:\IMSMAng\pgsql\data\postgresql.conf# C:\IMSMAng\pgsql\data\recovery.confthey have to be '''re-applied'''.  {{Note| There might have been changes of the files in the patch so all customisation needs to be '''re-applied'''. Note that if you have [[PgSQL_Replication|SQL replication]] set up, the right configuration files need to be restored on the master and the standby server, and the initial backup procedure from the master to the standby needs to be applied. }} ==Part 5. Verification of the client/server configuration==__NOEDITSECTION__ [[Image:PatchInstallationGuideStep5.png|center|500px|''Verification of the client/server configuration'']]
The patch installation may also update other configurations than the PostGreSQL so the client and/or server configurations should be verified before continuing.<ol><li> Re- apply any changes to config The file Note''C: there are changes to \IMSMAng\trayLauncher\TrayLauncher.properties'' where the config file so DO re-apply (as in do memory allocation is set, should not just rename filechanged by the patch installation.<br/><br/>[[Image:ClientConfig.png|center|500px]]<lidiv align="center"> Start TrayLauncher<li/div> If there are any database changes the Update will start automatically
<li>The client configuration should not changed by the patch installation.
<li> The file ''c:\imsmang\server\imsmaserver\conf\GisService.properties'' needs to be double-checked.
</ol>
==Part 6. Database Update==__NOEDITSECTION__ [[Image:PatchInstallationGuideStep6.png|center|500px|''Database update'']] <ol><li>On your desktop, double-click the IMSMA Tray Launcher icon.<br/> [[Image:DBupdate1.png|center|400px]]</li> <li>A message will be displayed notifying you if there are any database changes that needs to be applied. Click '''OK''' to begin the process(es).</li>  [[Image:DBupdate2.png|center|600px]]</li> <li>A SQL Upgrade window will display and the progress will be shown in the lower part of the window.  [[Image:DBupdate3.png|center|400px]]</li>  <li>When the update process is done a message will be displayed. Click '''OK'''. </ol> {{NavBox Getting started with IMSMANG Administration}}
[[Category:NAA]]
 
[[Category:NoPublic]]
6,632
edits

Navigation menu