Using the Java Web Start sample

The EAR file, WebSphereClientRuntime.ear, is provided in the JWS directory of the Client Application for WebSphere Application Server installation. This EAR file provides a sample Application Clients run-time installer JNLP descriptor file and a sample Application Clients run-time library component JNLP descriptor file. Follow the steps in this task to build the Application Clients run-time dependency component and the Application Clients run-time library component. Add these components to the WebSphereClientRuntime.ear file, and then install the EAR file in an Application Server to be used by the client application.

Overview

Procedure

1. Install the Application Clients on the client application supported operating system. For example, install Application Clients in the C:\Program Files\IBM\WebSphere\AppClient directory.

2. Create the following temporary working directories:

   MKDIR C:\WebApp1
   MKDIR C:\WebApp1\runtime
   MKDIR C:\WebApp1\runtime\Widnows
   MKDIR C:\WebApp1\runtime\WebSphereJars
   

3. Change directory to the installation bin directory. See the following example for help:

   CD C:\Program files\IBM\WebSphere\AppClient\bin

4. Run the buildClientRuntime tool to generate the Application Clients run-time JAR file in a temporary directory that contains the Java 2 Runtime Environment that IBM provides, Application Clients run-time properties, the SSL KeyStore and TrustStore files, and the Application Clients run-time library JAR files. See the following example for details:

   buildClientRuntime C:\WebApp1\runtime\windows\WASClient6.1.0_Windows.jar

5. Copy the WebSphereClientRuntimeInstaller.jar file to the same location of the JAR file generated in the previous step. This JAR file is located in the JWS directory of the Application Client for WebSphere Application Server installation. For example, copy the ..\JWS\WebSphereClientRuntimeInstaller.jar file to the C:\WebApp1\runtime directory.

6. Sign the JAR files created from the previous steps, using the Java 2 SDK jarsigner utility. See the following example for details:

   cd C:\WebApp1\runtime
   
   jarsigner -keystore myKeystore -storepass myPassword 
                   WASClient6.1_windows.jar myKeyAliasName
   
   jarsigner -keystore myKeystore -storepass myPassword 
                   WebSphereClientRuntimeInstaller.jar myKeyAliasName
   

   1. This step also requires you to create a keystore file, such as myKeystore.

   2. You must also create a self-signed certificate for the myKeystore file.

7. Run buildClientLibJars to copy the Application Clients run-time library JAR files from the Application Client for WebSphere Application Server installation to a temporary directory. All the JAR files in the temporary directory are signed. See the following example for details:

   buildClientLibJars C:\WebApp1\runtime\WebSphereJars 
                      myKeystore myPassword myKeyAliasName
   

   1. This step also requires you to create a keystroke file, such as myKeystore.

   2. You must also create a self-signed certificate for the myKeystore file.

8. Add all the JAR files created in the previous steps in the C:\WebApp1 directory to the WAR file within the WebSphereClientRuntime.ear file. The contents of the WAR file are shown in the following example:

   The root of the WAR
   ├───META-INF
   │                MANIFEST.MF
   │
   ├───Runtime
   │   ├───WebSpherejars
   │   │         AppClientLib.jnlp   
   │   │         com.ibm.ws.runtime_6.1.0.jar   
   │   │         com.ibm.ws.j2ee.client_6.1.0.jar   
   │   │         com.ibm.ws.wccm_6.1.0.jar   
   │   │                   :
   │   │         (all the jars created in step 7 under  
   │   │         c:\WebApp1\Runtime\WebSphereJars)
   │   └───WebSphereJre
   │            AppClientRT.jsp
   │            WASClient6.1.0_Windows.jar
   │            WebSphereClientLauncher.jar
   │            WebSphereClientRuntimeInstaller.jar │
   │
   └───WEB-INF
           ibm-web-bnd.xmi
           ibm-web-ext.xmi
           web.xml
   

9. Install the WebSphereClientRuntime.ear file to an Application Server. You have just created an Application Clients run-time dependency component and Application Clients run-time libraries for serving J2EE Application client applications and Thin Application client applications using Java Network Launching Protocol (JNLP) or Java Web Start (JWS).