My Account
Search
Download
Home
About Us
GI Solutions
Market Sectors
Training
Admin Notes
Quick Upgrade
Optional Steps
Demo Videos
Settings
 Administrators Notes Minimize

Introduction

This document describes how to install and configure the core dataMAP 4.1 components.

For the purposes of these instructions, we assume the dataMAP installation folder is X:\dataMAP\

Requirements for installation

Hardware

Minimum supported hardware:

  • 2Ghz Pentium 4 Processor or equivalent
  • 512Mb RAM
  • 1024x768 display, 16 bit colour
  • 2 button mouse

Recommended hardware:

  • Mutli core processor (Core 2 Duo or Athlon X2)
  • 2Gb RAM
  • 1280x1024 display, 32 bit colour
  • Wheel mouse

Operating system

  • Windows XP SP2
  • Windows Vista
  • Windows Server 2003
  • Windows Server 2008

It is possible to run this version of dataMAP on Windows 2000 however it is not recommended or fully supported

dataMAP is a 32 bit application but will run happily on x64 editions of windows and we would recommend you install x64 windows where possible so you can easily upgrade your computers memory capacity.

We would recommend installing the latest service pack available for the operating system.

System components

dataMAP 4.1 requires .Net 2.0 to be installed.  Windows Vista and Server 2008 ship with these components and can run dataMAP directly.

If you are installing the .Net runtime on a new machine we would recommend you install the latest version of .Net runtime which at the time of writing is 3.5 SP1 which is available from the URL below:

http://www.microsoft.com/downloads/details.aspx?familyid=ab99342f-5d1a-413d-8319-81da479ab0d7

To determine what versions of the .Net framework is installed have a look in the folder C:\Windows\Microsoft.NET\Framework. Versions of the .Net framework will be in numbered folders.

If you are using the dataMAP 3.21 based address point gazetteer it will still be necessary to have VB6 runtime as installed by the dataMAP VBL311 components.  These have not changed since the initial dataMAP 3.21 component distribution and are generally located in  X:\datamap\utils\VBL311.

System Access Rights

Local administrator access is required to install .Net or to configure .Net such that you can run the application from a network drive.

Local administrator access is NOT required to run the application via ClickOnce or if you extract a ZIP file locally.

At present access to data is only controlled at the file or database level.  If a file should not be written to by a user then those permissions must be set at the filesystem level.

In .Net 3.5 SP1 a configuration change was made so you can run dataMAP directly from a network drive without changing the local permissions.

On Vista, with User Access Control enabled, your DATAMAP.INI and APG.INI files that would normally be in the C:\Windows may be in C:\Users\%Username%\AppData\Local\VirtualStore\Windows

Initial Installation

This section describes how to get the dataMAP application running on a machine or group of machines.

Choosing an installation method

The easiest way to install dataMAP is via ClickOnce which will deploy the application into the users local directory.  Updates are handled automatically from SIA's web site.  Laptop users can use this and updates will only occur when connected to the public internet.

If you have more than 5 users in an environment or wish to administer updates of the application yourself you can run it from a local directory.  This is done by downloading a ZIP file containing the dataMAP 4 binaries.

As a system administrator, you may wish to run dataMAP via ClickOnce installation so you always have the latest version and get notified of updates.  Once you are happy with a version you can copy it onto the network where it will be used by other users.

Running dataMAP via ClickOnce

SIA maintain the latest version of dataMAP 4.1 here...

  http://install.sialtd.com/hometrackdatamap/

This is the URL of the actual ClickOnce install link:

  http://install.sialtd.com/hometrackdatamap/HometrackDatamap.application

If Internet Explorer is your default web browser or you have the appropriate ClickOnce extension installed then clicking on that URL should run the application.

Another way you can start ClickOnce applications is via an "appref-ms" file which refers to the ClickOnce install.  If you download this file and then open it, the install should be started.  You can also email this file to users.

http://install.sialtd.com/hometrackdatamap/HometrackDatamap.appref-ms

Larger sites may wish to consider deploying their own ClickOnce installation for use internally.

Running dataMAP from the local disk

You may wish to just download a ZIP file containing the dataMAP binaries.  The ZIP file will be updated at the same time as the ClickOnce installer and is available at the following URL:

http://install.sialtd.com/hometrackdatamap/HometrackDatamap.zip

For initial testing, we suggest you extract this ZIP file into a temporary directory on your local hard disk.  You can then run "dataMAP4Loader.exe" and verify the application starts correctly.

Old versions of files that are no longer distributed may cause problems so we recommend that you always extract dataMAP into a new folder.

