Changes

==Computer Requirements==__NOEDITSECTION__

{{noteFor more details on technical specifications '''[[Technical Specification Equipment | {{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 2012here]]'''.}}

The computer must have:* 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 {{note| {{IMSMANG}} v 6.0 has not been tested by GICHD on C-drive* minimum memory setting 1,024 MBWindows Server 2016 and 2019. Please contact your '''[[Information Management Team |GICHD IM Advisor]]''' before installing {{IMSMANG}} on Windows Server 2016 and 2019.}}

{{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==__NOEDITSECTION__

<li>DoubleRight-click on the '''Install_IMSMA.exe''' file in the installation packageand choose ''Run as administrator''.</li> [[Image:Cmd NG.png|center|400px]] 

<ol type="a">

<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.}}

==Part 2. Set Permissions for the Tray LauncherIMSMA Control Centre==__NOEDITSECTION__

[[Image:InstallationGuideStep2.png|center|500px|''Setting Tray Launcher IMSMA Control Centre Permissions'']]

#<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==<ol><li>On your desktop, double-click the IMSMA Tray Launcher icon.</li>  [[Image:Support SW.png|center|400px]]

<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===__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===__NOEDITSECTION__

#[[Image:Graphic Kiwix.png|center|250px]]  <ol><li>On the Installer Language dialog, select the language you want to use during installation, and then click '''OK'''.</li>#When the Kiwix Setup panel displays, click '''License Agreement'''.#After reading the license agreement, click '''I Agree'''. #<li>Click '''Next'''.</li>#<li>In the Installing panel, wait for the progress bar to finish, and then click '''Next'''.</li> [[Image:Kiwix.png|center|400px]]#<li>When Kiwix has been installed on your computer, unselect '''Start 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__

<div align=" [[Image:Font.png|center">|250px]]</div>

==Part 4. Database==__NOEDITSECTION__

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 or Windows 10''' then you need to configure PostgreSQL before restoring or creating a start-up IMSMA new database.<br/> <br/>

{[[Image:IPv6.png| class="wikitable"500px]] <br />|+ Database Installation<ol>! If you want to...! Do<li> Open the file ''C:\IMSMAng\pgsql\data\pg_hba.conf'' with a text editor e.g.Notepad</li>|-| create an empty database| see <li> Delete the initial database section below.|-| restore an existing database| see # on row 86 and save the [[Upgrading to IMSMA NG‏‎| upgrade]] instructions.|-file</li>|}</ol>

===Initial Database===__NOEDITSECTION__

#Open the '''c:\imsmang\database''' folder.#Double-click the '''install_initial.bat''' file.#In the command window, press any key to get started and then enter the password (which is ''password'') and press Enter.#Press the '''[Enter]''' keyThe database generation will 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, press a key and may be configured in two different ways:* stand-alone - '''both''' server and client parts are on the keyboard'''same''' computer (incl. database)* client/server - server and client(s) parts are on '''different''' computers  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">''Client/server configuration''</div> |} 

==Part 5 ClientFor both client/Server==__NOEDITSECTION__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><li>Start the IMSMA Control Centre by clicking on the IMSMA TrayLauncher shortcut.</li> [[Image:InstallationGuideStep7ClientConfig.png|center|500px|''Configuring Client/Server'']]

If you will use <li>Select the '''IMSMA as a stand-alone installation, skip Part 5Client 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===To configure the server in a client / server installation:

<li>Navigate to the '''c:\imsmang\server\imsmaserver\conf''' directoryfolder.</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>

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>Press the '''[Enter]Save''' key.</li>

<li>Press the '''[Enter]Save''' key.</li>

 <li>Set the value for the AlwaysSyncGeodata propertymay be set to ''true'' also for clients. The difference between true and false is described '''[[IMSMA Client Configuration Tool | here]]'''.</li><ol type="a"><li>Enter “false” in the Value cell for the AlwaysSyncGeodata property.</li><li>Press the If so desired set '''[Enter[Add a Local ID Generator | SystemName]]''' keywhich is helpful avoiding duplicates on ID.</li>

 ==Part 6. ArcEngine LicenseVerify installation==__NOEDITSECTION__

(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 section will be written when is especially important if the user that did the issue installation, e.g. an IT administrator, is solvednot the same local user that will use {{IMSMANG}}.)

The If you do not know how to start the {{IMSMANG}} installation is now complete. You may now start server, click '''[[Start the server IMSMA Server | here]]''' for instructions, and client.==Part 7. Verify installation==__NOEDITSECTION__After installation it is important '''[[Log into IMSMA | here]]''' for instructions on how to start {{IMSMANG}} the 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}}.

'''ArcEngine license error message'''[[Image:ArcEngine lic missing.png|nonecenter|300px250px]]<div align="leftcenter">'' ArcEngine license error message''

[[Image:ArcGISAdmin1.png|nonecenter|500px400px]]<div align="leftcenter">

[[Image:ArcGISAdmin2.png|nonecenter|500px400px]]<div align="leftcenter">

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.

[[Image:ClientConfig.png|nonecenter|500px400px]]<div align="leftcenter">

'''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|nonecenter|500px400px]]<div align="leftcenter">

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 IMSMA NG Administration}}