GOA Installation & first steps
The GOA Business Application Framework is a Client/Server system. Therefore, the installation
requires two steps:
The installation of the GOA application server on the server machine.
The installation of the GOA clients on o
ne or more working stations/pcs.
Installation of the GOA Application Server
GOA requires an installed version of the Java Development Kit (e.g. Sun JDK 1.1 or greater).
Check your system with the command
. After completing
the command, the version
number of the installed JDK should be displayed. If this is not the case or an error message
appears, please make sure that the JDK is installed correctly.
Errors may result from missing or wrong search paths set in the environmen
t. You have to include
the bin directory of the JDK installation in the environment variable PATH. Under Windows this
, in an UNIX environment for example
. Additionally, the
directory of your JDK installation, e.g.
Depending on the operating system used, the steps required for the installation of the GOA
Application Server are somewhat different.
based systems (Windows 95/98/2000/NT 4.0) use
based installation routine, that leads you through the setup process.
based systems, the installation is done by a command
line script that
performs the setup
In any case the following steps are required:
Log to the server with administrator rights.
Define a directory, in which GOA should be installed. It’s recommended to use
. If this directory doesn’t yet exist, you may create it
with the help of
. The setup routine will create the directory given as a target as well if it does not
exist at the time of installation.
Copy the file
into the selected directory and extract it with the comman
jar xvf ux.zip
. If you get an error message during this step, your JDK may not be installed
correctly (compare System Requirements). If no errors occur, execute
the shell and follow the instructions given.
and follow the installation instructions. You should specify the
target directory for the GOA Server as well as the installation options for some additional
components (like the doc path and so on).
Now, open the start script
(Windows) in the GOA
with a suitable editor. Check if the entries reflect the
directories of the GOA and JDK installation directories for your environment. The installation
routine tries to modify the paths acc
ordingly, but sometimes manual adaption may be
To start the GOA Server Login
under Windows or the
under Unix/Linux. Now check the correct function of the Login
Demon. All messages created by the
Demon are logged in the file
found in the
GOA installation directory
If the Login
Demon works as expected, the last line in the log
file should read:
„waiting for client requests“.
Herewith you successfully completed the installation of
the GOA server. If you encounter any
error messages or problems, you may double check the correct installation of the JDK and
then repeat the appropriate installation process for GOA.
If an older installation of the GOA Application Server exists in the ta
rget directory, the setup
routines normally only update this installation. User settings, licensing information and so on will
remain unchanged. Nevertheless, changes made in the GOA system and documentation files by
the user will be overwritten with newer
versions of these files. The command
allows the administrator to completely wipe the existing GOA installation („clean installation“).
Remember that this option will remove
files and sub
directories in the GOA root directory
Using Windows 98 (SE) during the installation of the GOA Application Server the following error
message may occur: ‚Error: Für diese Anwendung konnte kein Eintrag in der Liste
"Einstellungen" > "Systemsteuerung" > "Software" >
llieren/Deinstallieren" erzeugt werden.
You need admin rights to complete this task.’
This behavior is a known bug of the used Install Shield that will not affect the functionality of the
GOA Application Server.
Installation of the GOA Clients
While the GOA Application Server runs under Unix/Linux as well as under Windows, the GOA
Clients are only available for Windows 95/98/2000/NT 4.0 at this time.
For installing the Client software locally at the desktop pc, two powerful setup rou
. Both programs will guide you through a
straight forward installation process. Please consider, that
is as well suitable for
Windows 98 as for Windows 2000/NT 4.0, while Windows 95 sys
. In addition to a local installation, the appropriate client may be executed over
a network if the corresponding files are shared.
GOA Windows Client
Windows 98/2000/NT 4.0
The Installation requires the following steps:
Log to the client with administrator rights.
and follow the instructions. First, you are
prompted to choose the language used du
Given your license
agreement, you may choose the target directory for the client installation
and the components to install. Consider that the installation of the GOA client is required while
you should only install the CDIX connection for
the GOA client if you use CDIX applications.
If you start the setup routine a second time, the option to remove, modify or repair an existing
installation is presented.
Finally, you have to select the program group in which the Client resides, and you
determine the default user name and the host name of the GOA Application Server used.
Please note that the default „
“ is only useful, if GOA server and GOA client are
installed on the same working station/pc.
After confirming the selectio
ns, the files necessary are copied and the shortcuts are created.
This completes the installation process of the GOA Client. In addition to copying the files, the
Windows Registry is modified, so that
files (GOA Client Configuration) will be opened w
respectively. More on
files and how to use them to
store individual user profiles is given in the next chapters.
First steps with GOA
the GOA Configurator
: The following steps require
the GOA Application Server to be up and running. More on
how to start the Server Login
Demon is provided in the first chapter of this manual. If you fail to
start the GOA Server first, trying to log on through the GOA Client will lead to an error message
fter a timeout.
Now, start the GOA Windows Client suitable for your system and enter a user and host name, if
not already transmitted as a parameter. For the application, use
here, which resembles
the GOA Desktop.
The first logon to the GOA De
sktop after installation generates a couple of warning. They may be
ignored and are displayed because no users and corresponding settings are found. Because of
this, the GOA Configurator will be launched. A user named
will be created and you may
ge the settings for this user and enter a password. You may as well enter a valid GOA
without a valid license, you are not allowed to create more than one user.
After finishing these first configuration tasks, y
ou may exit the Configurator. Now, you may startup
the GOA Desktop as user
and create more users according to your GOA license.
If you are using a GOA demo license, the GOA Configurator does not support the setup of
additional users. Nevertheless,
you may test the full functionality of the GOA Business Application
Managing different user profiles with gcfg files
When starting the GOA Client a couple of parameters are used. By default, they are read from
in the i
nstallation directory of the Client software. Next, the standard
content is listed as created during the install process:
uname "admin" ;
host "localhost" ;
application default ;
htmlbrowser "" ;
files can be created by the user a
either from scratch with a text editor or
modified from an existing GOA configuration. Save the new profile with the extension
the parameters are used by
respectively after double
clicking the new
An example: If you would like to start the GOA Client with the value „schmitt“ as user, a GOA host
with the name „goaserver“ and the GOA Designer
(cdsoft.designer.Components.DesignerMainComponent) as default application, so you may
create a file name
with the following content:
uname "schmitt" ;
host "goaserver" ;
application cdsoft.designer.Components.DesignerMainComponent ;
htmlbrowser "" ;
Now you can put this file as a new GOA profile on your desktop and start it at any time
double click. This can save you a lot of typing. Please remember: The GOA Application Server
must be up and running to prevent a timeout error when trying to log on with our new profile.
Microsoft and Windows are registered brands
or trademarks of the Microsoft Corporation in the US and
All other brands and trademarks mentioned in this application or the readme files provided with GOA are
registered by the respective manufacturers.