Once you have finished Installing the Management Pack (Cisco UCS) and Configuring the Management Pack (Cisco UCS), 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

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

The following errors are possible:

Invalid Hostname/IP Address

Error Message: Unable to establish a valid connection to the target system. java.net.UnknownHostException: <hostname/IP address>: Name or service not known.

Description: Ensure the correct hostname or IP address was entered when adding the adapter instance. Note that the Management Pack supports both IPv4 and IPv6.

Cannot Connect to Hostname/IP Address

Error Message: Unable to establish a valid connection to the target system. Unable to successfully find an enabled SSL protocol to use...Host response empty or did not contain cookie.

Description: This error indicates that a valid hostname/IP address was entered, but the response from the host is not asking for credentials or cannot be interpreted by the Management Pack.

Wrong Port

Error Message: Unable to establish a valid connection to the target system. Unable to successfully find an enabled SSL protocol to use...Host response empty or did not contain cookie.

Description:Same error type as Cannot Connect to Hostname/IP Address above, but can also indicate that the port number entered may be valid, but is not on the desired system.

Invalid Port

Error Message: Unable to establish a valid connection to the target system. 'Port' is invalid.

Description: Ensure the correct port was entered when adding the adapter instance. This error indicates a non-integer value was entered, or the maximum string length was exceeded.

UCS Authentication Failure

Error Message: Unable to establish a valid connection to the target system. Unable to successfully find an enabled SSL protocol to use...incorrect User Name or Password.

Description: Ensure your UCS Central or UCS Manager user name and password are correct. 

Note: If using both UCS Central and Manager, the user names and passwords for each must match.

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/CiscoUcsAdapter/ 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.
Caution: 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.