Agents › DevTest Java Agent › Java Agent Installation › Platform-Specific Agent Installation › IBM WebSphere App Server

IBM WebSphere App Server

This topic applies to IBM WebSphere Application Server 7.0 and 8.5.

To configure IBM WebSphere Application Server to use the DevTest Java Agent, use any of the following approaches:

• Administrative console
• server.xml file
• wsadmin tool

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

-javaagent:/home/itko/agent/InsightAgent.jar=url=tcp://172.24.255.255:2009,name=was70_linux32

Administrative Console

In this procedure, you use the web-based Administrative console to specify the agent parameters string.

Follow these steps:

1. Go to the Administrative console.
2. Navigate to your application server.
3. Expand Java and Process Management and click the Process definition link on the Configuration tab.
4. Click Java Virtual Machine under Additional Properties.
5. Specify the agent parameters string in the Generic JVM arguments field.

server.xml File

In this procedure, you use the server.xml file to specify the agent parameters string.

Follow these steps:

1. Go to the WAS_HOME/AppServer/profiles/AppSrv01/config/cells/<cell_name>/nodes/<node_name>/servers/server1 directory.
2. Open the server.xml file.
3. At the bottom of the file, change the genericJvmArguments entry.

   <jvmEntries ... genericJvmArguments="<agent_parameters_string>" .../> 
   

wsadmin Tool

You can use the wsadmin tool.

In the following example, the agent parameters string is specified with the modify command of the AdminConfig object. The Jacl scripting language is used.

C:\IBM\WebSphere70\AppServer\bin>hostname
cam-aa74651f617
 
C:\IBM\WebSphere70\AppServer\bin>wsadmin
WASX7209I: Connected to process "server1" on node cam-aa74651f617Node01 using SOAP connector;  The type of process is: UnManagedProcess
WASX7029I: For help, enter: "$Help help"
 
wsadmin>set server1 [$AdminConfig getid /Cell:cam-aa74651f617Node01Cell/Node:cam-aa74651f617Node01/Server:server1/ ]
server1(cells/cam-aa74651f617Node01Cell/nodes/cam-aa74651f617Node01/servers/server1|server.xml#Server_1255494205517)
 
wsadmin>set jvm [$AdminConfig list JavaVirtualMachine $server1]
(cells/cam-aa74651f617Node01Cell/nodes/cam-aa74651f617Node01/servers/server1|server.xml#JavaVirtualMachine_1255494205517)
 
wsadmin>$AdminConfig modify $jvm genericJvmArguments "<agent_parameters_string>"
 
wsadmin>$AdminConfig save
 
wsadmin>quit