Difference between revisions of "Install IMSMANG Version 6"

From IMSMA Wiki
Jump to: navigation, search
(Computer Requirements)
 
(74 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 
{{TOC right}}
 
{{TOC right}}
  
==Computer Requirements==__NOEDITSECTION__
+
==Computer Requirements==
 
The computer running {{IMSMANG}} may have one of the following operating systems:
 
The computer running {{IMSMANG}} may have one of the following operating systems:
 
* Windows® XP Professional 32 bits Service Pack 3 and for 64 bits Service Pack 2
 
* Windows® XP Professional 32 bits Service Pack 3 and for 64 bits Service Pack 2
 
* Windows Vista
 
* Windows Vista
 
* Windows 7
 
* Windows 7
 +
* Windows 8 (There are some specific extra steps that have to be done for '''[[Windows 8 and 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 2003
 
* Windows Server 2008
 
* Windows Server 2008
 +
* Windows Server 2012
 +
* Windows Server 2016
 +
* Windows Server 2019
  
{{note| {{IMSMANG}} v 6.0 has not been extensively tested on Windows 8 and Windows 2012. Contact your IM Advisor at GICHD before installing {{IMSMANG}} on Windows 8 or Windows 2012.}}
+
For more details on technical specifications '''[[Technical Specification Equipment | here]]'''.
  
The computer must have:
+
{{note| {{IMSMANG}} v 6.0 has not been tested by GICHD on Windows Server 2016 and 2019. Please contact your '''[[Information Management Team |GICHD IM Advisor]]''' before installing {{IMSMANG}} on Windows Server 2016 and 2019.}}
* A minimum 800 Mhz Pentium® or Xeon® processor (inter-workstation or server), or x86-compatible processor (AMD-K7™/Athlon™/Duron™/Sempron™)
 
* TCP/IP support
 
* 10/100 Mbps network adaptor
 
* A minimum screen resolution of 1024 x 768, with 256+ colours
 
* 3 GB free disk space on C-drive
 
* minimum memory setting 1,024 MB
 
  
{{note | If you are upgrading from previous {{IMSMANG}} versions, please read the [[Upgrading to IMSMA NG‏‎| upgrade]] documentation first.}}
+
==Part 1. Run the {{IMSMANG}} Installer==
  
==Part 1. Run the {{IMSMANG}} Installer==__NOEDITSECTION__
+
[[Image:InstallationGuideStep1.png|center|500px|''Running the IMSMA Installer'']]
  
[[Image:InstallationGuideStep1.png|center|500px|''Running the IMSMA Installer'']]
+
<ol>
<div align="center">
+
<li>Right-click on the '''Install_IMSMA.exe''' file in the installation package and choose ''Run as administrator''.</li>
</div>
 
  
 
[[Image:Cmd NG.png|center|400px]]
 
[[Image:Cmd NG.png|center|400px]]
<div align="center">
 
</div>
 
  
<ol>
 
<li>Double-click the '''Install_IMSMA.exe''' file in the installation package.</li>
 
 
<li>When the command window displays, follow the instructions.</li>
 
<li>When the command window displays, follow the instructions.</li>
  
 +
[[Image:Error msg installation.png|center|350px]]
 +
 +
<li>If you get this error message then select ''This program installed correctly''.</li>
 +
 +
{| class="wikitable"
 +
|-
 +
| [[File:Note.jpg | 40px]]
 +
| [[Image:Starting graphical installer.png|400px]]
 +
| 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 | automatic update of Java]]'''.
 +
|}
  
 
[[Image:Graphic NG.png|center|200px]]
 
[[Image:Graphic NG.png|center|200px]]
<div align="center">
 
</div>
 
 
<li>On the Language Selection window, select the language you want to use during installation and click '''OK'''.</li>
 
<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]]
 
[[Image:1st panel NG.png|center|400px]]
<div align="center">
 
</div>
 
 
  
 
<li>Navigate the Installation panels of the graphical installer as described below:</li>
 
<li>Navigate the Installation panels of the graphical installer as described below:</li>
<ol type="a">
+
<ol>
 
<li>In the Welcome panel, click '''Next'''.</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>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>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>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>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>
 
<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 Setup Shortcuts panel displays, click '''Next'''.</li>
 
<li>When the installation has completed successfully, click '''Done'''.</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.}}
 
</ol>
 
</ol>
  