Running dataMAP from a network drive

First run through the process for a local file based install.

When you are happy the application is working correctly we recommend you copy the contents of the folder to X:\dataMAP\dataMAP41\ directory and run dataMAP4Loader from there.  We suggest you rename the old folder before doing this to get round any locking problems and ensure that old incompatible files are removed.  If it complains about network permissions we would suggest you try running the 'SetCLRPermissions.bat' file to put a policy in to trust the network.  If this doesn't solve the problem, we suggest you install .Net 3.5 SP1 as per the instructions above.

Basic configuration

This section describes how you can manage your dataMAP 4 configuration.  This is mainly relevant to system administrators who wish to share default configuration among all their users.

Overview

dataMAP configuration is in two parts, a system configuration file (system.xml) and a user configuration file (user.xml).

When dataMAP starts up it attempts to locate a system.xml configuration file.  Configuration settings found there can be used to locate a user configuration file (user.xml).

dataMAP settings can be set at the system or user level.  In general, the system settings provide a default which can then be overriden by the user.  To view the configuration used by dataMAP and any redirection route, select "About..." from the "Help" menu.

The configuration files are designed to be human readable and editable.  XML comments will be preserved when changes are made.

New standalone install

If you are running dataMAP locally, by default it will store it's configuration in your user profile.

If you have some initial data, perhaps from a USB drive you may wish to use the associated conifguration.  From the Tools menu, select "Configuration" then "Select configuration file to use..." then browse to the system configuration eg. X:\datamap\config\system.xml.

Network install / upgrading from dataMAP 3.21

These instructions will guide you through deploying dataMAP 4 for use on the network.  If you have a machine with a working dataMAP 3.21 installation then you should start from that machine.  You can then go round other existing dataMAP 3.21 installs or new machines and point them at your network configuration.

For the purposes of these instructions, we assume you have dataMAP installed to X:\dataMAP\. you have dataMAP installed to X:\dataMAP\.

Creating a configuration file on the network

Initial configuration - do this once from a system administrators machine or a machine with a proper dataMAP 4 configuration.

  • From an existing machine (with dataMAP 3.21 installed if appropraite), run dataMAP 4.
  • From the Tools menu, select "Configuration" then "Save existing configuration to file..."
  • Create a folder X:\dataMAP\Config\ and save System.xml in that location. You may be prompted to create the folder automatically, in which case just press "Yes" then "Save".  Otherwise, create a Config folder under the dataMAP directory and save System.xml in that location.
  • From the Tools menu, select "Configuration" then "Select configuration file to use..."
  • Browse to X:\dataMAP\Config\ and select System.xml
  • Press Yes to confirm that you wish to restart dataMAP

This machine is now configured to use dataMAP 4 configuration from the network.  Other machines that use dataMAP 3.21 from the network should detect the configuration.

Updating a 3.21 machine to use the dataMAP 4 installation on the network

  • Run dataMAP4.  It should detect a dataMAP installation in X:\dataMAP\.  If it doesn't, proceed as per "Installing dataMAP 4 on a new machine".
  • Press "Yes" to use the configuration you saved.
  • Click OK

Installing dataMAP 4 on a new machine

  • Run dataMAP4.
  • From the Tools menu, select "Configuration" then "Select configuration file to use..."
  • Browse to X:\dataMAP\Config\ and select System.xml
  • Press "Yes" to restart dataMAP using that configuration

Gazetteers / Search Indexes

dataMAP 4 gazetteer configuration is generally stored in a Gaz.SIAGazDef file.  This is referenced by the GazetteerConfigurationFile configuration setting.

Gazetteer configuration - upgrading from dataMAP 3.21

If dataMAP 4 gazetteers are not configured, dataMAP will try to use the gazeteers configured in dataMAP 3.21.  These will be as follows:

APG Old address point gazetteer from dataMAP 3.21.  This will match queries such as a postcode, a full address or wildcard searches such as *PIZZA*.  This is the default gazetteer.
Address Point Database This folder contains queries on your address database (typically dataMAP\APG\ADDR.MDB).
  -  APG Postcode  This gazetteer will take you to the center of a full postcode.
  -  APG Address  This gazetteer will perform a wildcard match in the address description.
Street Gaz This will perform a wildcard search for specific text in your street gazetteer (typically datamap\GAZ\gaz.mdb)

Click on the magnifying glass on the right hand side of the toolbar and verify that the gazetteers are present.  Double click on "APG" to select it, then click on the text box in the toolbar and type a search string such as '*PIZZA*' or a postcode.  A list of addresses should appear.  Repeat the process for APG Postcode (search for a postcode), and Street Gaz (search for a fragment of a street name).

