Configuration and Discovery

Download this manual as a PDF file

The following sections describe how to configure and discover Cisco HyperFlex data clusters for monitoring by SL1 using the Cisco: Hyperflex PowerPack:

NOTE: The Cisco: Hyperflex PowerPack supports only HyperFlex API version 4.5 and later.

Prerequisites for Monitoring Cisco HyperFlex

To configure SL1 to monitor Cisco HyperFlex using the Cisco: Hyperflex PowerPack, you must have the following information about the HyperFlex data clusters that you want to monitor:

  • The Hyperflex Cluster Management IP Address
  • SNMP community strings for the voice mailboxes

Creating a SOAP/XML Credential for Cisco HyperFlex

To configure SL1 to monitor Cisco HyperFlex, you must first create a SOAP/XML credential. This credential allows SL1 (specifically, the Dynamic Applications in the Cisco: HyperFlex PowerPack) to connect with HyperFlex devices. An example SOAP/XML credential that you can edit for your own use is included in the Cisco: HyperFlex PowerPack.

NOTE: If you are using an SL1 system prior to version 11.1.0, the new user interface does not include the Duplicate option for sample credential(s). ScienceLogic recommends that you use the classic user interface and the Save As button to create new credentials from sample credentials. This will prevent you from overwriting the sample credential(s).

To configure a SOAP/XML credential to access HyperFlex devices:

  1. Go to the Credentials page (Manage > Credentials).
  2. Locate the "Cisco: HyperFlex - Example" sample credential, click its Actions icon () and select Duplicate. A copy of the credential appears.
  3. Click the Actions icon () for the "Cisco: HyperFlex - Example copy" credential copy and select Edit. The Edit Credential modal page appears:
  4. Enter values in the following fields:

  • Name. Enter a new name for the HyperFlex credential.
  • All Organizations. Toggle on (blue) to align the credential to all organizations, or toggle off (gray) and then select one or more specific organizations from the Select the organizations the credential belongs to drop-down field to align the credential with those specific organizations.
  • Content Encoding. Select text/xml.
  • Method. Select POST.
  • HTTP Version. Select HTTP/1.1.
  • URL. Enter the IP address of your HyperFlex cluster.
  • HTTP Auth User: Use the login credentials for the HyperFlex REST API Explorer:
  • For users with HyperFlex Data Platform 3.0 and prior versions, type "root"
  • For users with Hyperflex Data Platform 3.5 and later versions, type "admin"
  • HTTP Auth Password:
  • For users with HyperFlex Data Platform 3.0 and prior versions, enter the password for "root"
  • For users with HyperFlex Data Platform 3.5 and later versions, enter the HyperFlex administrator user's password
  • Proxy Hostname/IP. Leave this field blank.
  • Proxy Port. Keep the default value.
  • Proxy User. Enter the SSH username for the HyperFlex device(s).
  • Proxy Password. Enter the SSH password for the HyperFlex device(s).
  1. Click Save & Close.

Creating a SOAP/XML Credential for Cisco HyperFlex in the SL1 Classic User Interface

To configure SL1 to monitor Cisco HyperFlex, you must first create a SOAP/XML credential. This credential allows SL1 (specifically, the Dynamic Applications in the Cisco: HyperFlex PowerPack) to connect with HyperFlex devices. An example SOAP/XML credential that you can edit for your own use is included in the Cisco: HyperFlex PowerPack.

To configure a SOAP/XML credential to access HyperFlex devices:

  1. Go to the Credential Management page (System > Manage > Credentials).

  1. Locate the sample credential included in the Cisco: HyperFlex PowerPack, called Cisco: HyperFlex - Example, then click its wrench icon ().

  1. Enter values in the following fields:

Basic Settings

  • Profile Name. Enter a new name for the HyperFlex credential.

  • Content Encoding. Select text/xml.
  • Method. Select POST.
  • HTTP Version. Select HTTP/1.1.
  • URL. Enter the IP address of your HyperFlex cluster.
  • HTTP Auth User: Use the login credentials for the HyperFlex REST API Explorer:
  • For users with HyperFlex Data Platform 3.0 and prior versions, type "root"
  • For users with Hyperflex Data Platform 3.5 and later versions, type "admin"
  • HTTP Auth Password:
  • For users with HyperFlex Data Platform 3.0 and prior versions, enter the password for "root"
  • For users with HyperFlex Data Platform 3.5 and later versions, enter the HyperFlex administrator user's password