{{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>When prompted by the command window, press any key on the keyboard to continue.</li>
 
<li>When prompted by the command window, press any key on the keyboard to continue.</li>
 +
<li>Turn off '''[[Java automatic update]]'''.
 
</ol>
 
</ol>
  
==Part 2. Set Permissions for the Tray Launcher==__NOEDITSECTION__
+
==Part 2. Set Permissions for the IMSMA Control Centre==
  
[[Image:InstallationGuideStep2.png|center|500px|''Setting Tray Launcher Permissions'']]
+
[[Image:InstallationGuideStep2.png|center|500px|''Setting IMSMA Control Centre Permissions'']]
 
<div align="center">
 
<div align="center">
 
</div>
 
</div>
  
#On your desktop, right-click the IMSMA Tray Launcher icon and select the '''Properties''' option.
+
<ol>
#In the IMSMA Tray Launcher Properties window, select the '''Shortcut''' tab, then click '''Advanced'''.  
+
<li>On your desktop, right-click the IMSMA Tray Launcher icon and select the '''Properties''' option.</li>
#In the Advanced Properties window, check the '''Run as administrator''' checkbox, then click '''OK'''.
+
<li>In the IMSMA Tray Launcher Properties window, select the '''Shortcut''' tab, then click '''Advanced'''. </li>
#Back in the IMSMA Tray Launcher Properties window, click '''OK'''.
+
<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==__NOEDITSECTION__
+
==Part 3. Install Supporting Software==
 
+
<ol>
#On your desktop, double-click the IMSMA Tray Launcher icon.
+
<li>On your desktop, double-click the IMSMA Tray Launcher icon.</li>
  
  
 
[[Image:Support SW.png|center|400px]]
 
[[Image:Support SW.png|center|400px]]
<div align="center">
 
</div>
 
  
  
#If any supporting software or fonts need to be installed, a message will display notifying you which ones are required. Click '''OK''' to begin the process(es).
 
  
===Part 3A. ArcEngine 10.1===__NOEDITSECTION__
+
<li>If any supporting software or fonts need to be installed, a message will display notifying you which ones are required. Click '''OK''' to begin the process(es).</li>
 +
</ol>
 +
===Part 3A. ArcEngine 10.1===
  
 
[[Image:InstallationGuideStep3.png|center|500px|''Installing ArcGIS'']]
 
[[Image:InstallationGuideStep3.png|center|500px|''Installing ArcGIS'']]
Line 94: Line 99:
  
 
[[Image:ArcEngine10.1.png|center|400px]]
 
[[Image:ArcEngine10.1.png|center|400px]]
<div align="center">
+
 
</div>
 
 
#In the Welcome panel, wait for the setup to compute space requirements, and then click '''Next'''.
 
#In the Welcome panel, wait for the setup to compute space requirements, and then click '''Next'''.
 
#In the License Agreement panel, select the ''I accept the license agreement'' option, and then click '''Next'''.
 
#In the License Agreement panel, select the ''I accept the license agreement'' option, and then click '''Next'''.
Line 105: Line 109:
 
#When ArcGIS has been successfully installed, click '''Finish'''.
 
#When ArcGIS has been successfully installed, click '''Finish'''.
  
===Part 3B. Kiwix===__NOEDITSECTION__
+
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
 +
* Windows XP and Windows 7: download the installation program from here: '''[http://mwiki.gichd.org/mediawiki/images/0/00/dotnetfx35sp1.zip dotnetfx35sp1.zip]'''
 +
* 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:InstallationGuideStep4.png|center|500px|''Installing Kiwix'']]
<div align="center">
 
</div>
 
  
[[Image:Graphic Kiwix.png|center|200px]]
+
[[Image:Graphic Kiwix.png|center|250px]]
<div align="center">
 
</div>
 
  
#On the Installer Language dialog, select the language you want to use during installation, and then click '''OK'''.
+
 
#When the Kiwix Setup panel displays, click '''License Agreement'''.
+
<ol>
#After reading the license agreement, click '''I Agree'''.
+
<li>On the Installer Language dialog, select the language you want to use during installation, and then click '''OK'''.</li>
#Click '''Next'''.
+
<li>Click '''Next'''.</li>
#In the Installing panel, wait for the progress bar to finish, and then click '''Next'''.
+
<li>In the Installing panel, wait for the progress bar to finish, and then click '''Next'''.</li>
  
 
[[Image:Kiwix.png|center|400px]]
 
[[Image:Kiwix.png|center|400px]]
<div align="center">
 
