Viewing running agents

Depending on the version of IBM® Rational® Test Control Panel that you are using, you have different options for viewing IBM Rational Integration Tester agents that are currently running.

About this task

IBM Rational Integration Tester Agent engines execute stubs that have been published to Rational Test Control Panel. A Rational Integration Tester Agent engine must be installed on each computer where you want to run stubs and there must be at least one Rational Integration Tester Agent engine in an environment. Each Rational Integration Tester Agent engine must register with a Rational Test Control Panel instance so that it can accept requests to run stubs.

Java™ virtualization agents enable you to intercept and record Java method calls from Java applications. You can run multiple Java virtualization agents and you can specify an instance name for each agent to disambiguate them. Each Java virtualization agent must register with a Rational Test Control Panel instance so that you can monitor it.

If you are using a version of Rational Test Control Panel earlier than 8.5.1.1, you can do the following:

View all Rational Integration Tester agents that are registered with the current Rational Test Control Panel instance and that are currently running.
View all Rational Integration Tester agents running for a specific domain or environment.

If you are using Rational Test Control Panel 8.5.1.1 or later, you can do the following:

View all Rational Integration Tester agents running for a specific domain.
View all Rational Integration Tester agents running for a specific environment.

Procedure

Log into Rational Test Control Panel.
The Rational Test Control Panel application window is displayed.
To view all Rational Integration Tester agents that are registered with the current Rational Test Control Panel instance and that are currently running or to view all Rational Integration Tester agents running for a specific domain, complete the following tasks:
1. Click the Agents icon or navigation link.
  The Agents page is displayed.
  
  If you are using a version of Rational Test Control Panel earlier than 8.5.1.1, any Rational Integration Tester agents registered with the current Rational Test Control Panel instance that are currently running are displayed.
  
  If you are using Rational Test Control Panel 8.5.1.1 or later, any Rational Integration Tester agents registered with the current domain that are currently running are displayed.
  
  Details displayed include IP address, port number, domain and environment, software version number, configuration file location, current status, and date and time of last poll.
  
  If you are using Rational Test Control Panel 8.0.1 or later, the agent type is also displayed. For example, RPTS for IBM Rational Performance Test Server, or RTVS for IBM Rational Test Virtualization Server, or Unknown if the agent cannot be determined.
  
  Note: A Rational Integration Tester Agent engine can be registered with only one Rational Test Control Panel instance at any given time.
  
  Note: A Rational Integration Tester Java virtualization agent is displayed only if the Java application into which the agent is installed is running.
  In Rational Test Control Panel 8.0.1 or later:
  - When Rational Test Virtualization Server, Rational Performance Test Server, or probe agents disconnect, they remain in the Disconnected state until they are removed manually from the Agents page. They can be removed individually by using the X button () on the right of each row or by using the Remove all disconnected engines button on the button bar at the top of the Agents page. In contrast, HTTP, TCP, and other proxy agents remove themselves from the Agents page automatically after a minute of being in the Warning state.
  - If a Rational Test Virtualization Server, Rational Performance Test Server, or probe agent reconnects without changing its configuration (even after a restart), its status will be changed to OK. That is, a new row will not be created on the Agents page and the old row on the Agents page will be reused. However, if the configuration of a Rational Test Virtualization Server, Rational Performance Test Server, or probe agent has been changed before restarting, a new row will be created on the Agents page and the old row will remain visible on the Agents page with the status of Disconnected.
  Note: If you are using version 8.6.0 or later of Rational Test Control Panel and IBM Rational Integration Tester Agent or IBM Rational Integration Tester Platform Pack, you have the option to configure an instance name for each Rational Integration Tester agent that is registered with Rational Test Control Panel. Assigning a name makes it easier to identify a specific agent when there are two or more agents of the same type registered with Rational Test Control Panel. Configuring an instance name involves uncommenting and editing the identifier name setting in the configuration file of the agent and then restarting the agent.
2. Click the magnifying glass button () of the relevant engine.
  The Agent deployed projects and stubs pop-up window is displayed on the Agents page.
  
  Details about the selected agent are displayed in the pop-up window, including the IP address of the computer where the agent is deployed.
  
  Note: If you are using Rational Test Control Panel 8.6.0 or later, clicking the magnifying glass button also highlights the selected agent.
  
  Clicking Show all rules or Show rules splits the Agents page and displays recording rules that have been set up from the Recording Studio of Rational Integration Tester.
  Note: If you are using a version of Rational Test Control Panel earlier than 8.5.1.1, Show all rules is displayed. If you are using Rational Test Control Panel 8.5.1.1 or later, Show rules is displayed.
  
  For example, if a Java virtualization agent is running and you start a recording session in Recording Studio that includes that agent as a resource, the recording and routing rules of that agent are displayed on the Agents page when you click Show all rules or Show rules.
3. Click Close to close the Agent deployed projects and stubs pop-up window.
To view all Rational Integration Tester agents running for a specific environment, complete the following tasks:
1. Click the Environments icon or navigation link.
  The Environments page is displayed.
2. Click the relevant domain and environment and then click View Dashboard.
  The Environments Dashboard page is displayed.
3. Click Show Agents.
  The lower half of the Environments Dashboard page displays a pop-up window for each agent for the selected domain and environment combination that is running.
  Note: Agent console output is not viewable in Rational Test Control Panel, so you must view the console output of an agent on the computer where it is running.

Feedback