This article describes how to configure the AppDynamics Java Agent for TIBCO Business Works.
The two most common ways to add the Java Agent to the TIBCO BusinessWorks process are:
To configure the Java Agent for either of these deployment options, you must add the java.extended properties and Jmx.Enabled settings to the application startup as follows:
1. Edit the bwengine.xml for the following environments:
You can find the bwengine.xml at the following path:
2. Add the following properties:
<property> <name>Java Extended Properties</name> <option>java.extended.properties</option> <default></default> <description>JVM run time Properties</description> </property> <property> <name>JMX</name> <option>Jmx.Enabled</option> <default>true</default> <description>JVM run time Properties</description> </property>
3. Rebuild the EAR file for the project.
4. If you use the TIBCO Administrator, upload the new EAR file for deployment.
The Admin UI shows the java.extended.properties. There you can add and remove the Java Agent properties. For example, in the Tibco Admin UI:
Or in the Tibco Designer:
NOTE: Set the Java Agent properties before you deploy and startup TIBCO, otherwise the agent won't instrument your application.
If you are using AppManage, you can export out the configuration. For example:
./AppManage -export -out /home/tibco/<AppName>.xml -ear /home/tibco/<AppName>.ear
The new configuration file includes the java.extended.properties property where you can add the Java Agent configuration. For example:
You can also use the configuration file with the automated deployment script that leverages AppManage.
If you have concerns making the modifications outlined above, you can add the Java Agent to the startup settings for in the configuration files for each application you want to monitor.
In most cases, you want to modify the "<application_name>.tra" file named for the application. For example: MyTIBCOApp.tra.
1. Edit the <application_name>.tra file for the application you want to monitor.
2. Add the following lines:
You must enable JMX to be able to use the BusinessWork process monitoring extension. You also need it to execute the JMX operations which give runtime details statistics.
3. Restart the application to apply your changes. You can use the command line tool bwengine.sh (or .exe) or the TIBCO Admin UI.
NOTE: Redeploying an application will likely overwrite any changes you make to the <application_name>.tra file, including Java Agent settings. In this case the agent is unavailable upon engine restart.
New in 22.214.171.124 and 4.3.1, you can configure the Java Agent to automatically name nodes for the TIBCO process name. Configure the Java Agent as you would normally.
In addition to setting the application-name and tier-name properties for the Java Agent, configure the -Dappdynamics.agent.selfService=tibco system property:
When you deploy your application, the Java Agent names nodes for the TIBCO process name. For example, if the BusinessWorks processes are named "JMSService"1 and "JMSService2", the Java Agent names the nodes "JMSService"1 and "JMSService2".