</div>
 
  
#When Kiwix has been installed on your computer, unselect '''Start Kiwix''' and click '''Finish'''.
+
<li>When Kiwix has been installed on your computer, unselect '''Run Kiwix''' and click '''Finish'''.</li>
 +
</ol>
 +
 
 +
If the installer did not start automatically, you will find it here: ''C:\IMSMAng\trayLauncher\exe\Kiwix\install''
  
===Part 3C. Fonts===__NOEDITSECTION__
+
===Part 3C. Fonts===
  
 
[[Image:InstallationGuideStep5.png|center|500px|''Installing Fonts'']]
 
[[Image:InstallationGuideStep5.png|center|500px|''Installing Fonts'']]
<div align="center">
 
</div>
 
  
[[Image:Font.png|center|200px]]
+
 
<div align
+
[[Image:Font.png|center|250px]]
 +
 
  
 
The fonts '''IMSMA 2006.ttf''', '''IMSMA 2006 2.ttf''', '''IMSMA2009.ttf''' and '''IMSMA2013.ttf''' files will be installed on your computer.
 
The fonts '''IMSMA 2006.ttf''', '''IMSMA 2006 2.ttf''', '''IMSMA2009.ttf''' and '''IMSMA2013.ttf''' files will be installed on your computer.
  
==Part 4. Database==__NOEDITSECTION__
+
==Part 4. Database==
  
 
[[Image:InstallationGuideStep6.png|center|500px|''Selecting Database'']]
 
[[Image:InstallationGuideStep6.png|center|500px|''Selecting Database'']]
Line 144: Line 150:
 
</div>
 
</div>
  
If you do not have a database to restore than you should create a start-up IMSMA database.
+
If you do not have a database to restore then you should create an initial IMSMA database. If you are installing on '''Windows 8 or Windows 10''' then you need to configure PostgreSQL before restoring or creating a new database. <br/> <br/>
  
{| class="wikitable"
+
[[Image:IPv6.png|500px]] <br />
|+ Database Installation
+
<ol>
! If you want to...
+
<li> Open the file ''C:\IMSMAng\pgsql\data\pg_hba.conf'' with a text editor e.g. Notepad</li>
! Do...
+
<li> Delete the # on row 86 and save the file</li>
|-
+
</ol>
| create an empty database
 
| see the initial database section below.
 
|-
 
| restore an existing database
 
| see the [[Upgrading to IMSMA NG‏‎| upgrade]] instructions.
 
|-
 
|}
 
  
===Initial Database===__NOEDITSECTION__
+
===Initial Database===
  
 
To create the initial database:
 
To create the initial database:
  
#Open the '''c:\imsmang\database''' folder.
+
# Open the ''c:\imsmang\database'' folder.
#Double-click the '''install_initial.bat''' file.
+
# Double-click the '''install_initial.bat''' file.
#In the command window, enter ''password''.
+
# In the command window, press any key to get started and then enter the password (which is ''password'') and press Enter. The database generation will start.
#Press the '''[Enter]''' key.
+
# When the generation is finished you will be prompted to press any key to continue.
#When prompted to press any key to continue, press a key on the keyboard.
 
  
==Part 5 Client/Server==__NOEDITSECTION__
+
==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
  
[[Image:InstallationGuideStep7.png|center|500px|''Configuring Client/Server'']]
+
You may read more about application layers and configuration '''[[Understanding Configuration Options | here]]'''.
 +
 
 +
 
 +
{| border="1" align="center"
 +
|- valign="top"
 +
|
 +
[[Image:stand_alone_Architecture_2.png|center|100px|''Stand-alone Configuration'']]
 +
<div align="center">
 +
''Stand-alone configuration''
 +
</div>
 +
|
 +
[[Image:Understanding Configuration Options - Networked Config.png|center|300px|''Client/server Configuration'']]
 
<div align="center">
 
<div align="center">
 +
''Client/server configuration''
 
</div>
 
</div>
  
If you will use IMSMA as a stand-alone installation, skip Part 5.
+
|}
 +
 
  
