Installation


General

During installation, you are asked which of the following programs you want to install:

  • Application program (runs stand-alone without a server)
  • Client program (needs to connect to a server program)
  • Server program  (allows client programs to run on an intranet and alslo installs web-files necessary to make the server accessible from remote client browsers connected the internet)

Downloading and running Setup

Download the demo setup .zip file at:
http://demo.GoalDirector.com

Unzip the setup files to a  temporary subdirectory

Find and run the Setup.exe program

The first part of the setup program installs the Java Runtime Environment.  Please allow the setup program to install the Goal Director program in the default subdirectory under C:\Program Files.  A start menu-folder named Goal Director is created.and shortcuts to these programs are created.

Databases
The installation creates two ODBC databases:

  • gdpm.mdb (database for the server and/or applicaton placed in a subdirectory called "db")
  • offlinegdpm.mdb (database for one project that has been checked out from the server and may be accessed by the client software running in "local" mode - placed in a subdirectory called "offline")
If you wish to use SQL Server, Oracle, or DB2, please see  Other Databases below

Goal Director Application program

When the application program starts up successfully, you will initially be prompted to logon as the Supervisor.  The initial password is "gdpm".  After you are logged on, you should go to Resource>Persons and modify the Supervisor password.  If the logon-list. is empty, please verify that the file <installation-path>\db\gdpm.mdb exists.

Goal Director Client program

When installing the Client program, you will be asked for the computer name the Server program has been installed on.

When the client program starts up successfully, you will be prompted to logon as the Supervisor.  The initial password is "gdpm".  After you are logged on, you should go to Resource>Persons and modify the Supervisor password.  If you get a message:  Error connection to Server when starting up the client, please check the server-name. You find this name by clicing Tools>Preferences. If you find this to be correct, please check the network-configuration by typing "ping <server-name>" in a dos-window. If you don’t get a reply, your network-configuration is incorrect. Please consult with your local network-administrator

If you can't make a connection with the server, you have the option of running in local mode. (eg. When you are using a portable PC away from your network)

IMPORTANT: Local mode is intended for projects checked out from a server. If you are using local-mode and later connect to a server and check out a project, you will erase all the data in the offlinegdpm.mdb database.

Goal Director Server program

When installing the Server program, you must enter the computer's name or the computer's IP address you wish to install the server program on. This name is specified under Control Panel-Network-Identification) If you are going to access the server via the internet, you need to use the IP-address or DNS-name of the server. To verify that the installation was successful, startup the server and check to ensure that the file error.log in the program subdirectory is empty.

When you have entered the server computer name, you will be asked if you want to install web-files. These are the files needed to run the web applet-version that will connect to the server. If you answer yes, your applet-files will be placed in a web-folder in your installation-path. Please copy these files to the appropriate directory.

You should only run one Goal Director server with a specific database.

Configuring the Server for Internet web browser access

  1. In the installation-path you will have a folder called Web. You should copy the contents of this folder to a folder on the webserver where you want to make the applet available (the path client browsers will enter as an address). If the webserver and Goal Director Server are running on the same machine, you don't need to do anything. If the webserver is on a different machine you need to modify the html-files.
  2. For.example for Microsoft Internet Explorer. Modify the gdpm_en.html (English version).
  3. Add a parameter to the applet by adding a line after:
  4. <PARAM NAME="GDPMServerHost" VALUE="Goal Director server's computer name or ip-number">
  5. Start up the Server.
  6.  

Configuring your Web browser(s) to access a Server program over the internet