Proxy Settings

  • Hostname/IP. Leave this field blank.

  • Port. Keep the default value.
  • User. Enter the SSH username for the HyperFlex device(s).
  • Password. Enter the SSH password for the HyperFlex device(s).
  1. Click Save As.
  2. In the confirmation message, click OK.

Discovering Cisco HyperFlex Devices

To create and run a discovery session that will discover Cisco HyperFlex devices, perform the following steps:

  1. On the Devices page () or the Discovery Sessions page (Devices > Discovery Sessions), click the Add Devices button. The Select page appears:

Image of the Add Devices wizard, page 1

  1. Click the Unguided Network Discovery button. Additional information about the requirements for discovery appears in the General Information pane to the right.
  1. Click Select. The Add Devices page appears.
  2. Complete the following fields:
  • Name. Type a unique name for this discovery session. This name is displayed in the list of discovery sessions on the Discovery Sessions tab.
  • Description. Optional. Type a short description of the discovery session. You can use the text in this description to search for the discovery session on the Discovery Sessions tab.
  • Select the organization to add discovered devices to. Select the name of the organization to which you want to add the discovered devices
  1. Click Next. The Credentials page of the Add Devices wizard appears:

Image of the Add Devices wizard, page 2

  1. On the Credentials page, select the SOAP/XML credential that you created for Cisco HyperFlex.
  1. Click Next. The Discovery Session Details page of the Add Devices wizard appears:

Image of the Add Devices wizard, page 2

  1. Complete the following fields:
  • List of IPs/Hostnames. Type the IP address(es) for the Cisco HyperFlex device(s) you want to discover.
  • Which collector will monitor these devices?. Required. Select an existing collector to monitor the discovered devices.
  • Run after save. Select this option to run this discovery session as soon as you save the session.

In the Advanced options section, click the down arrow icon () to complete the following fields:

  • Discover Non-SNMP. Enable this setting.
  1. Click Save and Run if you enabled the Run after save setting, or Save and Close to save the discovery session. The Discovery Sessions page (Devices > Discovery Sessions) displays the new discovery session.
  2. If you selected the Run after save option on this page, the discovery session runs, and the Discovery Logs page displays any relevant log messages. If the discovery session locates and adds any devices, the Discovery Logs page includes a link to the Device Investigator page for the discovered device.

Discovering Cisco HyperFlex Devices in the SL1 Classic User Interface

To create and run a discovery session that will discover Cisco HyperFlex devices, perform the following steps:

  1. Go to the Discovery Control Panel page (System > Manage > Classic Discovery).

  1. Click the Create button to create a new discovery session. The Discovery Session Editor page appears.

  1. Enter values in the following fields:
  • IP Address Discovery List. Enter the IP address(es) for the Cisco HyperFlex device(s) you want to discover.

  1. You can enter values in the other fields on this page, but are not required to and can simply accept the default values. For more information about the other fields on this page, see the section on Defining an SNMP Credential.
  2. Click Save and then close the Discovery Session Editor window.
  3. The discovery session you created appears at the top of the Discovery Control Panel page. Click its lightning bolt icon () to run the discovery session.
  4. The Discovery Session window appears.
  5. When the Cisco HyperFlex data cluster is discovered, click its device icon () to view its Device Properties page.

Troubleshooting Known Issues

The following known issues affect version 103 of the Cisco: Hyperflex PowerPack:

  • The "Cisco: Hyperflex Service Configuration" Dynamic Application will stop collecting data when the "/rest/services" endpoint is deprecated.
  • In SL1 version 8.10.0, the following Minor events are displayed for the "Cisco: Hyperflex Resiliency Stats" Dynamic Application:

78:StorageProc1: Non-digits in oid with object id: 18882, did:4 in dynamic app:1625 when updating performance value (val:NA)

78:StorageProc1: Non-digits in oid with object id: 18876, did:4 in dynamic app:1625 when updating performance value (val:NA)