To configure the server in a client / server installation:
+
For both client/server and stand-alone installations there might be a need to [[Understanding Configuration Options#Memory settings|'''configure allocated memory''']].
  
 +
===Part 5A Stand-alone===
 +
If so desired set '''[[Add a Local ID Generator | SystemName]]''' which is helpful avoiding duplicates on ID by:
 
<ol>
 
<ol>
<li>Navigate to the '''c:\imsmang\server\imsmaserver\conf''' directory.
+
<li>Start the IMSMA Control Centre by clicking on the IMSMA TrayLauncher shortcut.</li>
<li>Open the '''GisService.properties''' file.
+
 
<li>Set the fileserverURI.base property to '''http://localhost:8080''' where ''localhost'' is the name or IP address of the {{IMSMANG}} server.
+
[[Image:ClientConfig.png|center|500px]]
<li>Save the changes to the file.
+
<div align="center">
 +
</div>
 +
 
 +
<li>Select the '''IMSMA Client Configuration Tool''' option.</li>
 
</ol>
 
</ol>
  
To configure the client in a client / server installation:
+
'''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===
 +
To configure the server in a client/server installation:
 +
 
 +
<ol>
 +
<li>Navigate to the ''c:\imsmang\server\imsmaserver\conf'' folder.</li>
 +
<li>Open the '''GisService.properties''' 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>
 +
<li>Save the changes to the file.</li>
 +
</ol>
 +
 
 +
To configure the client in a client/server installation:
 
<ol>
 
<ol>
<li>Start the TrayLauncher.</li>
+
<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>
 
<li>Select the '''IMSMA Client Configuration Tool''' option.</li>
 
<li>Select the value for the java.naming.provider.url property.</li>
 
<li>Select the value for the java.naming.provider.url property.</li>
 
<ol type="a">
 
<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>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]''' key.</li>
+
<li>Press the '''Save''' key.</li>
 
</ol>
 
</ol>
 +
 
<li>Set the value for the isClientOnly property.</li>
 
<li>Set the value for the isClientOnly property.</li>
 
<ol type="a">
 
<ol type="a">
 
<li>Enter “true” in the Value cell for the isClientOnly property.</li>
 
<li>Enter “true” in the Value cell for the isClientOnly property.</li>
<li>Press the '''[Enter]''' key.</li>
+
<li>Press the '''Save''' key.</li>
 
</ol>
 
</ol>
<li>Set the value for the AlwaysSyncGeodata property.</li>
+
 
<ol type="a">
+
<li>AlwaysSyncGeodata property may be set to ''true'' also for clients. The difference between true and false is described '''[[IMSMA Client Configuration Tool | here]]'''.</li>
<li>Enter “false” in the Value cell for the AlwaysSyncGeodata property.</li>
+
 
<li>Press the '''[Enter]''' key.</li>
+
<li>If so desired set '''[[Add a Local ID Generator | SystemName]]''' which is helpful avoiding duplicates on ID.</li>
 
<li>Click the '''Save''' button.</li>
 
<li>Click the '''Save''' button.</li>
 
<ol type="a">
 
<ol type="a">
 +
 +
[[Image:Changes saved.png|center|250px]]
 +
<div align="center">
 +
</div>
 +
 
<li>The Your changes have been saved message displays.</li>
 
<li>The Your changes have been saved message displays.</li>
 
<li>Click the '''OK''' button.</li>
 
<li>Click the '''OK''' button.</li>
 
</ol>
 
</ol>
 +
 
<li>Click the '''Exit''' button.</li>
 
<li>Click the '''Exit''' button.</li>
 
</ol>
 
</ol>
</ol>
 
  
==Part 6. ArcEngine License==__NOEDITSECTION__
+
 
 +
==Part 6. Verify installation==
  
 
[[Image:InstallationGuideStep8.png|center|500px|''Obtaining ArcGIS License'']]
 
[[Image:InstallationGuideStep8.png|center|500px|''Obtaining ArcGIS License'']]
Line 219: Line 263:
 
</div>
 
</div>
  
(This section will be written when the issue is solved.)
+
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}}.
  
The {{IMSMANG}} installation is now complete. You may now start the server and client.
+
If you do not know how to start the {{IMSMANG}} server, click '''[[Start the IMSMA Server | here]]''' for instructions, and '''[[Log into IMSMA | here]]''' for instructions on how to start the client.
==Part 7. Verify installation==__NOEDITSECTION__
 
After installation it is important to start {{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}}.
 
  
 +
===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]]
[[Image:ArcEngine lic missing.png|center|300px]]
 
 
<div align="center">
 
<div align="center">
 +
'' ArcEngine license error message''
 
</div>
 
</div>
  
Line 245: Line 288:
 
</div>
 
</div>
  
