Java applets

See Set up Agents for instructions on installing the agent.

Applet viewer

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>

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

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:

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 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.