Open up a web-browser and enter the full address where you installed your web-files. (ex. http://gdpmserver/applications/gdpm/gdpm.html)
If your browser is configured correctly, you will see a message similar to the following:

    "Do you want to trust the signed applet distributed by "Euroconsult AS"?
    Publisher authenticity verified by: "Thawte Consulting cc
    Caution: "Euroconsult AS" asserts that this content is safe.
    You should only accept this content if you trust "Euroconsult AS" to make that assertion." .... 

You need to answer Yes to allow the web applet to run on your computer.

The applet should continue to load for a few more minutes unitil a window appears that looks like your regular Application or Client program.  If it doesn't, please configure your browser per the instructions below

Configuring specific browsers

Netscape or Mozilla
Go to the internet address of the .html file.  If the applet does not start up, you probably need to install the Java2 plug-in from Mozilla.org and then restart your computer.

Internet Explorer

Go to the internet address of the .html file.  If the applet does not start up, you probably need to install the Java2 Runtime Environmnent from  Java.com and then restart your computer.

Apple Java Runtime Environment(2.2)

You need to have swing(Swingall.jar) in the classpath. When using the appletviewer you first have to download the identity.obj from the web-page. There is a link to this file. This should be saved under your home-directory. This gives the applet the rights of a normal application on your machine.

Installation of Goal Director behind a firewall

If you are going to run Goal Director through a firewall, you need to take a few actions. The firewall has to let through two port-number to the server where the Goal Director Server resides. These ports are specifies in the gdpmserver.ini-file. (In the installation-folder). An example of configuration:

$ClassName=no.prosoft.gdpm.server.GDPMServerOM
%createRegistry=1
%rmiRegistryPortnr=1099
$ClassName=no.prosoft.gdpm.server.GDPMSocketFactory
%portnr=1299

In this case the firewall has to let IP-traffic with server-side ports 1099 and 1299 through to the server. Please note that a number of ports are reserved by other services (Web-server, telnet, ftp,..).

Note: If you already have a rmi-registry running on the server (ex. because of another application, you need to set the createRegistry-variable to 0)

Run Goal Director server as a NT Service

You can also run the Goal Director Server as a Service under NT. In the installation folder there is a file called gdpmservice.bat. After running this file, Goal Director Server is a service. After a reboot the service is automatically started. If you don’t want to reboot the machine you can simply start the service by pressing the start-button under Services in the Control panel.If you don't want Goal Director installed as a service,but would like to start it as a service occasionally, you may also do this manually by running the file service.bat.

Note: In the gdpmserver.ini-file there is a line:

%delay=0

If you have problem with automatic startup, increase this number. This will delay the startup of the service. The number is in seconds. F.x. 20 seconds:

%delay=20

Validating password through NT

Goal Director Server supports the use of NT-password as logon-password in GPDM Tools. If you want to allow this, you have to add a line after the first line in the gdpmserver.ini.

%AuthenticatorProvider=no.prosoft.gdpm.server.util.NTUserAuthenticator

Then you have to edit the file NTUserproperties. Here you change the name of the NTUserDomain to your logon-domain.

The users that are going to be using NT-passwords have to set their NT-username in the person-properties-view. If this is left empty, the user continue to use the normal Goal Director password.

Other Databases

SQL Server

Goal Director can be run with a SQL Server(Version 6.5 or 7.0) as database. All data will be stored in the SQL Server instead of the access-database Goal Director provides JDBC-drivers to connect to MS SQL Server. To use such a solution you need to:

  • Create the database on your SQL Server. Name it gdpm.
  • Run the sqlserv.sql-script to create the table-structure in the database gdpm.
  • Make sure the database is set to use SQL Server authentication.
  • Make sure the database server is set up to use tcp/ip.
  • Change the name of the file SQLServergdpmserver.ini to gdpmserver.ini. This file is configured for communications towards SQL Server on the same machine.
  • If the SQL Server is on another machine, open the gdpmserver.ini and find the line:
    • %database=jdbc:inetdae:localhost:1433?database=gdpm|
    • Replace localhost with the server-name.
    • Verify that 1433 is the same port-number that your SQL Server is running.

DB2

Goal Director can be run with a DB2 as database. All data will be stored in the DB2 instead of the access-database. To use such a solution you need to:

  • Create the database on DB2 server. Name it gdpm.
  • Run the db2.sql-script to create the table-structure in the database gdpm
  • Unpack the db2java.zip in your installation-folder. This file comes with DB2.
  • Change the name of the file db2gdpmserver.ini to gdpmserver.ini. This file is configured for communications towards DB2 on the same machine.
  • Change the %USERNAME% AND %PASSWORD% in this file.

ORACLE

Goal Director can be run with a Oracle database (Version 7.3 or 8.X) as database. All data will be stored in the Oracle database instead of the access-database. To use such a solution you need to:

  • Get the thin JDBC-driver for Oracle database from http://technet.oracle.com You need to register (Free)
  • Create the database on your Oracle server. Name it gdpm.
  • Run the oracle.sql-script to create the table-structure in the database gdpm.
  • The JDBC-driver is a zip-file. Inside the first zip-file you should have another zip-file(classes111.zip). Extract this file to the installation-folder.
  • Change the name of the file Oraclegdpmserver.ini to gdpmserver.ini. This file is an example configuration for communications towards Oracle-database (gdpm) communication on port 1521. Open this file and change username and password. Also change the ORA_Server and port-number(If needed,Default: 1521)

Known Issues

MDAC 2.X

If you’re going to use Goal Director with the default settings against an access-database, and you have installed MDAC 2.X from Microsoft(Microsoft Access Driver 4.X)(This is found under Control Panel/ODBC/Drivers), you need to do:

Client or Application

Edit GDPMClient.ini. Modify or add a line that says:

MSAccessBug=1

Server

Modify the gdpmserver.ini. syntax should be 4

%syntax=4|

Technical Support

If you have a Maintenance Agreement and you have technical questions, please contact support@GDPMsystems.com

 

Copyright ~ Goal Directed Project Management Systems Ltd  ~ All rights reserved