Select ''Availibility'' in the tree structure and verify that you have ''Expires'' set for ArcGIS Engine and Spatial Analyst.
+
Select ''Availability'' 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 icon in the taskbar and select IMSMA Client Configuration Tool.
+
If ''Expires'' is not set then right-click on IMSMA Control Centre icon in the taskbar and select IMSMA Client Configuration Tool.
  
[[Image:ClientConfig.png|center|300px]]
+
[[Image:ClientConfig.png|center|400px]]
 
<div align="center">
 
<div align="center">
 
</div>
 
</div>
Line 257: Line 300:
 
Open the ArcGIS administrator and verify that ''Expires'' are set. If not, restart the computer and repeat the steps above until ''Expires'' are set.
 
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 the client, 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.
+
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]]
 
[[Image:Font works.png|center|400px]]
Line 264: Line 307:
 
</div>
 
</div>
  
If the font installation has not work, go to C:\IMSMAng\trayLauncher\exe\FONTSInstaller and copy the files manually to C:\Windows\Fonts.
+
If the font installation did not worked:
 
+
<ol>
 +
<li>Go to ''C:\IMSMAng\trayLauncher\exe\FONTSInstaller''.</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 IMSMA NG Administration}}
  
{{NavBox HowTo Installing}}
+
[[Category:NAA]]

Latest revision as of 12:29, 9 December 2019

Computer Requirements

The computer running IMSMANG may have one of the following operating systems:

  • Windows® XP Professional 32 bits Service Pack 3 and for 64 bits Service Pack 2
  • Windows Vista
  • Windows 7
  • Windows 8 (There are some specific extra steps that have to be done for Windows 8)
  • Windows 10 (There are some specific extra steps that have to be done for Windows 10)
  • Windows Server 2003
  • Windows Server 2008
  • Windows Server 2012
  • Windows Server 2016
  • Windows Server 2019

For more details on technical specifications here.

Note.jpg IMSMANG v 6.0 has not been tested by GICHD on Windows Server 2016 and 2019. Please contact your GICHD IM Advisor before installing IMSMANG on Windows Server 2016 and 2019.

Part 1. Run the IMSMANG Installer

Running the IMSMA Installer
  1. Right-click on the Install_IMSMA.exe file in the installation package and choose Run as administrator.
  2. Cmd NG.png
  3. When the command window displays, follow the instructions.
  4. Error msg installation.png
  5. If you get this error message then select This program installed correctly.
  6. Note.jpg Starting graphical installer.png 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 automatic update of Java.

    Graphic NG.png
  7. On the Language Selection window, select the language you want to use during installation and click OK.
  8. 1st panel NG.png
  9. 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. We strongly recommend to use the default installation path for IMSMANG. Click Next.
    4. Note.jpg If you are upgrading from version 5.x or re-installing 6.0, it is important that you uninstalled the previous IMSMANG installation and deleted the C:\IMSMAng folder.
    5. If the target folder does not already exist a message will be shown, click OK.
    6. In the packages selection panel, click Next.
    7. 5th panel NG.png
    8. Wait for the installation progress bar to finish, then click Next.
    9. Note.jpg 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.
      If the installation cannot finish the second bar, Overall installation progress, then the user does not have permission to create services.
    10. When the Setup Shortcuts panel displays, click Next.
    11. When the installation has completed successfully, click Done.
    12. Note.jpg 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.


  10. When prompted by the command window, press any key on the keyboard to continue.
  11. Turn off Java automatic update.

Part 2. Set Permissions for the IMSMA Control Centre

Setting IMSMA Control Centre Permissions
  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 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.
  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 3. Install Supporting Software

  1. On your desktop, double-click the IMSMA Tray Launcher icon.

  2. Support SW.png


  3. If any supporting software or fonts need to be installed, a message will display notifying you which ones are required. Click OK to begin the process(es).

Part 3A. ArcEngine 10.1

Installing ArcGIS
ArcEngine10.1.png
  1. In the Welcome panel, wait for the setup to compute space requirements, and then click Next.
  2. In the License Agreement panel, select the I accept the license agreement option, and then click Next.
  3. In the Select Installation Type panel, verify that the Complete option is selected, and then click Next.
  4. In the Destination Folder panel, click Next.
  5. In the Python Destination Folder panel, click Next.
  6. In the Ready to Install the Application panel, click Next.
  7. In the Updating System panel, wait for the progress bar to finish.
  8. 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.jpg .Net 3.5 is a prerequisite for installing ArcEngine, if it is not installed on the computer
  • Windows XP and Windows 7: download the installation program from here: dotnetfx35sp1.zip
  • Windows 8 and Windows 10: .Net is already installed and has to be activated. The above installation program does not work and off-line installation is not possible.

