Home
Rational® Integration Tester
Tester Guide
This guide describes the tasks that you can perform for testing various domains, technologies, and applications. To enable testing, you must configure and enable the environment for testing.
Technical Tester Guide
Typically, a user with the Integration Tester role is also responsible for performance testing. This guide lists all such topics.
Deploying probes
A Rational® Integration Tester probe measures variables from a particular component in the system and reports back its findings for processing and storage.
TIBCO Rendezvous trace probe
The TIBCO Rendezvous Trace (RVTRACE) probe uses the TIBCO program rvtrace to monitor networks and capture Rendezvous daemon (RVD) subject statistics.
Using the rvtrace program
You can set the rvtrace program to listen for SNMP connections from the TIBCO Rendezvous Trace probe.
Running rvtrace

Rational® Integration Tester
- Release Notes
  This document contains information about What's new, installation, known issues, and contact information of IBM Support.
- System Requirements
  This document includes information about hardware and software requirements for IBM® Rational® Integration Tester.
- Getting Started
  This guide provides an overview and describes the tasks to get you started with Rational® Integration Tester.
- Administrator Guide
  This guide describes how to install Rational® Integration Tester. After you install the software, you can perform administration tasks such as configuration and integration of the product. This guide is intended for administrators.
- Tester Guide
  This guide describes the tasks that you can perform for testing various domains, technologies, and applications. To enable testing, you must configure and enable the environment for testing.
  - Integration Tester Guide
    This guide describes the tasks that you can perform for testing various domains, technologies, and applications. To enable testing, you must configure and enable the environment for testing. This guide is intended for Integration testers.
  - Technical Tester Guide
    Typically, a user with the Integration Tester role is also responsible for performance testing. This guide lists all such topics.
    - Creating and running performance tests
      This topic describes how to create, configure, and run performance tests.
    - View test results
      This topic describes how to work with IBM® Rational® Performance Test Server charts in the Results Gallery perspective.
    - Deploying probes
      A Rational® Integration Tester probe measures variables from a particular component in the system and reports back its findings for processing and storage.
      - System statistics probe
        The System Statistics (Systat) probe runs on Windows™ or Linux™ and captures key system statistics for the target host.
      - Windows™ performance monitor probe
        The Windows™ Performance Monitor probe captures the same statistics for the target host as those available through the Performance Monitor (perfmon.msc) on Windows systems.
      - TIBCO BusinessWorks probe
        The TIBCO BusinessWorks (BW) probe accesses the TIBCO Hawk microagents within BusinessWorks to collects execution statistics from running BusinessWorks processes.
      - TIBCO Rendezvous probe
        The TIBCO Rendezvous (RV) probe captures Rendezvous daemon (RVD) status messages that contain messaging and error rates.
      - TIBCO Rendezvous distributed queues probe
        The TIBCO Rendezvous Distributed Queues (RVDQ) probe uses Rendezvous daemon (RVD) transports to collect RV Distributed Queue statistics.
      - TIBCO Rendezvous trace probe
        The TIBCO Rendezvous Trace (RVTRACE) probe uses the TIBCO program rvtrace to monitor networks and capture Rendezvous daemon (RVD) subject statistics.
        Configuring the TIBCO Rendezvous Trace probe
        How to configure the TIBCO RVD probe.
        Using the rvtrace program
        You can set the rvtrace program to listen for SNMP connections from the TIBCO Rendezvous Trace probe.
        Running rvtrace
      - TIBCO EMS probe
      - webMethods Broker probe
        The webMethods Broker probe collects statistics for webMethods brokers, event types, clients, and client groups.
      - webMethods Integration Server probe
        The webMethods Integration Server probe collects statistics for the server and for specific webMethods services.
      - Handling probe errors
  - Integration Tester Guide (Service Virtualization)
    This guide describes the tasks that you can perform for using virtual services or stubs to simulate parts of an environment if the real services are not yet available or because they are difficult or expensive to use. This guide is intended for Integration Testers.
- Test Manager Guide
  This guide describes the tasks that you can perform for tracking the quality of the application. This guide is intended for Test Managers.
- Troubleshooting
  While working with Rational® Integration Tester, you might encounter some problems that you can easily troubleshoot.
- Reference Guide
  This guide provides the topics to help the Integration tester use the product by using the user interface, commands or scripts. This guide is intended for Integration testers.
- Security Considerations
  You can take certain actions to ensure that your installation is secure, customize your security settings, and set up user access controls.
- Notices
  This document provides information about copyright, trademarks, terms and conditions for product documentation.

Running `rvtrace`

When you run rvtrace on Windows™, you must install WinPcap, which is included in the IBM® Rational® Performance Test Server installation program. For more information, see Rational Performance Test Server overview.

The WinPcap software installs DLL files that rvtrace requires to capture RVD messages. You also need to ensure that the network interface that is used is the correct one (specified with the -i command-line option). If you do not use the correct interface, rvtrace cannot collect any data. You can find network device names in the Windows™ registry or you can run WinDump, which is the Windows™ version of tcpdump, the command-line network analyzer for Unix-like systems. (WinDump can be downloaded from the WinPcap website.)

For example, if you run a command of the following format:


windump -D

The output might look similar to the following:


1.\Device\NPF_GenericDialupAdapter (Generic dialup adapter)
2.\Device\NPF_{AC533C74-32A4-44AD-8675-5A16D50D0170} (3Com EtherLink PCI)

You can use this information when you run the rvtrace command.

For example:


rvtrace -i \Device\NPF_{AC533C74-32A4-44AD-8675-5A16D50D0170} -u 60 -snmp -no-display

Unix-like systems

When you run rvtrace on Unix-like systems, no other software is required. However, rvtrace must be able to open the network port in promiscuous mode, which requires super user permissions.

Typically, the rvtrace program has "set user to root" enabled. If this is true, it can be run as a normal user. (Contact your system administrator if you need assistance or to verify this.)

You must configure rvtrace to monitor the correct network port. A list of network interfaces can be displayed by running ifconfig.

For example:


host% /sbin/ifconfig -a
lo0: flags=1000849<UP,LOOPBACK,RUNNING,MULTICAST,IPv4> mtu 8232 index 1 inet 127.0.0.1 netmask ff000000
hme0: flags=1000843<UP,BROADCAST,RUNNING,MULTICAST,IPv4> mtu 1500 index 2 inet 192.168.111.8 netmask ffffff00 broadcast 192.168.111.255

In this case, the hme0 interface is used when you run the rvtrace command:


rvtrace -i hme0 -u 60 -snmp -no-display