Java applets

See Set up Agents for instructions on installing the agent.

Applet viewer

*NIX

AppMon Agent deployment steps for Java 1.5 or higher

  1. Locate the AppletViewer within the JDK package installed on your machine. For example: /usr/java/jdk1.5.0_06/bin.
  2. Execute the Applet Viewer with the following parameters: ./appletviewer URL -J-agentpath:<DT_HOME>/agent/lib/libdtagent.so=name=<AgentName>,server=<dynaTraceCollectorName>.

[labuser@labmachine bin]$ ./appletviewer http://java.sun.com/applets/jdk/1.4/demo/applets/TicTacToe/example1.html -J-agentpath:<DT_HOME>/agent/lib/libdtagent.so=name=<AgentName>,server=<dynaTraceCollectorName>.

AppMon Agent deployment steps for Java 1.4

  1. Append <DT_HOME>/agent/lib to the system environment variable LD_LIBRARY_PATH.
  2. Locate the AppletViewer within the JDK package installed on your machine. For example:/usr/java/jdk1.4.2_05/bin.
  3. Execute the Applet Viewer with the following parameters: ./appletviewer URL -J-Xrundtagent:name=<agentname>,server=<serverhostname>.

For example: [labuser@labmachine bin]$ export LD_LIBRARY_PATH=/home/user/dynatrace-6.5/agent/lib:$LD_LIBRARY_PATH
[labuser@labmachine bin]$ ./appletviewer http://java.sun.com/applets/jdk/1.4/demo/applets/TicTacToe/example1.html -J-Xrundtagent:name=<agentname>,server=<serverhostname>

Windows

AppMon Agent deployment steps for J2SE 5.0

  1. Locate the AppletViewer within the JDK package installed on your machine. For example: C:\devtools\jdk1.5.0_06\bin.
  2. Execute the Applet Viewer with the following parameters: appletviewer.exe URL -J-agentpath:<DT_HOME>\agent\lib\\dtagent.dll=name=<AgentName>,server=<dynatraceCollectorName>.

For example: C:\devtools\jdk1.5.0_06\bin>appletviewer.exe http://java.sun.com/applets/jdk/1.4/demo/applets/TicTacToe/example1.html -J-agentpath:<DT_HOME>\agent\lib\\dtagent.dll=name=<AgentName>,server=<dynatraceCollectorName>

AppMon Agent deployment steps for J2SE 1.4

  1. Append <DT_HOME>\agent\lib to the system environment variable PATH.
  2. Locate the AppletViewer within the JDK package installed on your machine. For example: C:\devtools\jdk1.4.2_05\bin.
  3. Execute the Applet Viewer with the following parameters: ./appletviewer URL -J-Xrundtagent:name=<agentname>,server=<serverhostname>.

For example: C:\devtools\jdk1.4.2_05\bin>appletviewer.exe http://java.sun.com/applets/jdk/1.4/demo/applets/TicTacToe/example1.html -J-Xrundtagent:name=<agentname>,server=<serverhostname>

Web browser: Java control panel

*NIX

AppMon Agent deployment steps for Java 1.5 or higher

  1. Locate the Java Control Panel within the JDK package installed on your machine. For example: /usr/java/jdk1.5.0_06/jre/bin.
  2. Start the Control Panel.
  3. Add the following option to Java > Java Applet Runtime Settings > Java Runtime Parameters: -agentpath:<DT_HOME>/agent/lib/libdtagent.so=name=<AgentName>,server=<dynaTraceCollectorName>.

AppMon Agent deployment steps for Java 1.4:

  1. Append <DT_HOME>/agent/lib to the system environment variable LD_LIBRARY_PATH.
  2. Locate the Java Control Panel within the JDK package installed on your machine. For example: /usr/java/jdk1.4.2_05/jre/bin. Make sure that the JAVA_HOME system environment variable is set to this JDK package.
  3. Start the Control Panel.
  4. Add the following option to Advanced > Java Runtime Parameters: -Xrundtagent:name=<agentname>,server=<serverhostname>.

Windows

Deployment steps for Java 1.5 or higher

  1. Open and start the Java Control Panel, Start > Control Panel.

  2. Add the following option to Java > Java Applet Runtime Settings > Java Runtime Parameters: -agentpath:<DT_HOME>\agent\lib\\dtagent.dll=name=<AgentName>,server=<dynatraceCollectorName>.

    Additionally, the following debug options should be set:

AppMon Agent deployment steps for Java 1.4

  1. Append <DT_HOME>\agent\lib to the system environment variable PATH.
  2. Open and start the Java Control Panel: Start >Control Panel.
    Make sure that the JAVA_HOME system environment variable is set to this JDK package.
  3. Add the following option to Advanced > Java Runtime Parameters: -Xrundtagent:name=<agentname>,server=<serverhostname>.

Web browser: alternate agent deployment for JAVA_TOOL_OPTIONS

Since the command-line cannot always be accessed or modified (for example, in embedded VMs or in VMs launched deep within scripts), a JAVA_TOOL_OPTIONS variable is provided so that the AppMon Agent can be launched in these cases. Platforms that support environment variables or other named strings may support the JAVA_TOOL_OPTIONS variable. This variable is broken into options at white-space boundaries. White-space characters include space, tab, carriage-return, new-line, vertical-tab, and form-feed. Sequences of white-space characters are considered equivalent to a single white-space character. No white space is included in the options unless quoted. Quoting is as follows:

  • All characters enclosed within single quotation (´ ´), except quotation marks themselves, are quoted.
  • Double-quotation characters have no special meaning inside a pair of single quotation marks.
  • All characters enclosed between a pair of double-quotation marks (" "), except a double-quotation, are quoted.
  • Single-quotation characters have no special meaning inside a pair of double-quotation marks.
  • A quoted part can start or end anywhere in the variable.
  • White-space characters have no special meaning when quoted ‐ they are included in the option like any other character and do not mark white-space boundaries.
  • The pair of quotation marks is not included in the option.

Set JAVA_TOOL_OPTIONS=-agentpath:<DT_HOME>\agent\lib\dtagent.dll=name=<AgentName>,server=<dynatraceCollectorName>. Then start your Web Browser from the command line. For example: C:\Program Files\Internet Explorer>IEXPLORE.EXE.