Chapter 10 Creating Application Clients

Running application clients

To run an application client on a client machine:

Copy the application client JAR file to the client's machine and import the JAR file, as described in Chapter 10, "Importing and Exporting Application Components" in the EAServer System Administration Guide.
Set up the environment - see "Setting up a client's workstation".
Start the application client's runtime container - see "Starting the runtime container".

Setting up a client's workstation

To set up a client's workstation, install the EAServer client runtime files, as described in the EAServer Installation Guide for your platform. UNIX scripts and Windows batch files are provided to configure and launch the container runtime, as described below.

Starting the runtime container

The runtime container enables the application client to look up EJB and resource references. The container also provides security and authenticates the client when the application is started.

Run application clients using the script runclient.bat (on Windows) or runclient.sh (on UNIX). Application clients require JDK 1.3 or later.

Use these options to define the runtime parameters:

Option	Description
- client	Application client JAR file
- name	Client's name
- login	Displays a login dialog to authenticate the client

This example illustrates the command-line syntax to start an application client's runtime container, where my_appclient.jar is the name of the application client JAR file and my_client is the name of the client. On Windows, the command is:

%JAGUAR%\bin\runclient -client my_appclient.jar -name my_client -login

On UNIX, the command is:

$JAGUAR/bin/runclient.sh -client my_appclient.jar -name my_client -login