GOA Installation & first steps

marlinlineInternet and Web Development

Oct 31, 2013 (3 years and 7 months ago)

93 views

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

System Requirements

GOA requires an installed version of the Java Development Kit (e.g. Sun JDK 1.1 or greater).

Check your system with the command
java

version
. 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
may be
C:
\
jdk1.1.8
\
bin
, in an UNIX environment for example
/opt/java/bin
. Additionally, the
environment variable
CLASSPATH

should contain
the
lib

directory of your JDK installation, e.g.
C:
\
jdk1.1.8
\
lib

or
/opt/java/lib
.


Installation Procedure

Depending on the operating system used, the steps required for the installation of the GOA
Application Server are somewhat different.

Windows:

For W
indows
-
based systems (Windows 95/98/2000/NT 4.0) use
goasetup.exe
, a
GUI
-
based installation routine, that leads you through the setup process.

Unix:

Under Unix/Linux
-
based systems, the installation is done by a command
-
line script that
performs the setup
routines.


In any case the following steps are required:


1.

Log to the server with administrator rights.


2.

Define a directory, in which GOA should be installed. It’s recommended to use
DRV:
\
usr
or
/usr
. If this directory doesn’t yet exist, you may create it
with the help of
md DRV:
\
usr
or

mkdir /usr
. The setup routine will create the directory given as a target as well if it does not
exist at the time of installation.


3.

UNIX/Linux:

Copy the file
ux.zip

into the selected directory and extract it with the comman
d
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
setup.sh

from within
the shell and follow the instructions given.

Windows:

Start
goasetup.ex
e

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).


4.

Now, open the start script
goalogd.sh

(Unix/Linux) or
goalogd.bat

(Windows) in the GOA
installation directory
<path>/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
necessary.


5.

To start the GOA Server Login
-
Demon, execute
goalogd.bat

under Windows or the
command
sh goalogd.sh

under Unix/Linux. Now check the correct function of the Login
-
Demon. All messages created by the

Demon are logged in the file
goalogd.log

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
-
line script
setup.sh

allows the administrator to completely wipe the existing GOA installation („clean installation“).
Remember that this option will remove
all

files and sub
-
directories in the GOA root directory
compl
etely!


Known Problems

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" >

"Insta
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

System Re
quirements

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
tines are
provided with
GOAClient.exe
and
GOAClient95.exe
. Both programs will guide you through a
straight forward installation process. Please consider, that
GOAClient.exe

is as well suitable for
Windows 98 as for Windows 2000/NT 4.0, while Windows 95 sys
tems require
GOAClient95.exe
. In addition to a local installation, the appropriate client may be executed over
a network if the corresponding files are shared.


Operating system

GOA Windows Client

Windows 95

GOAClient95.exe

Windows 98/2000/NT 4.0

GOAClie
nt.exe


Installation Procedure

The Installation requires the following steps:


1.

Log to the client with administrator rights.


2.

Start either
GOAClient.exe

or
GOAClient95.exe

and follow the instructions. First, you are
prompted to choose the language used du
ring install.


3.

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.


4.

Finally, you have to select the program group in which the Client resides, and you
should
determine the default user name and the host name of the GOA Application Server used.
Please note that the default „
localhost
“ 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
gcfg

files (GOA Client Configuration) will be opened w
ith
GOAClient.exe

or
GOAClient95.exe

respectively. More on
gcfg

files and how to use them to
store individual user profiles is given in the next chapters.


Known Problems

none

First steps with GOA


the GOA Configurator


NOTE
: 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
a
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
default

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
admin

will be created and you may
chan
ge the settings for this user and enter a password. You may as well enter a valid GOA
license here


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
admin

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
Framework.


Managing different user profiles with gcfg files


When starting the GOA Client a couple of parameters are used. By default, they are read from
the file
default.gcfg

in the i
nstallation directory of the Client software. Next, the standard
default.gcfg

content is listed as created during the install process:


uname "admin" ;

host "localhost" ;

application default ;

htmlbrowser "" ;


These
gcfg

files can be created by the user a
s well
-

either from scratch with a text editor or
modified from an existing GOA configuration. Save the new profile with the extension
.gcfg
, and
the parameters are used by
GOAClient.exe

or
GOAClient95.exe

respectively after double
clicking the new
gcfg

f
ile.


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
d
schmitt
-
design.gcfg

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

with a
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.





Disclaimer:


Microsoft and Windows are registered brands

or trademarks of the Microsoft Corporation in the US and
other countries.


All other brands and trademarks mentioned in this application or the readme files provided with GOA are
registered by the respective manufacturers.