The GM.INI is a global settings file that helps GoldMine determine (among many other things) where data is located.  When the GoldMine API is loaded, it reads the GM.INI and feeds several important pieces of information to the Remote GoldMine Service (RGMS):
 
What database alias contains the GoldMine contact set.  This is the COMMONDIR setting in the GM.INI.
What database alias contains the common GoldMine database tables.  This is the GOLDDIR setting in the GM.INI.

Where the GoldMine System Files (such as the license file and the GoldMine's program files) are located.  This is the SYSDIR setting in the GM.INI.
 
The Remote GoldMine Service takes these values and attempts to log into GoldMine using whatever username and password is supplied by the user from either the wMobile Management Console or from the wMobile Login Page.
 

 

Generally speaking, the SYSDIR setting can cause the most difficulty with a wMobile installation.  This setting is often used to enforce where a workstation will find GoldMine's program files, where it can find the default locations of Reports and Templates as well as the default locations for linked documents and e-mail attachments.  If this setting is not present, then GoldMine will use the path it was started from to determine the SYSDIR location.
 
Consider the following:  Scenario 1:
 
GoldMine is installed on a server called GMSERVER.
The GoldMine folder is shared on the \\GMSERVER\Apps\ UNC path in the GoldMine folder.
The G: Drive is mapped to \\GMSERVER\APPS

The GM.INI has NO SYSDIR setting.
 
If the shortcut to GoldMine on my desktop points to \\GMSERVER\APPS\GoldMine\gmw.exe, since there is NO SYSDIR in the GM.INI, then GoldMine will assume that my SYSDIR is  \\GMSERVER\APPS\GoldMine.

If the shortcut to GoldMine on my desktop points to G:\GoldMine\gmw.exe, since there is NO SYSDIR in the GM.INI,  then GoldMine will assume that my SYSDIR is G:\GoldMine.

 

Consider the following:  Scenario 2:
 
GoldMine is installed on a server called GMSERVER.
The GoldMine folder is shared on the \\GMSERVER\Apps\ UNC path in the GoldMine folder.
The G: Drive is mapped to \\GMSERVER\APPS

The GM.INI has SYSDIR set to G:\GoldMine.
 
If the shortcut to GoldMine on my desktop points to \\GMSERVER\APPS\GoldMine\gmw.exe and the SYSDIR in the GM.INI points to G:\GoldMine, then my SYSDIR will be G:\GoldMine.

If the shortcut to GoldMine on my desktop points to G:\GoldMine\gmw.exe which matches the SYSDIR in the GM.INI, then GoldMine make my SYSDIR G:\GoldMine.

 

In Scenario 1, since there is no SYSDIR, GoldMine will assume that the SYSDIR is the path from where I am starting GoldMine.  If its a UNC path, then my SYSDIR becomes a UNC path.  If its a mapped drive letter, then my SYSDIR becomes a mapped drive letter.  In Scenario 2 the GM.INI contains a SYSDIR, so no matter where I start GoldMine from, the setting ensures that the SYSDIR will be G:\GoldMine.
 
Since the SYSDIR setting can be either a mapped drive letter OR a UNC path, W-Systems recommends that the setting be removed from the GM.INI and that all workstations use the method for determining the SYSDIR outlined in Scenario 1.  In this case, all users should start GoldMine from the same path to ensure that GoldMine uses to the correct SYSDIR for all users.
 

 

If there is a requirement that the GM.INI SYSDIR value must be set as a UNC path, this may cause a problem for remote users running the GoldMine spell checking (e.g., remote Citrix users).

 

To correct this add/edit the following in the GM.INI file's [GoldMine] section to use mapped drive path to avoid problems with GoldMine's speller:

 

 

[GoldMine]

SSCE_PATH=speller

SSCE_PATH=(GOLDMINE_ROOT_FOLDER)\speller\ssce_lex\ssceam.tlx

SSCE_PATH=(GOLDMINE_ROOT_FOLDER)\speller\ssce_lex\ssceam2.clx

 

Example:

SSCE_PATH=D:\Apps\GoldMine\speller\ssce_lex\ssceam.tlx

SSCE_PATH=D:\Apps\GoldMine\speller\ssce_lex\ssceam2.clx

 

 

 

Return to the Pre-Installation Checklist