Preparing Application Clients run-time library component for Java Web Start

The Java Web Start client is used with platforms that support a Web browser. For a Thin Application client application to be launched using Java Web Start (JWS), you also need to create a Java Network Launching Protocol (JNLP) component to serve the Application Clients run-time library JAR files from the Application server. This JNLP component is referenced in the client application JNLP file with the <extension> tag. This article provides the steps to build the Application Clients run-time library component from an Application Clients installation. It is packaged as its own Web Archive Resource (WAR) file or to the same WAR file that contains the Application Clients run-time dependency component, and can be installed in an Application server.

Before you begin

Java Web Start is not supported on i5/OS.

Install the Application Client for WebSphere Application Server for the platform to which client applications deploy.

Procedure

  1. Install the Application Clients on the client application supported operating system.
  2. Change the directory to the installation bin directory.
  3. Run buildClientLibJars to copy the Application Clients run-time library JAR files from the Application Clients installation to a temporary directory. All the JAR files in the temporary directory are signed.
    1. This step also requires you to create a keystore file, such as myKeystore.
    2. This step also requires you to create a keystroke file, such as myKeystore.
    3. You must also create a self-signed certificate for the myKeystore file.
  4. Create an Application Clients run-time installer JNLP descriptor file in the same temporary directory as the previous step. See the sample JNLP file shown in the Example section of this topic.
  5. Package these JAR files and the Application Clients run-time library component JNLP descriptor file into a WAR file. You can also package both Application Clients run-time library component and Application Clients run-time dependency component in the same WAR file. This WAR file is packaged into an EAR file that can deployed to an Application server.

Example

<!--
  "This sample program is provided AS IS and may be used, executed, copied
and modified without royalty payment by customer (a) for its own instruction
and study, (b) in order to develop applications designed to run with an IBM
WebSphere product, either for customer's own internal use or for redistribution
by customer, as part of such an application, in customer's own products."
Product 5630-A36,  (C) COPYRIGHT International Business Machines Corp., 2004
All Rights Reserved * Licensed Materials - Property of IBM
-->
<%! private final String description="WebSphere Jars";  
%>
<%  // locally declared variable     

String	urlSt = request.getRequestURL().toString();     
String	jnlpCodeBase=urlSt.substring(0,urlSt.lastIndexOf('/'));     
String	jnlpRefURL=urlSt.substring(urlSt.lastIndexOf('/')+1,urlSt.length());     
// The client application descriptor noted a resource reference to be resolved at deploy time as following 
%> 
<%--     
	Need to set a JNLP mime type - if Web Start is installed on the client,     
	this header will induce the browser to drive the Web Start Client 

--%><% 
	response.setContentType("application/x-java-jnlp-file");   1 
	response.setHeader("Cache-Control", null); 
	response.setHeader("Set-Cookie", null); 
	response.setHeader("Vary", null); 
	response.setDateHeader("Last-Modified", lastModified);   2
%>
<?xml version="1.0" encoding="utf-8"?>
<!-- JNLP File for <%=description %> -->
<jnlp
  spec="1.0+"
	<%-- Automate the code base response
--%> codebase="<%=jnlpCodeBase%>"
href="<%=jnlpRefURL%>">
	<information>
		<title><%=description %></title>
		<description kind="short"><%=description %></description>
		<description kind="tooltip"><%=description %></description>
		<offline-allowed></offline-allowed>
	</information>
	<security>
	<all-permissions></all-permissions>
