Troubleshooting Passive Agents

Because passive agents must wait for a request from the JavaTest harness before running tests, the port that the passive agent uses must be the same as that used by the JavaTest harness to send requests.

Errors in configuring, synchronizing, or implementing the connection between the agent and the JavaTest harness are the most probable causes of failure.

Use the Agent Monitor window, the JavaTest harness Test Manager window, the agent GUI, and the following list of actions as a guide when troubleshooting problems running passive agents:

  1. Verify that the agent was started before the JavaTest harness started the test run. If not, repeat the test run.
  2. Verify that the port value used when starting the agent matches the port value used by the JavaTest harness to send requests.
  3. Check the physical connection between the JavaTest harness platform and the test platform.
  4. Use the Configuration Editor in the Test Manager window to verify that the harness is configured to use agents when running tests. See the JavaTest Harness User's Guide: Graphical User Interface for detailed description of the Configuration Editor and the Test Manager window.
  5. If you are running the tests using multiple Java Virtual Machines, use the Configuration Editor window to verify that the path you provided in the Java Launcher question is the path of the launcher for the agent running tests.
  6. If tests are failing or have errors, check the error messages displayed in the Test Manager window. If the error indicates that tests are failing because of missing classes, perform the following actions:
    1. Verify that the class paths used to start the agent are correct.
    2. Use the Configuration Editor window to verify that the harness is correctly configured to use the agent on the test system.
    3. Run the agent using the -trace option to verify that the paths in the stream messages for the test are correct. If the paths are not correct for the test system, create a map file for the agent to use in translating host-specific values into values that the agent can use.
    4. If a map file was used to run the test, use the Test Run Messages pane to verify that the -mapArgs command is present in the stream messages. If the the -mapArgs command is not present, verify that both the agent and the harness are configured to use the map file. Use the Configuration Editor window to verify that the harness is configured to use the agent map file.