Requirements for running a thin application client for WebSphere® Application Server 5.0
 Technote (troubleshooting)
 
Problem(Abstract)
What is needed to run a thin application client for WebSphere Application Server 5.0?
 
Resolving the problem
If you want a lightweight Java™ client application programming environment without the overhead of the J2EE platform on the client machine, choose a thin client rather than a J2EE application client.

To run the thin client on a remote machine:

  1. Install the Java application thin client from the WebSphere Application Client CD that ships with WebSphere Application Server. To do this, select J2EE/Thin application client for the WebSphere Application Client.
  2. Set the Java application thin client environment; use the setupClient script located in:

    install_root\AppClient\bin\setupClient.bat (on Windows)
    install_root/AppClient/bin/setupClient.sh (on UNIX platforms)

    where install_root is where the WebSphere Application Client is installed
  3. Add any specific Java client application JAR files to the CLASSPATH, set the environment variables, then start the Java client application from this environment.
  4. Run the following Java command to invoke the client application:

    On Windows®
    %JAVA_HOME%/bin/java -Xbootclasspath/p:%WAS_BOOTCLASSPATH% -classpath <list of the application jars and classes> -Djava.ext.dirs=%WAS_EXT_DIRS% -Djava.naming.provider.url=iiop://<the Websphere server machine name> -Djava.naming.factory.initial=com.ibm.websphere.naming.WsnInitialContextFactory %SERVER_ROOT% %CLIENTSAS% <fully qualified class name to run>

    On UNIX®
    $JAVA_HOME/bin/java -Xbootclasspath/p:$WAS_BOOTCLASSPATH -classpath <list of the application jars and classes> -Djava.ext.dirs=$WAS_EXT_DIRS -Djava.naming.provider.url=iiop://<the Websphere server machine name> -Djava.naming.factory.initial=com.ibm.websphere.naming.WsnInitialContextFactory $SERVER_ROOT $CLIENTSAS <fully qualified class name to run>
Important Note:
This is the only tested and supported method of setting up client machines for WebSphere 5.0. The Application Client installation contains a subset of the WebSphere Application Server jar files, which are the minimum number of jar files needed to run a client application. Any other method of setting up a thin client machine is unsupported by WebSphere.
 
 
Cross Reference information
Segment Product Component Platform Version Edition
Application Servers Runtimes for Java Technology Java SDK
 
 


Document Information


Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server > Application Client
Operating system(s): Windows
Software version: 5.0
Software edition:
Reference #: 1106927
IBM Group: Software Group
Modified date: Mar 3, 2004