This section provides an example of instrumentation process.
To instrument an application using the provided sample
Deploy the agent.
Start the TMTM Extensible Agent.
On the TMTM Services, import the provided sample:
mqsimport -p BMCSOFTWARE --profile ".*" APISamples.zip SA.
Change host and platform on activity implementations for samples you wish to try.
Generate a model.
Deploy the model.
Deploy development toolkits.
Build the sample:
Java: build.bat on Windows or build.sh on UNIX
jee: build.bat on Windows or build.sh on UNIX
jmx: build.bat on Windows or build.sh on UNIX
Deploy runtime toolkits:
java: Goes in btmsamples/java
jmx: Java EE Runtime goes in btmsamples/jee
For jmx you need to enable JMX monitoring for the JRE of the application. In the simplest case edit the management properties file that can be found in the JRE lib/management directory to include the following properties:
Note that this enables unauthenticated access to the JMX agent. Review the management properties file and ensure that the settings you use comply with your sites security policy.
For both jee and jmx, you must start the Java EE Service toolkit. Unzip pkg_<platform>_btmjee.zip located in the agent distribution where required and then edit the btmjee.xml for your connection properties. For the jmx sample, uncomment the connection properties for Java. For the jee sample, uncomment BEA or IBM for whichever application server you are using.
btmjee --console or btmjee --start
Run sample and other steps per sample (ex. start btmjee):
Java: run.bat on Windows or run.sh on UNIX
jee: Deploy JavaEEBTMSampleServlet.ear to Application Server. Go to http://localhost/JavaEEBTMSampleServlet/JavaEEBTMAPISample.html