Once you have finished Installing the Management Pack (Apache Tomcat) and Configuring the Management Pack (Apache Tomcat), check the Collection State and Collection Status for the adapter instance on the Solutions page. If they show as Not Collecting or No Data Receiving, respectively, the following troubleshooting topics can help you diagnose and correct common problems with your adapter instance.

  • Test Connection Errors
  • Adapter and Collector Log Files

Test Connection Errors

When Creating an Adapter Instance (Apache Tomcat), click Test Connection after entering all of your configuration settings to ensure vROps can connect to the specified host.

The following errors are possible:

No Route to Host

Error Message: Unable to establish a valid connection to the target system. No route to host.

Description: This error usually occurs while attempting to connect a socket to a remote address and port. The remote host may be inaccessible because of a intervening firewall, or if an intermediate router is down.

Unknown Host

Error Message: Unable to establish a valid connection to the target system. Unknown host.

Description: The IP address of the host could not be determined.

Invalid URL

Error Message: Unable to establish a valid connection to the target system. Invalid URL.

Description:This error indicates a problem with the JMX Service URL provided.

Malformed URL

Error Message: Unable to establish a valid connection to the target system. Malformed URL.

Description: Indicates no legal protocol can be found in the specified JMX Service URL, or that it cannot be parsed. Ensure you have completed the following task: Adding an SSL Certificate to the vROps Truststore (Apache Tomcat).

SSL Handshake Error

Error Message: Unable to establish a valid connection to the target system. SSL Handshake error.

Description: Indicates that the client and server could not negotiate the desired level of security.

Connection Refused

Error Message:Unable to establish a valid connection to the target system. Connection refused.

Description:Indicates that the wrong port was specified in your JMX Service URL.

Adapter and Collector Log Files

You can review adapter errors in the adapter and collector log files, which can be viewed in the vROps UI or in an external log viewer.

  • Adapter log files are located in the $VCOPS_BASE/user/log/adapters/TomcatAdapter/ folder.
  • Collector log files are located in the $VCOPS_BASE/user/log/ folder.

To set the base log level for the collector in vROps:

  1. Navigate to Administration > Logs.
  2. Expand the MASTER folder, then select the COLLECTOR folder.
  3. Click the Edit Properties configure_iconicon.
  4. In the Root logger level drop-down menu, select the desired option.
  • The default logging level is warning.
  • To troubleshoot issues, set the logging level to info.
  • To view detailed messages, including micro steps, queries, and returned results, set the logging level to debug.
Note: If you set the logging level to debug, log files can become large very quickly. Set the logging level to debug only for short periods of time.

For more information about viewing log files and modifying levels, refer to the vROps online help.