Troubleshooting stubs
Problem | Resolution |
---|---|
The stub is producing this error message in its console output. [CRRIT1717E] The socket associated with the request message is no longer available. | This error is produced when a Send Reply action is unable to communicate with the client system that issued the request message. The most likely cause is that the client already received a reply from another Send Reply action within the stub and its connection is closed. This situation can occur when you have multiple events in the same HTTP stub that processes the same messages. If you have filtering configured that allows more than one event to reply to the same message, only one of them succeeds. The second Send Reply action fails with this error as the client is disconnected. Check your filtering configuration to prevent multiple matches in different events. Consider redesigning the stub to have a single event for these messages. Duplicate the event for each message type and configure filtering. |
The stub is not logging events. | In the Environments dashboard for IBM® Rational® Test Control Panel (or
in Rational
Integration Tester), verify that the stub has been configured to
Log. Alternatively, if localhost has been configured as the logging URL, logging will not work if the stub is run on a different agent. |
Unable to configure routing to the stub | When starting a stub in Rational
Integration Tester,
you might see the following error on the console:
This error might also appear in the Rational Integration Tester Agent log file. The problem occurs when you create two stubs with the same transport and operation and try to run both at the same time. The solution is to only run one at a time. You should be able to delete one of the stubs. |
The stub running on the agent cannot connect to the results database. | Ensure that the computer running the stub and the computer running Rational Test Control Panel have the required network connectivity to access the project results database. |
The required database driver is missing. | If you are using a MySQL driver, ensure that it has been installed
correctly. If you are using a non-standard JDBC driver, ensure that it is included in the CLASSPATH of the computer where Rational Test Control Panel is installed. |
The traffic is not being routed to the stub. |
|
The proxy or intercept for the transport is not routing the traffic to the stub. | When you start stubs, they wait for the external proxies to retrieve the routing configuration rules from the server before they can complete the initialization process and start the main steps. Hence, when you run test suites that use stubs, the tests will not start until the proxies have received their configuration rules. When there is a problem, verify the
following things:
A sample for the stub console output that indicates that the
configuration rule has not reached the external proxy in the allotted time is as
follows:
In this example, only a single proxy is registered with IBM Rational Test Control Panel. Either the proxy process stopped and its registration did not time out yet or the proxy could not connect to IBM Rational Test Control Panel, and hence the proxy rules could not be applied in the allotted time. If no proxies are registered with IBM Rational Test Control Panel, you
will see the following messages in the stub console output:
For
more troubleshooting tips, see Troubleshooting the HTTP/TCP proxy. |
Publishing stubs from Rational Integration Tester to Rational Test Control Panel fails with error Error: 507 (Insufficient Storage). | Free up some space in the disk used by Rational Test Control Panel.
To know which location is being used, look in the container.server.properties file
for the workingDirectory property. The default
location of the container.server.properties file
is:
|
The TCP port number configured in the stub is already in use. | Use the netstat command to
see which port numbers are in use by which processes. If client programs
are accessing the stub by using the TCP/HTTP proxy you can ignore
this warning message. The Proxy will correctly route messages to the
stub even if it using a temporary port number. If, however, you must
run the stub on a fixed port, use the diagnosis results to take any
of the following actions:
|
Stub cannot be opened in the Stub Editor. | You have created a stub from an operation that
is a Subscribe action. The stub has the opposite messaging action
which is a Publish. This type of stub cannot be edited in the Stub
Editor. You must edit it using the Test Editor, which is normally
used for editing test sequences. When a stub is created, its messaging actions will be the reverse of the operation in order to simulate the server end of communication. For example, a Send Request/Receive Reply operation gives a stub of the form Receive Request/Send Reply. This type of stub has a Message Switch action and by default is edited in the Stub Editor. You can choose to edit it in the Test Editor by right-clicking the object in the Test Factory tree and selecting . This option is not recommended for more complex stubs.For a subscribe operation, the stub action is a publish. This cannot be edited in the Stub Editor because it expects an input message. Editing this type of stub will launch the Test Editor and you will see the Publish test action. |