Installing the TIBCO Rendezvous monitoring extension

This section describes how to install the TIBCO Rendezvous monitoring extension on various platforms, and includes:

Best practice
When reinstalling or upgrading, make sure you first backup the existing files (such as qptibrv.bat and qptibrv.conf on Windows). See also Backing-up-before-an-upgrade-or-reinstall.

Related topics

Running-performance-and-availability-monitoring-extensions

Running-the-TIBCO-Rendezvous-monitoring-extension

Running-application-transaction-tracing-transaction-monitoring-extensions

Uninstalling-TMTM-performance-and-availability-monitoring-extensions

Installing the TIBCO Rendezvous monitoring extension on Windows 

Before you begin

Check that any software requirements, described in Minimum-hardware-and-software-requirements, are satisfied.

To install the TIBCO Rendezvous monitoring extension on Windows

  1. At a command prompt, change to the directory where the TMTM Agents and Extensions are installed.
  2. Unzip the contents of the pkg_*_qptibrv.zip package, as appropriate for your platform, to a sub-directory of the TMTM Agents and Extensions (e.g. into a directory named qptibrv).
  3. If you are using the provided Java Runtime Environment (JRE), proceed to Step 4.

    If you need to use a different JRE, for example where the provided JRE is no longer current and BMC is not able to provide updates, ensure that JAVA_HOME is set in your environment. See also Defining-alternative-JREs-for-Java-extensions. Note that on Windows the qptibrv.bat and qptibrv.conf files will require editing to change the JRE location to be used, unless you want to use the system JAVA_HOME setting.

  4. Reinstalling or upgrading: refer to your backup copies of any configuration (.props) files, or the Windows .bat file and .conf files you may have previously customized. Merge any changes as required.
  5. At a command prompt, enter qpea --status to ensure that the TMTM Extensible Agent is running. If it is not running, enter qpea --start.

  6. From a command prompt, use the qptibrv --register command to register the TIBCO Rendezvous objects you want to monitor. See Running-the-TIBCO-Rendezvous-monitoring-extension for all of the available options for the --register parameter. 

    At minimum, your command is:

    qptibrv --register -rvd:service:network:daemon -http:URL:port:user:password

    Note

    If you want to interactively configure the monitoring extension, use the --registration option instead. It prompts you for the required information and leads you through a series of questions to configure the monitoring extension.

  7. Edit qptibrv.bat to set the location of the TIBCO Rendezvous installation if necessary. The default location is: C:\tibco\tibrv.
  8. If the system environment variable TIBRV_HOME is not configured on your system, edit the qptibrv.conf file and uncomment and set TIBRV_HOME to point to the TIBCO Rendezvous installation directory. See the list below.

    #*****************************************************
    Wrapper Properties
    #*****************************************************
    # If not already set in your system environment set the
    # TIBRV_HOME environment variable to point to your TIBCO RV
    # installation directory and uncomment the following line.
    # set.TIBRV_HOME=C:\TIBCO\TIBRV
  9. Set the TMTM Topic Service host name and port. Enter qptibrv --config -host:host -port:port

    where:
    host is the host name or the IP address.
    port is the port on the host for the TMTM Topic Service. Omit the port clause to set the port to the default number 15001.
  10. (Optional) The sample interval defaults to 60 seconds. If you want to change the sample interval you can set it by opening framework.props in a text editor and changing the line:

    com.bmc.mmpa.eaapi.framework.waitstate.SampleInterval=60
    This sets the sample interval to 60 seconds, the default.
  11. Change to the directory where you extracted the TIBCO Rendezvous monitoring extension files.
  12. (Optional) Set the logging level by opening and modifying the qplog.props file. Your options are off, debug, info, warn, error, and fatal. Info and warn can be used every day, but debug contains a large amount of data and might not be useful for continual logging. The other options should only be used as directed by BMC Support.
  13. Enter qptibrv --install to install the TIBCO Rendezvous monitoring extension as a Windows service.
  14. Enter qptibrv --start.

Where to go from here

Installing the TIBCO Rendezvous monitoring extension on UNIX

Before you begin

See Supported-middleware-monitoring-technologies-for-performance-and-availability to verify the intended monitored technology is supported and that all footnote prerequisites are satisfied.

To install the TIBCO Rendezvous monitoring extension on UNIX

  1. At a command prompt, change to the directory where the TMTM agents and extensions are installed.
  2. Unzip the contents of the pkg_*_qptibrv.zip package, as appropriate for your platform, to a sub-directory of the TMTM Agents and Extensions (e.g. into a directory named qptibrv).
  3. If you are using the provided Java Runtime Environment (JRE), proceed to Step 4.

    If you need to use a different JRE, for example where the provided JRE is no longer current and BMC is not able to provide updates, ensure that JAVA_HOME is set in your environment. See also Defining-alternative-JREs-for-Java-extensions. 

    After installing 8-1-00-Agent-Fix-Pack-E, QPTIBRV_JAVA_HOME is used if set, then JAVA_HOME if set. If neither is set, on platforms where a JRE is included in the package that default JRE will be used.

  4. Reinstalling or upgrading: refer to your backup copies of any configuration files you may have previously customized. Merge any changes as required.
  5. At a command prompt, enter qpea --status to ensure that the TMTM Extensible Agent is running. If it is not running, enter qpea --start.
  6. Change to the directory where you extracted the TIBCO Rendezvous monitoring extension files.
  7. Edit qptibrv.sh to set the location of the TIBCO Rendezvous installation if necessary. The default location is: /usr/tibco/tibrv/lib.
  8. Set the TMTM Topic Service host name and port. Enter qptibrv.sh --config -host:name -port:number

    where:
    host is the host name or the IP address.
    port is the port on the host for the TMTM Topic Service. Omit the port clause to set the port to the default number 15001.
  9. (Optional) The sample interval defaults to 60 seconds. If you want to change the sample interval you can set it by opening framework.props in a text editor and changing the line:

    com.bmc.mmpa.eaapi.framework.waitstate.SampleInterval=60
    This sets the sample interval to 60 seconds, the default.

  10. From a command prompt, use the qptibrv.sh --register command to register the TIBCO Rendezvous objects you want to monitor with the TIBCO Rendezvous Monitoring Extension. See Controlling the TIBCO Rendezvous monitoring extension on Windows or UNIX platforms for all of the available options for the --register parameter. At minimum, the command is:

    qptibrv.sh --register -rvd:service:network:daemon -http:URL:port:user:password

    Note

    If you want to interactively configure the monitoring extension, use the --registration option instead. It prompts you for the required information and leads you through a series of questions to configure the monitoring extension.

  11. (Optional) Set the logging level by opening and modifying the qplog.props file. Your options are off, debug, info, warn, error, and fatal. Info and warn can be used every day, but debug contains a large amount of data and might not be useful for continual logging. The other options should only be used as directed by BMC Support.
  12. To start the TIBCO Rendezvous Monitoring Extension, enter qptibrv.sh --start.

Where to go from here

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*