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
- 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.
- For.example for Microsoft Internet Explorer. Modify the
gdpm_en.html (English
version).
- Add a parameter to the applet by adding a line after:
- <PARAM NAME="GDPMServerHost" VALUE="Goal Director
server's computer name or ip-number">
- Start up the Server.
-
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.
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.
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
|