Remote Session Invocation Table

     


Please look at the help page on starting remote sessions for a complete sequence of steps that need to be taken for remote profiling. Below you find the condensed instructions on how to modify your startup command for a remote profiling session. The table shows all supported JVM vendors and versions. Square brackets like [your path to agent.jar] are to be replaced according to the textual description, or they contain platform dependent options, like [solaris: -native], which means that on Solaris, you should add -native but nothing on other platforms.

${PARAM} is to be replaced by the parameters you would like to pass to the profiling agent. The following parameters are available:

${LIBRARY} (JVMTI only) is to be replaced by the full path to the native JProfiler library.

Multiple parameters are separated by commas such as in
"offline,id=172,config=~/.jprofiler7/config.xml".

In addition to the standard parameters above, there are the following trouble-shooting and debugging parameters:


Vendor: Oracle (formerly Sun)
 Version 1.4.1
  
  • hotspot mode:
    java -Xrunjprofiler:${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]
  • interpreted mode:
    java -Xint -Xrunjprofiler:${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]
 Version 1.4.2
  see version 1.4.1
 
 Version 1.5.0
  
  • hotspot mode:
    java -agentpath:${LIBRARY}=${PARAM} [your JVM parameters] -classpath [class path] [main class] [parameters]
  • interpreted mode:
    java -Xint -agentpath:${LIBRARY}=${PARAM} [your JVM parameters] -classpath [class path] [main class] [parameters]
  • hotspot (JVMPI) mode:
    java -Xshare:off -Xrunjprofiler:${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]

    Note: deprecated, default interface JVMTI is preferred

  • interpreted (JVMPI) mode:
    java -Xint -Xshare:off -Xrunjprofiler:${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]

    Note: deprecated, default interface JVMTI is preferred

 Version 1.6.0
  
  • hotspot mode:
    java -agentpath:${LIBRARY}=${PARAM} [your JVM parameters] -classpath [class path] [main class] [parameters]
  • interpreted mode:
    java -Xint -agentpath:${LIBRARY}=${PARAM} [your JVM parameters] -classpath [class path] [main class] [parameters]
 Version 1.7.0
  see version 1.6.0
 
 Version 1.8.0
  see version 1.6.0
 
Vendor: IBM Corporation
 Version 1.4.1
  
  • interpreted mode:
    java -Djava.compiler=none -Xrunjprofiler:${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]
  • jit compiler mode:
    java -Xrunjprofiler:${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]

    Note: does not work with sampling

 Version 1.4.2
  see version 1.4.1
 
 Version 1.5.0
  
  • jit compiler mode:
    java -agentpath:${LIBRARY}=${PARAM} -Xshareclasses:none [your JVM parameters] -classpath [class path] [main class] [parameters]

    Note: does not work with sampling

  • interpreted mode:
    java -Djava.compiler=none -agentpath:${LIBRARY}=${PARAM} -Xshareclasses:none [your JVM parameters] -classpath [class path] [main class] [parameters]
 Version 1.6.0
  
  • jit compiler mode:
    java -agentpath:${LIBRARY}=${PARAM} -Xshareclasses:none [your JVM parameters] -classpath [class path] [main class] [parameters]

    Note: does not work with sampling

  • interpreted mode:
    java -Djava.compiler=none -agentpath:${LIBRARY}=${PARAM} -Xshareclasses:none [your JVM parameters] -classpath [class path] [main class] [parameters]
 Version 1.7.0
  see version 1.6.0
 
Vendor: Apple Computer, Inc.
 Version 1.4.1
  
  • hotspot mode:
    java -Xrunjprofiler:${PARAM} -XX:-UseSharedSpaces -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]
  • interpreted mode:
    java -Xint -Xrunjprofiler:${PARAM} -XX:-UseSharedSpaces -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]
 Version 1.4.2
  see version 1.4.1
 
 Version 1.5.0
  
  • hotspot mode:
    java -agentpath:${LIBRARY}=${PARAM} [your JVM parameters] -classpath [class path] [main class] [parameters]
  • interpreted mode:
    java -Xint -agentpath:${LIBRARY}=${PARAM} [your JVM parameters] -classpath [class path] [main class] [parameters]
  • hotspot (JVMPI) mode:
    java -XX:-UseSharedSpaces -Xrunjprofiler:${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]

    Note: deprecated, default interface JVMTI is preferred

  • interpreted (JVMPI) mode:
    java -Xint -XX:-UseSharedSpaces -Xrunjprofiler:${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]

    Note: deprecated, default interface JVMTI is preferred

 Version 1.6.0
  
  • hotspot mode:
    java -agentpath:${LIBRARY}=${PARAM} [your JVM parameters] -classpath [class path] [main class] [parameters]
  • interpreted mode:
    java -Xint -agentpath:${LIBRARY}=${PARAM} [your JVM parameters] -classpath [class path] [main class] [parameters]
