Installation Instructions

Introduction

Before Installing, make sure your system meets the System Requirements.

Installing a GeoDMS application is performed in two steps:
I. Download and install the generic GeoDMS software.
II. Obtain and organise the project specific (original) configuration, data and documentation.

I. Download and install the GeoDMS software

The GeoDMS (GUI and dll's) is installed with a setup program. This setup program is available for different versions and can be downloaded here.

Activate the setup program and follow the instructions. The software will be installed in the /ObjectVision/GeoDMS<versionnr> directory.

After installing the software on some 64 bits platforms, the Program Compatibility Assistant might pop up. In these cases choose the option: This program installed correctly. If you notice problems with the installation afterwards, please inform us.

II. Obtain and organise the project specific (original) configuration, data and documentation.

The project specific files can be obtained from an archive file, e.g. zip or rar. Extract all files from the archive file, including the directory structure, in a free to choose base directory for your project. This directory is called the project directory. The source for the project specific files can also be our or any (svn) server. In that case a svn client like Tortoise can be used to download a specific version of these project files.

After extracting and or downloading, the project directory consists of subdirectories with the configuration, the data and the documentation files. Temporary calculation results and export are stored in subdirectoires of the localDataProjDir. For more information on the these directories, see Directories and Placeholders.

Running a GeoDMS application for the first time

After finishing step I and II, the application can be run with the shortcut GeoDMSGUI from the menu: GeoDMS<versionnr>. The first time the applicition is run, it is not aware of the project directory (as this directory was free to choose). Therefore the application starts with the message file not found. Browse with the File Open dialog to the current directory (the cfg subdir of the project directory). Select the root configuration file of the project and click Open. The configuration is now opened and a set of items are presented in the treeview.

The last opened configuration is added to the Windows Registry (HKE_CURRENT_USER\Software\ObjectVision\DMS). The next time the same user starts the GeoDMSGUI, this configuration is opened immediately. With the File > Open Configuration File menu option a new configuration can be opened. The GeoDMSGUI.exe can also run from the command line with as first argument the full path name of any root configuration file, to run the GeoDMSGUI.exe with this configuration.

Directories and access rights

The following table indicates the mimimum access rights for relevant directories (and their subdirectories).These rights need to apply for the user running the GeoDMS application.

The table describes values for an example project with GeoDMS version 5.50 and a project directory: C:/prj/nl_later.

Directory	Description	Default Value	Example Value	Minimum Access Rights
exeDir	directory in which the software is installed	%ProgramFiles%/ ObjectVision/ GeoDMS<versionnr>	%ProgramFiles%/ ObjectVision/ GeoDMS550	Read
projDir	base directory for original configuration, data and documentation files	free to choose	C:/prj/nl_later	Read *
localDataDir	the default base directory for the project specific localDataProjDirs	C:/LocalData	C:/LocalData	All
localDataProjDir	the base directory for the project specific (intermediate) results (CalcCache) and exports	C:/LocalData/ %projName%	C:/LocalData/ nl_later	All
SourceDataDir	the base directory for source data files which are not often updated or edited in the project	C:/SourceData	C:/SourceData	Read
SourceDataProjDir	the base directory for project specific source data files which are not often updated or edited in the project	C:/SourceData/ %projName%	C:/SourceData/ nl_later	Read

* If users are allowed to save configurations, a directory with All access rights for these configurations must be available. This directory does not have to be a subdirectory of the project directory.

Overruling directories in the config.ini

The default values for the localDataDir/SourceDataDir are not always usable, e.g.:

If users do not have access rights to a local C drive.

If multiple projects with the same name are installed (each project need to refer to a unique localDataProjDir directory).

In the config.ini file the default values for directories can be overruled. The config.ini file is located in the configDir, by default a subdirectory of the project dir with as subdir name the project name. Within this file a section [directories] occurs or can be made. In this section the localDataProjDir can e.g. be set to: G:\OV\Nl_later by configuring the following rule:

localDataProjDir = G:\OV\Nl_later

Placeholders can also be used in the configi.ini, e.g. the localDataProjDir can be configured to the projDir with the following rule:

localDataProjDir=%projDir%

The default values for the projDir, dataDir and CalcCacheDir can be overruled in the same manner. This is usually not necessary for installed projects.For more information on the these directories, see Directories and Placeholders