WebLogic Application Server

See Set up Agents for information on installing the agent.

WebLogic 9 - WebLogic 12

Perform these steps to configure AppMon to diagnose applications on WebLogic 9 or 10 running on Windows using Java 1.5 or higher. WebLogic 12 using Java 7 is also supported.

  1. Extend the environment variable JAVA_OPTIONS to include the following: -agentpath:<DT_HOME>\agent\lib\\dtagent.dll=name=<AgentName>,server=<dynatraceCollectorName> where <DT_HOME> represents the AppMon installation directory.
  2. Modify JAVA_OPTIONS in the WebLogic startup script (startWebLogic.bat) as shown in the following. The example path shows an AppMon 64-bit installation.

set JAVA_OPTIONS= -agentpath:<DT_HOME>\agent\lib\dtagent.dll=name=<AgentName>,server=<dynatraceCollectorName> %JAVA_OPTIONS%

echo starting weblogic with Java version:

%JAVA_HOME%\bin\java %JAVA_VM% -version

if "%WLS_REDIRECT_LOG%"=="" (
	echo Starting WLS with line:
	echo %JAVA_HOME%\bin\java %JAVA_VM% %MEM_ARGS% {color:blue}*%JAVA_OPTIONS%*{color}
        -Dweblogic.Name=%SERVER_NAME% -Djava.security.policy=%WL_HOME%\server\lib\weblogic.policy
        -Djava.security.policy=%WL_HOME%\server\lib\weblogic.policy %PROXY_SETTINGS% %SERVER_CLASS%
) else (
	echo Redirecting output from WLS window to %WLS_REDIRECT_LOG%
	%JAVA_HOME%\bin\java %JAVA_VM% %MEM_ARGS% {color:blue}*%JAVA_OPTIONS%*{color} -Dweblogic.Name=%SERVER_NAME%
        -Djava.security.policy=%WL_HOME%\server\lib\weblogic.policy %PROXY_SETTINGS%

Alternatives for all supported Operating Systems

If using the browser-based Console or Node Manager to control your WebLogic instances, you have other configuration options. You can configure the Node Manager to use start scripts. According to Oracle documentation:

When you start Node Manager, it reads the nodemanager.properties file with the StartScriptEnabled=true property, and uses the start scripts when it subsequently starts Managed Servers. Note that you need to run the setNMProps script only once.

If you do not want to use start scripts, you can do the following, as illustrated by the figures below:

  1. Start your WebLogic Admin instance.
  2. Start the Administration Console by entering the <host>:<port>, for example localhost:7001.
    WebLogic administration console
  3. Through the Domain Structure pane, navigate to <base_domain> > Environment > Servers > <yourManagedServer>.
  4. In the Servers table on the Configuration tab in the Summary of Servers, select the server.
    Select the server
  5. In the Arguments field, enter the Add Tier wizard's Agent string:
    Enter the Agent string

WebLogic Agent naming

For Agents injected to WebLogic, the server name is appended in square brackets right after the Agent name, where serverName is defined by command line argument -Dweblogic.Name.