If these all work as expected then save the configuration so machines that don't have a datamap.ini or apg.ini will work correctly.  Click the magnifying glass, press the "Save..."  button and save the file to X:\datamap\config\gaz.SIAGazDef.

To make this the default gazetteer for all users, from the "Tools" menu, select "Configuration" then "Edit system defaults...".  In the tree on the left, expand the "Main configuration" node and select Gazetteer configuration file.  Click the browse button on the right hand side and browse to the file you just saved, eg. X:\datamap\config\gaz.SIAGazDef

 

Gazetteer configuration - creating an empty configuration file

If no dataMAP 3.21 configuration is found then you will not have any gazetters.  Before we can add new gazetteers we need to first locate Click the magnifying glass, press the "Save..."  button and save the file to X:\datamap\config\gaz.SIAGazDef.

To make this the system default gazetteer for all users, from the "Tools" menu, select "Configuration" then "Edit system defaults...".  In the tree on the left, expand the "Main configuration" node and select Gazetteer configuration file.  Click the browse button on the right hand side and browse to the file you just saved, eg. X:\datamap\config\gaz.SIAGazDef

Upgrading from dataMAP 4

If you are an existing dataMAP 4 user then no configuration changes are necessary - dataMAP 4.1 will use the same configuration files.

 

Additional notes

How dataMAP finds it's configuration file

On startup, dataMAP will attempt to locate a System.xml file it can use, starting with a location near the executable, in the parent directory then in a 'config' folder off the parent directory. It will then try one specific to the machine, then one specific to the user on that machine, then one specific to the machine.  That translates to the following paths -

.\System.xml
..\System.xml
..\Config\System.xml
%ALLUSERSPROFILE%\SIA Limited\dataMAP4\System.xml
%LOCALAPPDATA%\SIA Limited\dataMAP4\System.xml
%APPDATA%\SIA Limited\dataMAP4\System.xml

On Windows XP, the last three paths will be...

C:\Documents and Settings\All Users\Application Data\SIA Limited\dataMAP4\System.xml
C:\Documents and Settings\USERNAME\Local Settings\Application Data\SIA Limited\dataMAP4\System.xml
C:\Documents and Settings\USERNAME\Application Data\SIA Limited\dataMAP4\System.xml

On Windows Vista this will be...

C:\ProgramData\SIA Limited\dataMAP4\System.xml
C:\Users\USERNAME\AppData\Local\SIA Limited\dataMAP4\System.xml
C:\Users\USERNAME\AppData\Roaming\SIA Limited\dataMAP4\System.xml

If no configuration file is found, any settings will be stored under %APPDATA%.

The system configuration can be redirected with a System.xml as follows:

<Config>
<Setting Name="ConfigFile" Value</Config>

The user configuration is stored in a user.xml in the user directory.

Additionally, the following registry key can be used to specify a configuration file as part of a machine policy...

[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Hometrack SIA\dataMAP]
"DefaultConfigFile" = "\\\\server\\share\\datamap\\Config\\Hometrack\\system.xml

 

dataMAP command line options

These options can be passed into dataMAP4.exe or dataMAP4Loader.exe

Switch Meaning
/? Displays help text
/ConfigFile:File Override the system config file
/DataDirectory:Directory Override the data directory
/UserDirectory:Directory Override the user directory
/Username:String Override the user name
/ConfigDebug:Filename Log configuration information to a file
/DebugLog:Filename Set the debug / performance log file

Additional command line options will be interpreted as data files.

 

File extensions

Workspace files  
MVS Map Workspaces
   
Map files  
DH SIA DH Overlays
DMR dataMAP Tiled Raster Maps
ECW ECW Map Driver
ASC J2K CRV IMG ADF JP2 SID Raster Maps (GDal)
GIF TIFF PNG TIF BMP JPG JPEG Raster Maps (GDIPlus)
MIF TAB MapInfo Mif/Tab Files
RDB RDB Overlays
SHP ESRI Shape Files
TempMapDef Temporary (in memory) overlay definition
   
Data table / database files  
CSV CSV files
MDB ACCDB Access databases
XLS XSLX Excel spreadsheet files
WK4 WK3 Lotus 123 spreadsheet files
WK3 Lotus 123 spreadsheet files
 

Application Builder Performance

By default no indexes are created within the application builder map.

Within the add application builder screen you can press the F12 key to get an option to add indexes. This can improve performance significantly.
 Print   
sitemap | ©2010 Hometrack. All rights reserved