Configuring the SPM Agent for ActiveMatrix BusinessWorks 5.x

Several configurations are needed to enable the monitoring of ActiveMatrix BusinessWorks 5.x assets.

1. Create the SPM database schema for ActiveMatrix BusinessWorks 5.x as follows:
   1. Copy the BW_5_11_Schema.xml file from the <SPM_HOME>\smbw-agent\config folder to <SPM_HOME>/config.
   2. Generate the database scripts using the DDL generator for the above schema and create tables in database. See the section 'Generating Service Performance Manager Database Schema' in TIBCO® Service Performance Manager Installation and Configuration .
   3. Start SPM Server.
   4. Start the database.
   5. Start SPM Dashboard.
2. For each ActiveMatrix BusinessWorks application that you want to monitor, you must update the corresponding TRA file and set the following properties.
   1. Navigate to <TRA_HOME>/domain/<domain_name>/applications/<application> and set the following properties:
      • tibco.env.EMS_HOME=<installation path for TIBCO Enterprise Message Service 6.0 or above>
      • tibco.env.SMBW_HOME=<SPM_HOME>/smbw-agent
      • tibco.env.CUSTOM_EXT_APPEND_CP=<EMS_HOME>/lib%PSP%SMBW_HOME/lib
      • java.property.aspectPath=<SMBW_HOME>/lib
      • tibco.env.STD_EXT_CP=<SMBW_HOME>/lib;<SMBW_HOME>/lib/bwaa;<SMBW_HOME>/lib/ext;<SMBW_HOME>/lib/spm;<EMS_HOME>/lib
      • ServiceAgent.builtinResource.serviceagent.Class=com.tibco.plugin.brp.BRPServiceAgent
      • ServiceAgent.probe.serviceagent.Class=com.tibco.rta.probe.bw.core.SPMServiceAgent
      • ServiceAgent.poa.serviceagent.Class=com.tibco.bw5.poa.core.runtime.DefaultBw5AspectServiceAgentImpl
      • spm.probe.config.dir=<SMBW_HOME>/config
   2. Restart the ActiveMatrix BusinessWorks application from TIBCO Administrator.
3. Navigate to the <SPM_HOME>/smbw-agent/config directory and update the admin config file - bw-admin-probe.properties as follows:
   • spm.bw.probe.hawk.domain : Change to the appropriate TIBCO Hawk® domain where the BW engines to be monitored through TIBCO Administrator reside.
   • spm.bw.probe.hawk.rv.service: RV service (Refer RV parameters)
   • spm.bw.probe.hawk.rv.network : RV network (Refer RV parameters).
   • spm.bw.probe.hawk.rv.daemon : RV daemon (Refer RV parameters).
   • rta.client.jms.jndi.url : Client JNDI URL for EMS, to which the SPM server is connected.
4. Navigate to <SMBW_HOME>/bin and enable the SPM agent.
   1. Open the start-admin-probe.bat or start-admin-probe.sh file and set the following properties:
      • tibco.env.RV_HOME=<installation path for TIBCO Rendezvous 8.x or above>
      • tibco.env.HAWK_HOME=<installation path for TIBCO Hawk 4.9 or above>
      • tibco.env.EMS_HOME=<installation path for TIBCO Enterprise Message Service 6.0 or above>
   2. Start start-admin-probe.bat (for Windows) or start-admin-probe.sh (for UNIX).