Knowledge Base

Showing results for 
Search instead for 
Did you mean: 

Instrumenting Java Web Start Applications

Java Web Start software allows you to download and run Java applications from the web and is included in the Java Runtime Environment (JRE) since release of Java 5.0. Java Web Start applications are launched by using the Java Network Launch Protocol (JNLP).



  • Java client application launched via JNLP
  • JVM: Oracle 1.7.0_71
  • Java(TM) SE Runtime Environment (build 1.7.0_71-b14)
  • OS: Windows 7 64-bit 



To attach the Java Agent, use one of the following approaches:


Approach 1

javaws -J-javaagent:<agent-install-dir>\javaagent.jar <jnlp file>


Approach 2


set JAVA_HOME=C:\Program Files\Java\jre7
set JAVA_TOOL_OPTIONS=-javaagent:<agent-install-dir>\javaagent.jar<JAVA_HOME>\bin\javaws.exe <jnlp file>


Security Settings

If the agent is not behaving as expected due to security related issues, then you might need to tweak Java security settings as follows:
  1. Find the <JAVA_HOME>\lib\security\javaws.policy file .
  2. Edit the file with these settings: 
grant codeBase "file:${jnlpx.home}/javaws.jar" {

grant {


Version history
Revision #:
6 of 6
Last update:
‎11-19-2018 01:46 PM
Updated by:
Labels (1)
Tags (3)

Found this article helpful? Click the Thumbs Up button.
Have an additional comment? Post it below.