Jump to: navigation, search

Install IMSMANG Version 6

4,272 bytes added, 23:30, 11 March 2019
no edit summary
* Windows Vista
* Windows 7
* Windows 8 (There are some specific extra steps that have to be done for '''[[Windows 8and Windows 10| Windows 8]]''')* Windows 10 (There are some specific extra steps that have to be done for '''[[Windows 8 and Windows 10| Windows 10]]''')
* Windows Server 2003
* Windows Server 2008
* (Windows Server 2012)
For more details on technical specifications '''[[Technical Specification Equipment | here]]'''.
{{note| {{IMSMANG}} v 6.0 has not been extensively tested on Windows 2012. Please contact your '''[[Information Management Team |GICHD IM Advisor at GICHD ]]''' before installing {{IMSMANG}} on Windows 2012.}}
==Part 1. Run the {{IMSMANG}} Installer==
[[Image:InstallationGuideStep1.png|center|500px|''Running the IMSMA Installer'']]
<li>Right-click on the '''Install_IMSMA.exe''' file in the installation package and choose ''Run as administrator''.</li>
[[Image:Cmd NG.png|center|400px]]
<li>When the command window displays, follow the instructions.</li>
[[Image:Error msg installation.png|center|350px]]
<ol><li>Double-click the If you get this error message then select ''This program installed correctly'Install_IMSMA.exe''' file in the installation package.</li><li>When the command window displays, follow the instructions.
{| class="wikitable"|-| [[File:Note.jpg | 40px]]| [[Image:Graphic NGStarting graphical installer.png|center400px]]| If it looks like the installation program does not start then the Graphic installer window is hiding behind another window. If the Graphic installer is not starting then check if Java 8 installed then you need to install Java 7 manually. Installer for Java 7 (''jre-7u5-windows-i586.exe'') is included in the IMSMA installation package. It is also recommended to turn off '''[[Java automatic update |200pxautomatic update of Java]]</li>'''. |}
[[Image:Graphic NG.png|center|200px]]<li>On the Language Selection window, select the language you want to use during installation and click '''OK'''.</li>
[[Image:1st panel NG.png|center|400px]]</li>
<li>Navigate the Installation panels of the graphical installer as described below:</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>{{Note | If you are upgrading from version 5.x or re-installing 6.0, it is important that you '''[[Uninstall IMSMANG and related applications | uninstalled]]''' the previous {{IMSMANG}} installation '''and''' deleted the C:\IMSMAng folder.}}
<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>
[[Image:5th panel NG.png|center|400px]]
<li>Wait for the installation progress bar to finish, then click '''Next'''.</li>
{{Note | If the installation cannot finish the first bar, Pack installation progress, it might be caused by defective installation package files/USB memory stick, see '''[[Java error during installation]]'''. <br/> If the installation cannot finish the second bar, Overall installation progress, then the user does not have permission to create services.}}
<li>When the Setup Shortcuts panel displays, click '''Next'''.</li>
<li>When the installation has completed successfully, click '''Done'''.</li>
{{note | 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.}}
{{note | 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.}}</li></ol>
<li>When prompted by the command window, press any key on the keyboard to continue.</li>
<li>Turn off '''[[Java automatic update]]'''.
==Part 2. Set Permissions for the Tray LauncherIMSMA Control Centre==
[[Image:InstallationGuideStep2.png|center|500px|''Setting Tray Launcher IMSMA Control Centre Permissions'']]
<div align="center">
#<ol><li>On your desktop, right-click the IMSMA Tray Launcher icon and select the '''Properties''' option.</li>#<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 3. Install Supporting Software==
<li>On your desktop, double-click the IMSMA Tray Launcher icon.</li>
[[Image:Support SW.png|center|400px]]</li>
#When ArcGIS has been successfully installed, click '''Finish'''.
If the installer did not start automatically, you will find it here: ''C:\IMSMAng\trayLauncher\exe\ArcGISEngine''.
{{Note|.Net 3.5 is a prerequisite for installing ArcEngine, if it is not installed on the computer you may * Windows XP and Windows 7: download the installation program from here: '''[]'''* Windows 8 and Windows 10: .Net is already installed and has to be '''[[Windows 8 and Windows 10#.Net activation | activated]]'''. The above installation program does not work and off-line installation is not possible.}}
===Part 3B. Kiwix===
[[Image:InstallationGuideStep4.png|center|500px|''Installing Kiwix'']]
[[Image:Graphic Kiwix.png|center|200px250px]]
<li>On the Installer Language dialog, select the language you want to use during installation, and then click '''OK'''.</li>
<li>When the Kiwix Setup panel displays, click '''License Agreement'''.</li>
<li>After reading the license agreement, click '''I Agree'''.</li>
<li>Click '''Next'''.</li>
<li>In the Installing panel, wait for the progress bar to finish, and then click '''Next'''.</li>
<li>When Kiwix has been installed on your computer, unselect '''Start Run Kiwix''' and click '''Finish'''.</li>
If the installer did not start automatically, you will find it here: ''C:\IMSMAng\trayLauncher\exe\Kiwix\install''
===Part 3C. Fonts===
If you do not have a database to restore than then you should create an initial IMSMA database. If you are installing on Windows 8 please refer to this '''[[Windows 8|page]]or Windows 10''' then you need to configure PostgreSQL before restoring or creating a new database.<br/> <br/>
[[Image:IPv6.png|500px]] <br />
<li> Open the file ''C:\IMSMAng\pgsql\data\pg_hba.conf'' with a text editor e.g. Notepad</li>
<li> Delete the # on row 86 and save the file</li>
===Initial Database===
To create the initial database:
#Open the '''c:\imsmang\database''' folder.#Double-click the '''install_initial.bat''' file.#In the command window, press any key to start get started and then enter the password (which is ''password'') and press Enter. The database generationwill start.#When the generation is finished you will be prompted to press any key to continue. ==Part 5 Type of configuration==[[Image:InstallationGuideStep7.png|center|500px|''Configuring Client/server'']]{{IMSMANG}} is a application that consists of two layers; client and server, and may be configured in two different ways:* stand-alone - '''both''' server and client parts are on the '''same''' computer (incl. database)* client/server - server and client(s) parts are on '''different''' computers
{{ note You may read more about application layers and configuration '''[[Understanding Configuration Options | It is very important that you do not have any connection to the database when you create an initial database or restore a databasehere]]'''.The IMSMA server should not be started, no connection with PGAdmin, Navicat, iReport or OCBC sources. }}
 {| border="1" align=Part 5 Type of installation"center"|- valign="top"|[[Image:stand_alone_Architecture_2.png|center|100px|''Stand-alone Configuration'']]<div align="center">''Stand-alone configuration''</div>|[[Image:InstallationGuideStep7Understanding Configuration Options - Networked Config.png|center|500px300px|''Configuring Client/serverConfiguration'']]XXX<div align="center">''Client/server configuration''</div> |}  For both client/server and stand-alone installations there might be a need to configure allocated [[Understanding Configuration Options#Memory settings|'''configure allocated memory''']].
===Part 5A Stand-alone===
Got If so desired set '''[[Add a Local ID Generator | SystemName]]''' which is helpful avoiding duplicates on ID by:<ol><li>Start the IMSMA Control Centre by clicking on the IMSMA TrayLauncher shortcut.</li> [[Image:ClientConfig.png|center|500px]]<div align="center"></div> <li>Select the '''IMSMA Client Configuration Tool''' option.</li></ol> '''Go to [[Install IMSMANG Version 6#Part 6. Verify installation| Part 6]]''', do '''not''' change the configurations as outlined in Part 5B '''Client/server''' since they are configuration for '''another''' type of installation than what you have.
===Part 5B Client/server===
<li>Navigate to the '''c:\imsmang\server\imsmaserver\conf''' directoryfolder.</li>
<li>Open the '''''' file.</li>
<li>Set the fileserverURI.base property to '''http://localhost:8080''' where ''localhost'' is the name or IP address of the {{IMSMANG}} server.</li>
To configure the client in a client/server installation:
<li>Start the IMSMA Control Centre by clicking on the IMSMA TrayLaunchershortcut.</li> [[Image:ClientConfig.png|center|500px]]<div align="center"></div> 
<li>Select the '''IMSMA Client Configuration Tool''' option.</li>
<li>Select the value for the java.naming.provider.url property.</li>
<ol type="a">
<li>Set the java.naming.provider.url value to '''hostname.domain''' replacing hostname and domain with the appropriate values, or to the IP address of the server.</li>
<li>Press the '''[Enter]Save''' key.</li>
</li><li>Set the value for the isClientOnly property.</li>
<ol type="a">
<li>Enter “true” in the Value cell for the isClientOnly property.</li>
<li>Press the '''[Enter]Save''' key.</li>
</li><li>Set the value for the AlwaysSyncGeodata propertymay be set to ''true'' also for clients.<ol type="a"><li>Enter “false” in the Value cell for the AlwaysSyncGeodata propertyThe difference between true and false is described '''[[IMSMA Client Configuration Tool | here]]'''.</li> <li>Press the If so desired set '''[Enter[Add a Local ID Generator | SystemName]]''' keywhich is helpful avoiding duplicates on ID.</li><li>Click the '''Save''' button.</li>
<ol type="a">
[[Image:Changes saved.png|center|250px]]
<div align="center">
<li>The Your changes have been saved message displays.</li>
<li>Click the '''OK''' button.</li>
</li><li>Click the '''Exit''' button.</li></li></ol>
==Part 6. Verify installation==
The {{IMSMANG}} installation is now complete. After installation it is important to '''start ''' the {{IMSMANG}} client in order to verify that the installation is complete and working.This is especially important if the user that did the installation, e.g. an IT administrator, is not the same local user that will use {{IMSMANG}}.
Follow these steps If you do not know how to start the {{IMSMANG}} server, click '''[[Starting and Stopping IMSMANG#STANDALONE INSTALLATIONS Start the IMSMA Server | stand-alonehere]] server or ''' for instructions, and '''[[Starting and Stopping IMSMANG#CLIENT/SERVER INSTALLATIONS Log into IMSMA | starthere]] ''' for instructions on how to start the client. ===Part 6A How to solve ArcEngine problems===If the ArcEngine license is not registered and activated you will not be able to use {{IMSMANG}}. Below you will find steps on how to solve it.
'''ArcEngine license error message'''
[[Image:ArcEngine lic missing.png|center|250px]]
<div align="center">
'' ArcEngine license error message''
Select ''AvailibilityAvailability'' in the tree structure and verify that you have ''Expires'' set for ''ArcGIS Engine '' and ''Spatial Analyst''.
If ''Expires '' is not set then right-click on IMSMA Control Center Centre icon in the taskbar and select IMSMA Client Configuration Tool.
Open the ArcGIS administrator and verify that ''Expires'' are set. If not, restart the computer and repeat the steps above until ''Expires'' are set.
'''Verify that the fonts are installed'''===Part 6B How to solve font problems===In When you have been able to start the {{IMSMANG}} server and client, in the Navigation window, choose ''Map display'' in the Map menu and expand Land by Type. If the symbols looks like the symbols in the picture below, the font installation has worked.
[[Image:Font works.png|center|400px]]
If the font installation has did not work, go worked:<ol><li>Go to ''C:\IMSMAng\trayLauncher\exe\FONTSInstaller and copy ''.</li><li>Copy the files manually to ''C:\Windows\Fonts''.</li><li>In most cases it is enough to get the symbols refreshed to restart the IMSMA client.</li><li>If not, restart the computer.</li><li>Start the IMSMA server and client.</li><li>If the symbols in the map still do not look OK then<br/>Go File menu and import the map again.</li></ol>{{NavBox Getting started with IMSMANG Administration}}

Navigation menu