Education
Abstract
Details of how RPT agents and workbenches interact
Content
Testing on this was done with RPT 10.0 but it applies to earlier versions as well. A key fact to keep in mind is that the only network connections are from the agent to the workbench; the workbench never connects to the agent.
As an example, consider the following majordomo.config:
<MajordomoConfig xmlns="http://www.example.org/MajordomoConfiguration">
<debug>false</debug>
<canonicalHostName></canonicalHostName>
<ipAddress></ipAddress>
<pollInterval>10</pollInterval>
<workbenches>
<hostName>workbench_1</hostName>
<port>7080</port>
</workbenches>
</MajordomoConfig>
An RPT agent with this majordomo.config will periodically poll workbench_1 to check if there are any tests for it to run. It will poll every 10 seconds, the <pollInterval> value. The poll request always contains the agent's "canonicalHostName" and "ipAddress". If, as in the above example, the majordomo.config does not specify a canonicalHostName or ipAddress, the agent will determine the values using Java code like:
InetAddress.getLocalHost().getCanonicalHostName()
InetAddress.getLocalHost().getHostAddress()
If the canonicalHostName and ipAddress fields in majordomo.config are not empty, the agent will send whatever strings are specified (even if they are not actually network names or IP addresses). The Agent Status dialog on workbench_1 will display whatever strings are supplied in the poll request.
FYI: If the majordomo.config ipAddress is modified after the Agent Status dialog has already displayed the system, the Agent Status dialog will not show the modification but instead the originally-reported IP.
When a schedule is run that specifies playing back on a Location, the RPT workbench will get the IP address corresponding to the schedule's location by resolving the "Host Name" specified in the Location. RPT will then compare that IP address to the list of IP's supplied by the agents which have contacted it. When a match is found, that agent will be used to run the test. If a Location's Host Name is a valid IP address, RPT will use that IP address to compare again the list of IP's supplied by the agents.
If a Location's Host Name resolves but there is no agent connecting from that IP address, the RPT workbench will report:
Agent <HostName> not ready, time of last contact: No successful contact
Check Agents Failed
Alternatively, if the Host Name of the location cannot be resolved, the error message is:
Unknown host '<HostName>'
Check Agents Failed
Summarizing the above, to make sure that an agent can be used:
1) Verify that the Agent Status on the workbench is showing the desired host name and IP address for the agent. If it does not, adjust the canonicalHostName or ipAddress in majordomo.config for the agent.
2) On the RPT workbench computer, verify that the Host Name of the location corresponding to the agent resolves to the IP address provided by the agent.
[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSMMM5","label":"IBM Rational Performance Tester"},"Component":"Agents","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"8.6.x thru current (10.0.1)","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]
Was this topic helpful?
Document Information
Modified date:
01 October 2019
UID
ibm11075539