View source for Install IMSMANG Version 6

{{TOC right}}

==Computer Requirements==__NOEDITSECTION__
The computer running IMSMA<sup>NG</sup> 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 Server 2003
* Windows Server 2008

{{note| IMSMA<sup>NG</sup> v 6.0 has not been extensively tested on Windows 8 and Windows 2012. Contact your IM Advisor at GICHD before installing IMSMA<sup>NG</sup> on Windows 8 or Windows 2012.}}

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 on C-drive
* minimum memory setting 1,024 MB

{{note | If you are upgrading from previous IMSMA <sup>NG</sup> versions, please read the [[Upgrade from 5.04 to 5.05 | upgrade]] documentation first.}}

==Part 1. Run the IMSMA Installer==__NOEDITSECTION__

[[Image:InstallationGuideStep1.png|center|500px|''Running the IMSMA Installer'']]
<div align="center">
''Running the IMSMA Installer''
</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>On the Language Selection window, select the language you want to use during installation and click '''OK'''.</li>
<li>Navigate the Installation panels of the graphical installer as described below:</li>
<ol type="a">
<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 IMSMA<sup>NG</sup>. 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>
<li>When the Setup Shortcuts panel displays, click '''Next'''.</li>
<li>When the installation has completed successfully, click '''Done'''.</li>
</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>
</ol>

==Part 2. Set Permissions for the Tray Launcher==__NOEDITSECTION__

[[Image:InstallationGuideStep2.png|center|500px|''Setting Tray Launcher Permissions'']]
<div align="center">
''Setting Tray Launcher Permissions''
</div>

#On your desktop, right-click the IMSMA Tray Launcher icon and select the '''Properties''' option.
#In the IMSMA Tray Launcher Properties window, select the '''Shortcut''' tab, then click '''Advanced'''. 
#In the Advanced Properties window, check the '''Run as administrator''' checkbox, then click '''OK'''.
#Back in the IMSMA Tray Launcher Properties window, click '''OK'''.

==Part 3. Install Supporting Software==__NOEDITSECTION__

#On your desktop, double-click the IMSMA Tray Launcher icon.
#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__

[[Image:InstallationGuideStep3.png|center|500px|''Installing ArcGIS'']]
<div align="center">
''Installing ArcGIS''
</div>

#On the Welcome window, wait for the setup to compute space requirements, and then click '''Next'''.
#On the License Agreement window, select the ''I accept the license agreement'' option, and then click '''Next'''.
#On the Select Installation Type window, verify that the '''Complete''' option is selected, and then click '''Next'''.
#On the Destination Folder window, click '''Next'''.
#On the Python Destination Folder window, click '''Next'''.
#On the Ready to Install the Application window, click '''Next'''.
#On the Updating System window, wait for the progress bar to finish.
#When ArcGIS has been successfully installed, click '''Finish'''.

===Part 3B. Kiwix===__NOEDITSECTION__

[[Image:InstallationGuideStep4.png|center|500px|''Installing Kiwix'']]
<div align="center">
''Installing Kiwix''
</div>

#On the Installer Language dialog, select the language you want to use during installation, and then click '''OK'''.
#When the Kiwix Setup window displays, click '''License Agreement'''.
#After reading the license agreement, click '''I Agree'''. 
#Click '''Next'''.
#On the Installing window, wait for the progress bar to finish, and then click '''Next'''.
#When Kiwix has been installed on your computer, unselect '''Start Kiwix''' and click '''Finish'''.

===Part 3C. Fonts===__NOEDITSECTION__

[[Image:InstallationGuideStep5.png|center|500px|''Installing Fonts'']]
<div align="center">
''Installing Fonts''
</div>

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

==Part 4. Database==__NOEDITSECTION__

[[Image:InstallationGuideStep6.png|center|500px|''Selecting Database'']]
<div align="center">
''Selecting Database''
</div>

If you do not have a database to restore than you should create a start-up IMSMA<sup>NG</sup> database.

{| class="wikitable"
|+ Database Installation
! If you want to...
! Do...
|-
| start up the database
| see the initial database section below.
|-
| restore the database
| see the [[Upgrade from 5.04 to 5.05 | upgrade]] instructions.
|-
|}

===Initial Database===__NOEDITSECTION__

To create the initial database:

#Open the '''c:\imsmang\database''' folder.
#Double-click the '''install_initial.bat''' file.
#In the command window, enter ''password''.
#Press the '''[Enter]''' key.
#When prompted to press any key to continue, press a key on the keyboard.

==Part 5 Client/Server==__NOEDITSECTION__

[[Image:InstallationGuideStep7.png|center|500px|''Configuring Client/Server'']]
<div align="center">
''Configuring Client/Server''
</div>

If you will use IMSMA as a stand-alone installation, skip Part 5.

To configure the server in a client / server installation:

<ol>
<li>Navigate to the '''c:\imsmang\server\imsmaserver\conf''' directory.
<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 IMSMA<sup>NG</sup> server.
<li>Save the changes to the file.
</ol>

To configure the client in a client / server installation:
<ol>
<li>Start the TrayLauncher.</li>
<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]''' key.</li>
</ol>
<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]''' key.</li>
</ol>
<li>Set the value for the AlwaysSyncGeodata property.</li>
<ol type="a">
<li>Enter “false” in the Value cell for the AlwaysSyncGeodata property.</li>
<li>Press the '''[Enter]''' key.</li>
<li>Click the '''Save''' button.</li>
<ol type="a">
<li>The Your changes have been saved message displays.</li>
<li>Click the '''OK''' button.</li>
</ol>
<li>Click the '''Exit''' button.</li>
</ol>
</ol>

==Part 6. ArcEngine License==__NOEDITSECTION__

[[Image:InstallationGuideStep8.png|center|500px|''Obtaining ArcGIS License'']]
<div align="center">
''Obtaining ArcGIS License''
</div>

(This section will be written when the issue is solved.)

The IMSMA<sup>NG</sup> installation is now complete. You may now start the server and client.

{{NavBox HowTo Installing}}