This blog introduces how to diagnose Agile PLM related issues.

  • June 8, 2013

Agile JavaClient and Java Web Start

Jie Chen
Senior Principal Technical Support Engineer

JavaClient uses Java Web Start technology to launch all required jar files and resources into local cache to deploy with online and offline mode. We will discuss how JavaClient is loaded from remote Application Server.

Detect Java Web Start

Usually we access JavaClient from the entrance http://host:port/JavaClient/start.html . This start.html will detect if Java Web Start is installed on local client machine with below script language in browser's engine. If the browser is not IE, we use navigator element and its function to detect application/x-java-jnlp-file. Else it will use VBScript in IE's engine to detect the object of JavaWebStart. The detailed code is like below. You also can refer to Oracle document in this link. http://docs.oracle.com/javase/7/docs/technotes/guides/javaws/developersguide/launch.html


pcclient.jnlp is the entrance point of JavaClient. We save the file to local and open in notepad. We will notice there is codebase defined as below:


That means all the jar and resource must be loaded from the base URL /JavaClient/.

Below entry define the required data for JavaClient. It requires 1.6+ JRE, and defines the expected max heap size. The required jar and other expected extension resources in other referenced jnlp files.

After all the resource is loaded into local cache, the main class com.agile.ui.pcclient.PCClient runs and asks for login. If we click the Option in login window, we see URL is pre-defined. It is actually read from the pcclient.jnlp.


Additionally information we can see directly from JavaClient is the webserverName, appserverVersion and UpdateVersions, all of them are defined here as well.

Local Cache

Previously we say all jar and resource are loaded from remote into local machine, if we go to java's cache directory we will see all of them.

Join the discussion

Comments ( 4 )
  • Manju Monday, November 18, 2013

    Hi Jie,

    All of a sudden, my start.html page does not load at all. No error message nothing - a blank page opens up.

    I have FF22 & IE8. Agile version is and app server is OAS10.3.0.1

    I have an old JNLP stored however it is not opening - a message comes up after verification "your security settings have an application from running with an out-of-date version of java".

    I have fixed this message by reducing the security setting for Java to medium.

    However, the start page still does not load.

    Any suggestions?



  • Jie Chen Monday, December 2, 2013

    Hi Manju,

    If you are using JRE 6, you need to upgrade to latest Update of JRE 6, not reducing the security setting.


  • Kee Hoong Tuesday, February 11, 2014

    Hi Jie,

    I able to launch the start page and java client. But after key in username and password, it popup error stated "server is not available"

    any idea?


    Kee Hoong

  • guest Tuesday, February 18, 2014

    Possible cause:

    1. Your serverURL is pointing to a Loadbalancer/IIS which does not support t3/ormi protocol.

    2. serverURL is pointing to the Admin server if app server is weblogic.

Please enter your name.Please provide a valid email address.Please enter a comment.CAPTCHA challenge response provided was incorrect. Please try again.