Configuring the environment for TIBCO Designer and BusinessWorks

Before you begin

• Some TrueSight Middleware and Transaction Monitor (TMTM) BTM JAR files must be available to the TIBCO Designer and TIBCO BusinessWorks runtime environments. These should be added to the bwengine.tra and designer.tra files within the TIBCO home directory.
• The following classes must be available to the BusinessWorks engine before the business processes are started. TMTM uses a JMX MBean within the platform MBean Server and the BTM classes must be on the system classloader classpath.

Deploy the BTM toolkits

The TMTM BTM JAR files must be deployed from the TMTM Monitor Console.

1. Select the BTM API for Java using JMX Development Toolkit and deploy the toolkit to the local file system. This section assumes that location is: c:\bmtm\btm
2. Select the BTM API for Java using JMX Runtime Toolkit and deploy the toolkit to the local file system. This section assumes that location is: c:\bmtm\btm
3. Extract the BTM jar files from the deployed toolkits.

The BTM Jar files are used throughout the following steps.

To configure the environment for TIBCO Designer

You can monitor activities when they are run within the TIBCO Designer tester. This can be useful for developing and verifying the monitoring pathways before deploying them.

The following steps are optional. They only apply to testing in TIBCO Designer, and do not impact the monitoring of deployed applications.

1. Enable JMX monitoring in TIBCO Designer by following the steps in Enabling JMX monitoring; apply the changes to the Designers .tra file (e.g. C:\tibco\designer\5.10\bin\designer.tra).
   
   Note that the jmx port number must be an available, unique port number.
2. Modify the tibco.env.CUSTOM_CP_EXT property in the .tra file to add the fully qualified path name of the BTM JAR file btmmbean.jar.
   
   tibco.env.CUSTOM_CP_EXT <EXISTING ENTRIES>;c:/bmtm/btm/btmmbean.jar
3. Restart TIBCO Designer after making these changes.
   
   The BTM JMX Agent can now be configured to attach to the TIBCO Designer, letting you monitor processes as they run in the test environment.