Part 3B. Kiwix

Installing Kiwix
Graphic Kiwix.png


  1. On the Installer Language dialog, select the language you want to use during installation, and then click OK.
  2. Click Next.
  3. In the Installing panel, wait for the progress bar to finish, and then click Next.
  4. Kiwix.png
  5. When Kiwix has been installed on your computer, unselect Run Kiwix and click Finish.

If the installer did not start automatically, you will find it here: C:\IMSMAng\trayLauncher\exe\Kiwix\install

Part 3C. Fonts

Installing Fonts


Font.png


The fonts IMSMA 2006.ttf, IMSMA 2006 2.ttf, IMSMA2009.ttf and IMSMA2013.ttf files will be installed on your computer.

Part 4. Database

Selecting Database

If you do not have a database to restore then you should create an initial IMSMA database. If you are installing on Windows 8 or Windows 10 then you need to configure PostgreSQL before restoring or creating a new database.

IPv6.png

  1. Open the file C:\IMSMAng\pgsql\data\pg_hba.conf with a text editor e.g. Notepad
  2. Delete the # on row 86 and save the file

Initial Database

To create the initial database:

  1. Open the c:\imsmang\database folder.
  2. Double-click the install_initial.bat file.
  3. In the command window, press any key to get started and then enter the password (which is password) and press Enter. The database generation will start.
  4. When the generation is finished you will be prompted to press any key to continue.

Part 5 Type of configuration

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

You may read more about application layers and configuration here.


Stand-alone Configuration

Stand-alone configuration

Client/server Configuration

Client/server configuration


For both client/server and stand-alone installations there might be a need to configure allocated memory.

Part 5A Stand-alone

If so desired set SystemName which is helpful avoiding duplicates on ID by:

  1. Start the IMSMA Control Centre by clicking on the IMSMA TrayLauncher shortcut.
  2. ClientConfig.png
  3. Select the IMSMA Client Configuration Tool option.

Go to 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

To configure the server in a client/server installation:

  1. Navigate to the c:\imsmang\server\imsmaserver\conf folder.
  2. Open the GisService.properties file.
  3. Set the fileserverURI.base property to http://localhost:8080 where localhost is the name or IP address of the IMSMANG server.
  4. Save the changes to the file.

To configure the client in a client/server installation:

  1. Start the IMSMA Control Centre by clicking on the IMSMA TrayLauncher shortcut.
  2. ClientConfig.png
  3. Select the IMSMA Client Configuration Tool option.
  4. Select the value for the java.naming.provider.url property.
    1. 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.
    2. Press the Save key.
  5. Set the value for the isClientOnly property.
    1. Enter “true” in the Value cell for the isClientOnly property.
    2. Press the Save key.
  6. AlwaysSyncGeodata property may be set to true also for clients. The difference between true and false is described here.
  7. If so desired set SystemName which is helpful avoiding duplicates on ID.
  8. Click the Save button.
    1. Changes saved.png
    2. The Your changes have been saved message displays.
    3. Click the OK button.
  9. Click the Exit button.


Part 6. Verify installation

Obtaining ArcGIS License

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.

If you do not know how to start the IMSMANG server, click here for instructions, and here 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 lic missing.png

ArcEngine license error message

If this error message is received then start the ArcGIS administrator in Start menu > ArcGIS.


ArcGISAdmin1.png

Select ArcEngine (Single Use) and click on OK.

ArcGISAdmin2.png

Select Availability 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 Centre icon in the taskbar and select IMSMA Client Configuration Tool.

ClientConfig.png

Click on Install license button, OK, Save and Exit.

Open the ArcGIS administrator and verify that Expires are set. If not, restart the computer and repeat the steps above until Expires are set.

Part 6B How to solve font problems

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.

Font works.png

If the font installation did not worked:

  1. Go to C:\IMSMAng\trayLauncher\exe\FONTSInstaller.
  2. Copy the files manually to C:\Windows\Fonts.
  3. In most cases it is enough to get the symbols refreshed to restart the IMSMA client.
  4. If not, restart the computer.
  5. Start the IMSMA server and client.
  6. If the symbols in the map still do not look OK then
    Go File menu and import the map again.