Enabling the Service Probe Using TIBCO ActiveMatrix Administrator CLI

TIBCO ActiveMatrix Administrator Command-Line Interface (CLI) can help configure or update node JVM properties. You can use Administrator CLI scripts to enable Service Probe and to set TIBCO Service Performance Manager Client properties on TIBCO ActiveMatrix nodes.

Samples scripts can be found in CONFIG_HOME\admin\<enterprise name>\samples\spm.

For more information on Administrator Command-Line interface, refer to the section "Command-Line Interface" in the TIBCO ActiveMatrix Service Grid Administration Guide.

If TIBCO ActiveMatrix administrator is replicated (or running in a replicated setup), enable the TIBCO Service Performance Manager probe on all replicated Administrator instances.

Procedure

  1. Provide the TIBCO_HOME location in the TIBCO_HOME/administrator/<version>/samples/admin-scripts-base file.
  2. Add the remote.properties from TIBCO_HOME/CONFIG_HOME/admin/amxadmin/samples/ to TIBCO_HOME/administrator/<version>/samples/.
  3. Check EMS location in spm_probe.properties file.
  4. On nodes you want to enable the probe, open CONFIG_HOME\admin\<enterprise name>\samples\spm\spm_probe.properties and set the following: 
    set spm_probe=on
  5. Go to CONFIG_HOME\admin\<enterprise name>\samples\spm\spm_probe_data.xml. Update the Environment, Node, and Host names.
  6. Ensure that the correct information is specified in the spm_probe.properties file.
    Note: Ensure that the values of the following properties match the values specified on TIBCO Service Performance Manager:
    • spm_client_jms_jndi_url
    • spm_client_connection_username
    • spm_client_connection_password
    • spm_client_jms_jndi_contextfactory
    • spm_client_schema_name
  7. Ensure that the node is running before you execute these steps:
    1. From TIBCO_HOME/administrator/<version>/samples/spm, run the following command: 
      ant -f spm_probe_build.xml
    2. Restart the affected nodes.
    Note:
    • To enable a service probe on a node, you must disable monitoring services.
    • To receive timely updates from the TIBCO Service Performance Manager server, ensure that the service probe is enabled.