Difference between revisions of "Install IMSMANG Version 6"

From IMSMA Wiki
Jump to: navigation, search
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
Line 21: Line 21:
 
{{note | If you are upgrading from previous {{IMSMANG}} versions, please read the [[Upgrading to IMSMA NG‏‎| upgrade]] documentation first.}}
 
{{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__
+
==Part 1. Run the {{IMSMANG}} Installer==
  
 
[[Image:InstallationGuideStep1.png|center|500px|''Running the IMSMA Installer'']]
 
[[Image:InstallationGuideStep1.png|center|500px|''Running the IMSMA Installer'']]
<div align="center">
 
</div>
 
  
 
[[Image:Cmd NG.png|center|400px]]
 
[[Image:Cmd NG.png|center|400px]]
<div align="center">
+
 
</div>
 
  
 
<ol>
 
<ol>
 
<li>Double-click the '''Install_IMSMA.exe''' file in the installation package.</li>
 
<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.
  
 +
[[Image:Graphic NG.png|center|200px]]</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'''.
<div align="center">
 
</div>
 
<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>
  
[[Image:1st panel NG.png|center|400px]]
+
<li>Navigate the Installation panels of the graphical installer as described below:
<div align="center">
+
<ol>
</div>
 
 
 
 
 
<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>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>
Line 56: Line 47:
 
<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>
 
<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'''.
</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.}}
+
{{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>
  
 
<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>
 
</ol>
 
</ol>
  
==Part 2. Set Permissions for the Tray Launcher==__NOEDITSECTION__
+
==Part 2. Set Permissions for the Tray Launcher==
  
 
[[Image:InstallationGuideStep2.png|center|500px|''Setting Tray Launcher Permissions'']]
 
[[Image:InstallationGuideStep2.png|center|500px|''Setting Tray Launcher Permissions'']]
Line 75: Line 67:
 
#Back in the IMSMA Tray Launcher Properties window, click '''OK'''.
 
#Back in the IMSMA Tray Launcher Properties window, click '''OK'''.
  
==Part 3. Install Supporting Software==__NOEDITSECTION__
+
==Part 3. Install Supporting Software==
 
<ol>
 
<ol>
<li>On your desktop, double-click the IMSMA Tray Launcher icon.</li>
+
<li>On your desktop, double-click the IMSMA Tray Launcher icon.
  
  
[[Image:Support SW.png|center|400px]]
+
[[Image:Support SW.png|center|400px]]</li>
<div align="center">
+
 
</div>
 
  
  
 
<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>
 
<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>
 
</ol>
===Part 3A. ArcEngine 10.1===__NOEDITSECTION__
+
===Part 3A. ArcEngine 10.1===
  
 
[[Image:InstallationGuideStep3.png|center|500px|''Installing ArcGIS'']]
 
[[Image:InstallationGuideStep3.png|center|500px|''Installing ArcGIS'']]
Line 94: Line 85:
  
 
[[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 95:
 
#When ArcGIS has been successfully installed, click '''Finish'''.
 
#When ArcGIS has been successfully installed, click '''Finish'''.
  
===Part 3B. Kiwix===__NOEDITSECTION__
+
===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|200px]]
<div align="center">
+
 
</div>
 
  
 
<ol>
 
<ol>
Line 120: Line 107:
 
<li>After reading the license agreement, click '''I Agree'''.</li>  
 
<li>After reading the license agreement, click '''I Agree'''.</li>  
 
<li>Click '''Next'''.</li>
 
<li>Click '''Next'''.</li>
<li>In the Installing panel, wait for the progress bar to finish, and then click '''Next'''.</li>
+
<li>In the Installing panel, wait for the progress bar to finish, and then click '''Next'''.
  
[[Image:Kiwix.png|center|400px]]
+
[[Image:Kiwix.png|center|400px]]</li>
<div align="center">
 
</div>
 
  
 
<li>When Kiwix has been installed on your computer, unselect '''Start Kiwix''' and click '''Finish'''.</li>
 
<li>When Kiwix has been installed on your computer, unselect '''Start Kiwix''' and click '''Finish'''.</li>
 
</ol>
 
</ol>
  
===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]]
 
[[Image:Font.png|center|200px]]
<div align="center">
+
 
</div>
 
  
 
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 162: Line 145:
 
|}
 
|}
  
===Initial Database===__NOEDITSECTION__
+
===Initial Database===
  
 
To create the initial database:
 
To create the initial database:
Line 175: Line 158:
 
The IMSMA server should not be started, no connection with PGAdmin, Navicat, iReport or OCBC sources. }}
 
The IMSMA server should not be started, no connection with PGAdmin, Navicat, iReport or OCBC sources. }}
  
==Part 5 Client/Server==__NOEDITSECTION__
+
==Part 5 Client/Server==
  
 
[[Image:InstallationGuideStep7.png|center|500px|''Configuring Client/Server'']]
 
[[Image:InstallationGuideStep7.png|center|500px|''Configuring Client/Server'']]
<div align="center">
+
 
</div>
 
  
 
If you will use IMSMA as a stand-alone installation, skip Part 5.
 
