## Remote session invocation table |
previous | up | next

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 braces like `[your path to agent.jar]` are to be replaced according to the textual description. `${PARAM}` is to be replaced by the parameters you would like to pass to the profiling agent. The following parameters are available:

- port=nnnnn chooses the port on which the agent listens for remote connections. Be sure to use the same value in JProfiler's GUI front end.
- offline enables the offline profiling mode. You cannot connect with the GUI front end when using the offline profiling mode. The parameters id and config have to be supplied as well.
- id=nnnnn chooses the session used for offline profiling.
- config={path to JProfiler config file} supplies the path to JProfiler's configuration file. This parameter is only needed for offline profiling.
- verbose-instr prints the names of all instrumented classes to stderr. This is a debugging option.

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

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]`
- mixed mode:
  | `java -Xmixed -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
- |  | mixed mode:
  | `java -Xmixed -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
- |  | mixed mode:
  | `java -Xmixed -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
- |  | mixed mode:
  | `java -Xmixed -Xrunjprofiler:${PARAM} -Xshare:off -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} -Xshare:off -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]`
Vendor: IBM Corporation
| Version 1.3.0
- |  | default mode:
  | `java -Xrunjprofiler:${PARAM} -Djava.compiler=none -Xbootclasspath/a:[path to agent.jar][your JVM parameters] -classpath [class path] [main class] [parameters]`
| Version 1.3.1
|  | see version 1.3.0
| Version 1.4.0
|  | see version 1.3.0
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
- |  | 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
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]`