Vendor: Oracle JRockit
 Version 1.4.1
  
  • default (JVMPI) mode:
    java -Xjvmpi:entryexit=off -Xrunjprofiler:${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]

    Note:

  • noopt mode:
    java -Xnoopt -Xrunjprofiler:${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]
 Version 1.4.2
  see version 1.4.1
 
 Version 1.5.0
  
  • default mode:
    java -Xrunjprofiler:${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]

    Note:

  • default (JVMPI) mode:
    java -Xjvmpi:entryexit=off -Xrunjprofiler:${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]

    Note:

  • noopt mode:
    java -Xnoopt -Xrunjprofiler:${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]
 Version 1.6.0
  
  • default mode:
    java -agentpath:${LIBRARY}=${PARAM} [your JVM parameters] -classpath [class path] [main class] [parameters]

    Note:

Vendor: Hewlett-Packard Co.
 Version 1.4.1
  
  • hotspot mode:
    java -Xrunjprofiler:${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]
  • interpreted mode:
    java -Xint -Xrunjprofiler:${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]
 Version 1.4.2
  see version 1.4.1
 
 Version 1.5.0
  
  • hotspot mode:
    java -agentpath:${LIBRARY}=${PARAM} [your JVM parameters] -classpath [class path] [main class] [parameters]
  • interpreted mode:
    java -Xint -agentpath:${LIBRARY}=${PARAM} [your JVM parameters] -classpath [class path] [main class] [parameters]
  • hotspot (JVMPI) mode:
    java -Xshare:off -Xrunjprofiler:${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]

    Note: deprecated, default interface JVMTI is preferred

  • interpreted (JVMPI) mode:
    java -Xint -Xshare:off -Xrunjprofiler:${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]

    Note: deprecated, default interface JVMTI is preferred

 Version 1.6.0
  
  • hotspot mode:
    java -agentpath:${LIBRARY}=${PARAM} [your JVM parameters] -classpath [class path] [main class] [parameters]
  • interpreted mode:
    java -Xint -agentpath:${LIBRARY}=${PARAM} [your JVM parameters] -classpath [class path] [main class] [parameters]
Vendor: The FreeBSD Foundation
 Version 1.4.1
  
  • hotspot mode:
    java -Xrunjprofiler:${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]

    Note: does not work with full instrumentation

  • interpreted mode:
    java -Xint -Xrunjprofiler:${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]
 Version 1.4.2
  see version 1.4.1
 
 Version 1.5.0
  
  • hotspot mode:
    java -agentpath:${LIBRARY}=${PARAM} [your JVM parameters] -classpath [class path] [main class] [parameters]

    Note: does not work with full instrumentation

  • interpreted mode:
    java -Xint -agentpath:${LIBRARY}=${PARAM} [your JVM parameters] -classpath [class path] [main class] [parameters]
  • hotspot (JVMPI) mode:
    java -Xshare:off -Xrunjprofiler:${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]

    Note: deprecated, default interface JVMTI is preferred

  • interpreted (JVMPI) mode:
    java -Xint -Xshare:off -Xrunjprofiler:${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]

    Note: deprecated, default interface JVMTI is preferred

 Version 1.6.0
  
  • hotspot mode:
    java -agentpath:${LIBRARY}=${PARAM} [your JVM parameters] -classpath [class path] [main class] [parameters]

    Note: does not work with full instrumentation

  • interpreted mode:
    java -Xint -agentpath:${LIBRARY}=${PARAM} [your JVM parameters] -classpath [class path] [main class] [parameters]