Agents › DevTest Java Agent › Java Agent Installation › Platform-Specific Agent Installation › Oracle WebLogic Server

Oracle WebLogic Server

This topic applies to Oracle WebLogic Server 10.3 and 12.1.1.

To configure Oracle WebLogic Server to use the DevTest Java Agent, use any of the following approaches:

• Administration console
• config.xml file
• Startup script

For each approach, you specify the agent parameters string as a server startup argument. You can use the agent install assistant to determine the required value. The following example is based on the pure Java agent:

-javaagent:/export/home/wls/agent/LisaAgent2.jar=url=tcp://172.24.255.255:2009,name=wls

Administration Console

To follow the officially supported way to add arguments to the JVM, specify the agent parameters string from the WebLogic administration console. 

Follow these steps:

1. Open the WebLogic administration console.
2. In the Domain Structure panel, expand the Environments node and click the Servers node.
3. Click the Configuration tab and the Server Start subtab.
4. In the Arguments field, add the agent parameters string.
5. Save your changes.

config.xml File

Another approach is to edit the central configuration file for the domain.

Follow these steps:

1. Go to the WEBLOGIC_HOME\user_projects\domains\base_domain\config directory.
2. Open the config.xml file.
3. Add the agent parameters string to the <server>/<server-start>/<arguments> node of the target server.

Startup Script

You can also edit the WebLogic startup script.

In the following example, the JAVA_TOOL_OPTIONS environment variable is used to set the agent parameters string. These lines are located in the startWebLogic.sh file after the Java version check and before the actual WebLogic invocation.

JAVA_TOOL_OPTIONS=<agent_parameters_string>
export JAVA_TOOL_OPTIONS

If the startup script has been customized, the JAVA_TOOL_OPTIONS environment variable is not used.