Home
Troubleshooting
While working with HCL DevOps Test Integrations and APIs (Test Integrations and APIs), you might encounter some problems that you can easily troubleshoot.
Locating the logging properties files
When you install Test Integrations and APIs, Test Integrations and APIs Agent, or Test Virtualization Control Panel including the HTTP/TCP proxy, several logging properties files are added to each installation's home directory.

Troubleshooting
While working with HCL DevOps Test Integrations and APIs (Test Integrations and APIs), you might encounter some problems that you can easily troubleshoot.
- Troubleshooting: Installation and configuration
  You can troubleshoot some of the problems that you might encounter when you are installing, configuring, or running HCL DevOps Test Integrations and APIs (Test Integrations and APIs).
- Global problem notifications
  Problems can occur at a time when Test Integrations and APIs cannot display an error message. Instead, a warning icon is displayed. Double-clicking the icon reveals a list of errors.
- Working with DevOps Test Integrations and APIs logs
  To configure the HCL DevOps Test Integrations and APIs (Test Integrations and APIs) logs, including those for the RunTest command when run from the command line, update the Test Integrations and APIs logging properties file.
- Working with DevOps Test Integrations and APIs Agent logs
  To configure the HCL DevOps Test Integrations and APIs Agent (Test Integrations and APIs Agent) logs, including those for the RunTests command when run from the command line, update the Test Integrations and APIs Agent logging properties file.
- Working with RQMAgent logs
  To configure the RQMAgent logs, update the RQMAgent logging properties file.
- Locating the logging properties files
  When you install Test Integrations and APIs, Test Integrations and APIs Agent, or Test Virtualization Control Panel including the HTTP/TCP proxy, several logging properties files are added to each installation's home directory.
- Logging references
  You can use the following list of logging-related information to help you find information about the logs that are supported by Test Integrations and APIs. All of the programs use the Java logging framework. For details, see the Java logging framework documentation.
- Debugging failed Windows™ services
  If one of the programs fails to start as a Windows™ service, it can be difficult to determine the cause. Typically the service fails to start but gives no indication of why. The Windows Event log has nothing useful and the process might not have created its log file.
- Troubleshooting: Installation and configuration
  You can troubleshoot some of the problems that you might encounter when you are installing, configuring, or running HCL DevOps Test Integrations and APIs (Test Integrations and APIs).
- Troubleshooting: transports, tests, and resources
  Workarounds and solutions for transport diagnostics, creating and running tests, and saving and renaming objects are contained in this topic.
- Troubleshooting: DevOps Test Integrations and APIs Agent
  You can use workarounds to common problems that you might encounter when you install and run the HCL DevOps Test Integrations and APIs Agent (Test Integrations and APIs Agent).
- Troubleshooting: DevOps Test Virtualization Control Panel
  You can use workarounds to troubleshoot common problems that you might encounter when you use HCL DevOps Test Virtualization Control Panel (Test Virtualization Control Panel).
- Troubleshooting: DevOps Test Virtualization
  You can use workarounds to common problems that you might encounter when you use HCL DevOps Test Virtualization (Test Virtualization).
- Troubleshooting: Software AG webMethods
  You can use workarounds to problems that you might encounter when you use the Software AG webMethods.
- Troubleshooting: Websphere MQ
  You can use workarounds to problems that you might encounter when you use IBM® WebSphere® MQ with HCL DevOps Test Integrations and APIs (Test Integrations and APIs).
- Troubleshooting: WebSphere® Application Server
  You can use workarounds to problems that you might encounter when you use IBM® WebSphere® Application Server products with HCL DevOps Test Integrations and APIs (Test Integrations and APIs).
- Troubleshooting: WebSphere® Portal
  You can use workarounds to problems that you might encounter when you use IBM® WebSphere® Portal products with HCL DevOps Test Integrations and APIs (Test Integrations and APIs).
- Troubleshooting: TIBCO
  You can use workarounds to common problems that you might encounter when you are testing TIBCO products in HCL DevOps Test Integrations and APIs (Test Integrations and APIs).
- Troubleshooting: Java™ method transport
  You can use workarounds to common problems that you might encounter when you use the Java™ method transport of HCL DevOps Test Integrations and APIs (Test Integrations and APIs).
- Troubleshooting: Java™ applications that use JDBC
  You can use workarounds to problems that you might encounter when you test Java™ applications in HCL DevOps Test Integrations and APIs (Test Integrations and APIs).
- Troubleshooting: HTTP and Web Services
  You can use workarounds to common problems that you might encounter when you use HTTP and Web Services.
- Troubleshooting: TCP UDP sockets
  You can use workarounds to common problems that you might encounter when you use TCP and UDP transports.
- Troubleshooting: Testing on IBM® z/OS®
  You can use workarounds to common problems that you might encounter when you use IBM® z/OS® with HCL DevOps Test Integrations and APIs (Test Integrations and APIs).

Locating the logging properties files

When you install Test Integrations and APIs, Test Integrations and APIs Agent, or Test Virtualization Control Panel including the HTTP/TCP proxy, several logging properties files are added to each installation's home directory.

Test Integrations and APIs

You can find it-logging.properties in the home installation directory of Test Integrations and APIs. Test Integrations and APIs uses this file to control logging in the following scenarios:

When you run tests from the Test Integrations and APIs GUI.
When you run tests by using RunTests from the command line.
When you start Test Integrations and APIs from the command line with the -console option.

Test Virtualization Control Panel and the HTTP/TCP Proxy

The proxy-logging.properties file is located at the httptcp folder under the Test Virtualization Control Panel home installation directory. This file controls the logging for the HTTP/TCP proxy. There is no console to view the logs for the proxy, but you can run the proxy from the command line if needed, and use console logging to view the log messages in the command window.

Test Integrations and APIs Agent

The agent-logging.properties and it-logging.properties files are located at the home installation directory of Test Integrations and APIs Agent. The agent-logging.properties file controls the logging for both the agent process and any engine processes it starts, and the it-logging.properties file controls the logging for tests that are run by using RunTests from the agent command line.

RQMAgent

The RQMAgent provided by Test Integrations and APIs uses the rqmagent-logging.properties file to control logging for tests started from Rational® Quality Manager. This file is located at the home installation directory of Test Integrations and APIs.