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:

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

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


Vendor: Sun Microsystems Inc.
 Version 1.2.2
  
  • classic mode:
    java -classic -Xrunjprofiler:${PARAM} [solaris: -native] -Djava.compiler=none -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]

    Note: is not available on Solaris

  • default mode:
    java -Xrunjprofiler:${PARAM} [solaris: -native] -Djava.compiler=none -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]

    Note: is only available on Solaris

 Version 1.3.0
  
  • classic mode:
    java -classic -Xrunjprofiler:${PARAM} [solaris: -Xboundthreads] -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]

    Note: is not available on Solaris

  • default mode:
    java -Xrunjprofiler:${PARAM} [solaris: -Xboundthreads] -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]

    Note: is only available on Solaris

 Version 1.3.1
  Unsupported releases with known problems: 1.3.1, 1.3.1_01
  
  • interpreted mode:
    java -Xint -Xrunjprofiler:${PARAM} [solaris: -Xboundthreads] -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]
  • hotspot mode:
    java -Xrunjprofiler:${PARAM} [solaris: -Xboundthreads] -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]

    Note: does not work with full instrumentation

  • classic mode:
    java -classic -Xrunjprofiler:${PARAM} [solaris: -Xboundthreads] -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]

    Note: is not available on Solaris

 Version 1.4.0
  Unsupported releases with known problems: 1.4.0-beta, 1.4.0-beta2, 1.4.0-beta3, 1.4.0-rc, 1.4.0
  
  • 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.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 -agentlib:jprofilerti=${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 -agentlib:jprofilerti=${PARAM} -Xbootclasspath/a:[path to agent.jar][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 -agentlib:jprofilerti=${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 -agentlib:jprofilerti=${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]
Vendor: IBM Corporation
 Version 1.3.0
  
  • 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 full instrumentation and sampling

 Version 1.3.1
  see version 1.3.0
 
 Version 1.4.0
  see version 1.3.0
 
 Version 1.4.1
  see version 1.3.0
 
 Version 1.4.2
  see version 1.3.0
 
 Version 1.5.0
  
  • jit compiler (>= 1.5) mode:
    java -agentlib:jprofilerti=${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]

    Note:

  • interpreted (>= 1.5) mode:
    java -Xint -agentlib:jprofilerti=${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]
Vendor: Apple Computer, Inc.
 Version 1.3.1
  
  • interpreted mode:
    java -Xint -Xrunjprofiler:${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]
 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 -agentlib:jprofilerti=${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]
  • interpreted mode:
    java -Xint -agentlib:jprofilerti=${PARAM} -Xbootclasspath/a:[path to agent.jar][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

Vendor: BEA Systems, Inc.
 Version 1.4.1
  
  • default mode:
    java -Xjvmpi:entryexit=off -Xrunjprofiler:${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]

    Note: does not work with full instrumentation

  • fullinstr mode:
    java -Xrunjprofiler:${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]

    Note: choose only when working with full instrumentation

  • 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 -Xjvmpi:entryexit=off -Xrunjprofiler:${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]

    Note: does not work with full instrumentation

  • fullinstr mode:
    java -Xrunjprofiler:${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]

    Note: choose only when working with full instrumentation

  • 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 -Xjvmpi:entryexit=off -agentlib:jprofilerti=${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]

    Note: does not work with full instrumentation

  • noopt mode:
    java -Xnoopt -agentlib:jprofilerti=${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]
Vendor: Hewlett-Packard Co.
 Version 1.3.1
  
  • interpreted mode:
    java -Xint -Xrunjprofiler:${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]
  • 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

  • classic mode:
    java -classic -Xrunjprofiler:${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]
 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 -agentlib:jprofilerti=${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 -agentlib:jprofilerti=${PARAM} -Xbootclasspath/a:[path to agent.jar][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 -agentlib:jprofilerti=${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 -agentlib:jprofilerti=${PARAM} -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]