If you will use IMSMA as a stand-alone installation, skip Part 5.
Line 186: Line 168:
  
 
<ol>
 
<ol>
<li>Navigate to the '''c:\imsmang\server\imsmaserver\conf''' directory.
+
<li>Navigate to the '''c:\imsmang\server\imsmaserver\conf''' directory.</li>
<li>Open the '''GisService.properties''' file.
+
<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>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>Save the changes to the file.</li>
 
</ol>
 
</ol>
  
Line 196: Line 178:
 
<li>Start the TrayLauncher.</li>
 
<li>Start the TrayLauncher.</li>
 
<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.
 
<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 '''[Enter]''' key.</li>
 
</ol>
 
</ol>
<li>Set the value for the isClientOnly property.</li>
+
</li>
 +
<li>Set the value for the isClientOnly property.
 
<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 '''[Enter]''' key.</li>
 
</ol>
 
</ol>
<li>Set the value for the AlwaysSyncGeodata property.</li>
+
</li>
 +
<li>Set the value for the AlwaysSyncGeodata property.
 
<ol type="a">
 
<ol type="a">
 
<li>Enter “false” in the Value cell for the AlwaysSyncGeodata property.</li>
 
<li>Enter “false” in the Value cell for the AlwaysSyncGeodata property.</li>
 
<li>Press the '''[Enter]''' key.</li>
 
<li>Press the '''[Enter]''' key.</li>
<li>Click the '''Save''' button.</li>
+
<li>Click the '''Save''' button.
 
<ol type="a">
 
<ol type="a">
 
<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>
 +
<li>Click the '''Exit''' button.</li></li>
 
</ol>
 
</ol>
 
</ol>
 
</ol>
  
==Part 6. Verify installation==__NOEDITSECTION__
+
==Part 6. Verify installation==
  
 
[[Image:InstallationGuideStep8.png|center|500px|''Obtaining ArcGIS License'']]
 
[[Image:InstallationGuideStep8.png|center|500px|''Obtaining ArcGIS License'']]

Revision as of 13:11, 8 October 2013

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 Server 2003
  • Windows Server 2008
Note.jpg 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.

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.jpg If you are upgrading from previous IMSMANG versions, please read the upgrade documentation first.

Part 1. Run the IMSMANG Installer

Running the IMSMA Installer
Cmd NG.png


  1. Double-click the Install_IMSMA.exe file in the installation package.
  2. When the command window displays, follow the instructions.
    Graphic NG.png
  3. On the Language Selection window, select the language you want to use during installation and click OK.
    1st panel NG.png
  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. We strongly recommend to use the default installation path for IMSMANG. Click Next.
    4. If the target folder does not already exist a message will be shown, click OK.
    5. In the packages selection panel, click Next.
    6. Wait for the installation progress bar to finish, then click Next.
    7. When the Setup Shortcuts panel displays, click Next.
    8. When the installation has completed successfully, click Done.
      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.
  5. When prompted by the command window, press any key on the keyboard to continue.

Part 2. Set Permissions for the Tray Launcher

Setting Tray Launcher 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.
  4. Back in the IMSMA Tray Launcher Properties window, click OK.

Part 3. Install Supporting Software

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

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

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. When the Kiwix Setup panel displays, click License Agreement.
  3. After reading the license agreement, click I Agree.
  4. Click Next.
  5. In the Installing panel, wait for the progress bar to finish, and then click Next.
    Kiwix.png
  6. When Kiwix has been installed on your computer, unselect Start Kiwix and click Finish.

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 than you should create an initial IMSMA database.

Database Installation
If you want to... Do...
create an empty database see the initial database section below.
restore an existing database see the upgrade instructions.

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, enter password.
  4. Press the [Enter] key.
  5. When prompted to press any key to continue, press a key on the keyboard.
Note.jpg It is very important that you do not have any connection to the database when you create an initial database or restore a database.

The IMSMA server should not be started, no connection with PGAdmin, Navicat, iReport or OCBC sources.

Part 5 Client/Server

Configuring Client/Server


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

To configure the server in a client / server installation:

  1. Navigate to the c:\imsmang\server\imsmaserver\conf directory.
  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 TrayLauncher.
  2. Select the IMSMA Client Configuration Tool option.
  3. 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 [Enter] key.
  4. Set the value for the isClientOnly property.
    1. Enter “true” in the Value cell for the isClientOnly property.
    2. Press the [Enter] key.
  5. Set the value for the AlwaysSyncGeodata property.
    1. Enter “false” in the Value cell for the AlwaysSyncGeodata property.
    2. Press the [Enter] key.
    3. Click the Save button.
      1. The Your changes have been saved message displays.
      2. Click the OK button.
    4. Click the Exit button.

Part 6. Verify installation

Obtaining ArcGIS License

The IMSMANG installation is now complete. 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.

Follow the these steps to start stand-alone server or start the client.

ArcEngine license error message

ArcEngine lic missing.png

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

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.

Verify that the fonts are installed 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.

Font works.png

If the font installation has not work, go to C:\IMSMAng\trayLauncher\exe\FONTSInstaller and copy the files manually to C:\Windows\Fonts.


Template:NavBox HowTo Installing