Patch Installation Guide

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.

Part 1. Preparations

Read this section carefully because the patch installation will change configuration files.

1. Stop the IMSMA^NG client and server.
2. Take a backup of the IMSMA^NG database.
3. Stop the TrayLauncher.
4. Take copy of PostGreSQL configuration file C:\IMSMAng\pgsql\data\pg_hba.conf.
5. If you have change configuration of the Staging area database e.g. opening it for MINT connection, you should take a copy of ???
6. If you have set up SQL replication, you also should take a copy of C:\IMSMAng\pgsql\data\postgresql.conf and recovery.conf.

Part 2. Run the IMSMA^NG Patch Installer

1. Double-click the Install_IMSMA.exe file in the patch installation package.
2. When the command window displays, follow the instructions.
   
3. On the Language Selection window, select the language you want to use during installation and click OK.
   
4. Navigate the Installation panels of the graphical installer as described below:
   1. In the Welcome panel, click Next.
   2. Select the I accept the terms of this license agreement option, and click Next.
   3. In the packages selection panel, click Next.
   4. Wait for the installation progress bar to finish, then click Next.
   5. When the Setup Shortcuts panel displays, click Next.
   6. When the installation has completed successfully, click Done.

      When the graphical installer has finished the focus goes back to the command window and the next steps of the installation continue so please do not close the command window.

5. When prompted by the command window, press any key on the keyboard to continue.

Part 3. Set Permissions for the Tray Launcher

1. On your desktop, right-click the IMSMA Tray Launcher icon and select the Properties option.
2. In the IMSMA Tray Launcher Properties window, select the Shortcut tab, then click Advanced.
3. 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 IMSMA^NG 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.
4. 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.

Part 4. PostGreSQL configuration

If there have been any changes done in the PostGreSQL configuration file C:\IMSMAng\pgsql\data\pg_hba.conf, they have to be re-applied.

There might have changes in the patch so all customisation of pg_hba.conf needs to be re-applied.

4A. This always applies to Windows 8.
4B. Replication.

Part 5. 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.

1. The file C:\IMSMAng\trayLauncher\TrayLauncher.properties where the memory allocation is set, should not changed by the patch installation.
2. The client configuration should not changed by the patch installation.
3. The file c:\imsmang\server\imsmaserver\conf\GisService.properties needs to be double-checked.

Part 6. Database Update

1. On your desktop, double-click the IMSMA Tray Launcher icon.
   
2. 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).
3. A Update window will display and the process will be shown in the lower part of the window.
   
4. When the update process is done a message will be displayed. Click OK.