</security>
	<resources>
  	  <jar href="activation-impl.jar"/>			3
    <jar href="activity.jar"/>
    <jar href="activityImpl.jar"/>
    <jar href="activitySession.jar"/>
    <jar href="activitySessionPrivate.jar"/>
    <jar href="acwa.jar"/>
    <jar href="admin.jar"/>
    <jar href="annotations-core.jar"/>
    <jar href="appprofile-impl.jar"/>
    <jar href="appprofile.jar"/>
    <jar href="b2bjaxp.jar"/>

	  <!-- ========================================  -->
    <!--                                           -->
    <!-- specify all the signed jars created by    -->
    <!-- buildClientlibJars tool                   -->
    <!--                                           -->
    <!-- ========================================  -->

    <jar href="wsif-j2c.jar"/>
    <jar href="wsif.jar"/>
    <jar href="wssec.jar"/>
    <jar href="wtp-util.jar"/>
    <jar href="wtpemf.jar"/>
    <jar href="xsd.jar"/>
    <jar href="xsd.resources.jar"/>
    <jar href="xss4j-dsig.jar"/>
    <jar href="xss4j-enc.jar"/>
	</resources>
	<component-desc/>
</jnlp>
<!--
  "This sample program is provided AS IS and can be used, executed, copied
and modified without royalty payment by customer (a) for its own instruction
and study, (b) in order to develop applications designed to run with an IBM
WebSphere product, either for customer's own internal use or for redistribution
by customer, as part of such an application, in customer's own products."
Product 5630-A36,  (C) COPYRIGHT International Business Machines Corp., 2005
All Rights Reserved * Licensed Materials - Property of IBM
-->
<?xml version="1.0" encoding="utf-8"?>
<jnlp spec="1.0+"
codebase="http://YOUR_APP_SERVER:PORTNUMBER/WEBAPP_CONTEXT_ROOT/Runtime/WebSphereJars">
	<information>
		<title>Application Client Library</title>
		<vendor>IBM</vendor>
		<icon href="icon.gif"/>
		<description>Application Client Library</description>
		<description kind="short">Application Client Library</description>
		<description kind="tooltip">Application Client Library</description>
		<offline-allowed/>
	</information>
	
<security>
	<all-permissions/>
</security>

<component-desc/>
	<resources><jar href="activation-impl.jar"/>
<jar href="bootstrap.jar"/>			
<jar href="com.ibm.events.client_6.1.0.jar"/>
<jar href="com.ibm.mq.jar"/>
<jar href="com.ibm.mqjms.jar"/>
<jar href="com.ibm.uddi.client_1.0.0.jar"/>
<jar href="com.ibm.ws.bootstrap_6.1.0.jar"/>
<jar href="com.ibm.ws.debug.osgi_6.1.0.jar"/>
<jar href="com.ibm.ws.emf_2.0.0.jar"/>
<jar href="com.ibm.ws.j2ee.client_6.1.0.jar"/>
<jar href="com.ibm.ws.runtime.dist_6.1.0.jar"/>
<jar href="com.ibm.ws.runtime.gateway_6.1.0.jar"/>
<jar href="com.ibm.ws.runtime_6.1.0.jar"/>
<jar href="com.ibm.ws.security.crypto_6.1.0.jar"/>
<jar href="com.ibm.ws.sib.client_2.0.0.jar"/>
<jar href="com.ibm.ws.sib.utils_2.0.0.jar"/>
<jar href="com.ibm.ws.wccm_6.1.0.jar"/>
<jar href="com.ibm.wsspi.extension_6.1.0.jar"/>
<jar href="dhbcore.jar"/>
<jar href="j2ee.jar"/>
<jar href="launchclient.jar"/>
<jar href="lmproxy.jar"/>
<jar href="mail-impl.jar"/>
<jar href="org.eclipse.core.runtime_3.1.1.jar"/>
<jar href="org.eclipse.osgi_3.1.1.jar"/>
<jar href="org.eclipse.update.configurator_3.1.0.jar"/>
<jar href="properties.jar"/>
<jar href="serviceadapter.jar"/>
<jar href="startup.jar"/>
<jar href="urlprotocols.jar"/>
<jar href="WebSphereClientLauncher.jar"/>
	<resources/><jnlp/>



In this information ...


Related concepts

IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic Task topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Aug 30, 2013 10:47:11 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=pix&product=was-nd-iseries&topic=tcli_capps
File name: tcli_capps.html