Configuration and Discovery

The following sections describe how to configure and discover Cisco Cloud Services Platform (CSP) clusters for monitoring by SL1 using the Cisco: Cloud Services Platform PowerPack:

Prerequisites for Monitoring CSP Clusters

To configure the SL1 system to monitor CSP clusters using the Cisco: Cloud Services Platform PowerPack, you must have the following information about the clusters that you want to monitor:

Username and password of a user with REST API read access and a role of operator-group or admin-group
SNMP community string with read privileges and the port set to 161

For more information about these requirements, see http://www.cisco.com/c/en/us/td/docs/switches/datacenter/csp_2100/config_guide/b_Cisco_CSP_2100_Config_Guide.html.

Additionally, you must establish a Net-SNMP public community string with the port set to 1610. To do so:

Log in to the command line of the CSP device as an administrative user.
Run the following commands:

netsnmp agent port 1610

netsnmp community public

Creating SNMP Credentials for CSP Clusters

Before you can discover and monitor Cloud Services Platform (CSP) clusters in SL1, you must first create two SNMP credentials (one for port 161 and another for port 1610) in SL1. These credentials, along with a Basic/Snippet credential and SSH/Key credential that you must also create, enable SL1 to collect data from the clusters. Two example SNMP credentials that you can edit for your own use are included in the Cisco: Cloud Services Platform 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).

For more information about the configuration required for the two SNMP credentials, see the Prerequisites section.

To configure the port 161 SNMP credential for CSP:

Go to the Credentials page (Manage > Credentials).

Locate the Cisco: CSP SNMP Port 161 Example credential, click its Actions icon () and select Duplicate. A copy of the credential, called Cisco: CSP SNMP Port 161 Example copy appears.

Click the Actions icon () for the Cisco: CSP SNMP Port 161 Example copy credential and select Edit/Test.The Edit Credential page appears. Enter values in the following fields:

Name. Enter a new name for the 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 What organization manages this service? drop-down field to align the credential with those specific organizations.

SNMP Community (Read Only). Enter the port 161 community string for the CSP cluster.

Use the default values for the other fields on this page.
Click the Save & Close button.

To configure the port 1610 SNMP credential for CSP:

Go to the Credentials page (Manage > Credentials).

Locate the Cisco: CSP SNMP Port 1610 Example credential, click its Actions icon () and select Duplicate. A copy of the credential, called Cisco: CSP SNMP Port 1610 Example copy appears.

Click the Actions icon () for the Cisco: CSP SNMP Port 1610 Example copy credential and select Edit/Test.The Edit Credential page appears. Enter values in the following fields:

Name. Enter a new name for the 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 What organization manages this service? drop-down field to align the credential with those specific organizations.

SNMP Community (Read Only). Enter the port 1610 community string for the CSP cluster.

Use the default values for the other fields on this page.
Click the Save & Close button.

Creating SNMP Credentials for CSP Clusters in the SL1 Classic User Interface

For more information about the configuration required for the two SNMP credentials, see the Prerequisites section.

To configure the port 161 SNMP credential for CSP:

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

Locate the Cisco: CSP SNMP Port 161 Example credential, then click its wrench icon (). The Edit SNMP Credential modal page appears.

Make entries in the following fields:

Profile Name. Enter a new name for the credential.

SNMP Community (Read Only). Enter the port 161 community string for the CSP cluster.

Use the default values for the other fields on this page.
Click the Save As button.
When the confirmation message appears, click OK.

To configure the port 1610 SNMP credential for CSP:

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

Locate the Cisco: CSP SNMP Port 1610 Example credential, then click its wrench icon (). The Edit SNMP Credential modal page appears.

Make entries in the following fields:

Profile Name. Enter a new name for the credential.

SNMP Community (Read Only). Enter the port 1610 community string for the CSP cluster.

Use the default values for the other fields on this page.
Click the Save As button.
When the confirmation message appears, click OK.

Creating a Basic/Snippet Credential for CSP Clusters

Some Dynamic Applications in the Cisco: Cloud Services Platform PowerPack collect data from CSP clusters using the REST API. These Dynamic Applications require a Basic/Snippet credential to enable SL1 to communicate with the cluster. An example Basic/Snippet credential that you can edit for your own use is included in the Cisco: Cloud Services Platform PowerPack.

For more information about the configuration required for the Basic/Snippet credential, see the Prerequisites section.

To create a Basic/Snippet credential to monitor CSP:

Go to the Credentials page (Manage > Credentials).

Locate the Cisco: CSP Example credential, click its Actions icon () and select Duplicate. A copy of the credential, called Cisco: CSP Example copy appears.
Click the Actions icon () for the Cisco: CSP Example copy credential and select Edit/Test.The Edit Credential page appears. Enter values in the following fields:

Name. Enter a new name for the 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 What organization manages this service? drop-down field to align the credential with those specific organizations.

Username. Enter the username for a user with REST API read access to the CSP cluster and a role of operator-group or admin-group.
Password. Enter the password for the REST API user.

Use the default values for the other fields on this page.
Click the Save & Close button.

Creating a Basic/Snippet Credential for CSP Clusters in the SL1 Classic User Interface

For more information about the configuration required for the Basic/Snippet credential, see the Prerequisites section.

To create a Basic/Snippet credential to monitor CSP:

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

Locate the Cisco: CSP Example credential, and then click its wrench icon (). The Edit Basic/Snippet Credential modal page appears.

Enter values in the following fields:

Credential Name. Enter a new name for the credential.

Username. Enter the username for a user with REST API read access to the CSP cluster and a role of operator-group or admin-group.
Password. Enter the password for the REST API user.

Use the default values for the other fields on this page.
Click the Save As button.
When the confirmation message appears, click OK.

Creating an SSH/Key Credential for CSP Clusters

Some Dynamic Applications in the Cisco: Cloud Services Platform PowerPack collect data from CSP clusters from the command line interface instead of the API. These Dynamic Applications require an SSH/Key credential to enable SL1 to communicate with the cluster. An example SSH/Key credential that you can edit for your own use is included in the Cisco: Cloud Services Platform PowerPack.

This functionality utilizes MD5 password encryption. As such, it is not currently available for use in Federal Information Processing Standard (FIPS)-compliant installations of SL1. If you attempt to discover CSP cluster data using an SSH/Key credential in FIPS-compliant installations of SL1, the cluster component device will not be created and an exception error message appears in the system log.

To create an SSH/Key credential to monitor CSP:

Go to the Credentials page (Manage > Credentials).

Locate the Cisco: CSP 2100 CLI Example credential, click its Actions icon () and select Duplicate. A copy of the credential, called Cisco: CSP 2100 CLI Example copy appears.
Click the Actions icon () for the Cisco: CSP 2100 CLI Example copy credential and select Edit/Test.The Edit Credential page appears. Enter values in the following fields:

Name. Type a new name for the 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 What organization manages this service? drop-down field to align the credential with those specific organizations.
Timeout(ms). Keep the default setting.

Hostname/IP. Type the IP address or hostname of the CSP cluster you want to monitor.
Port. Type the SSH port number for the CSP cluster you want to monitor.
Username. Type the username for a user with administrator access to the CSP cluster command line interface.
Password. Type the user's password.
Private Key (PEM Format). Keep this field blank.

The private key can have a maximum of 64 characters per line. Therefore, you cannot use keys in the OpenSSH format, because that format uses 70 characters per line. When you attempt to save the credential, SL1 will validate that the private key entered is in the correct format. You will be able to save the credential only if the private key is correctly formatted.

Click the Save & Close button.

Creating an SSH/Key Credential for CSP Clusters in the SL1 Classic User Interface

To create an SSH/Key credential to monitor CSP:

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

Locate the Cisco: CSP 2100 CLI Example credential, and then click its wrench icon (). The Edit SSH/Key Credential modal page appears.

Enter values in the following fields:

Credential Name. Type a new name for the credential.

Hostname/IP. Type the IP address or hostname of the CSP cluster you want to monitor.
Port. Type the SSH port number for the CSP cluster you want to monitor.
Timeout(ms). Keep the default setting.
Username. Type the username for a user with administrator access to the CSP cluster command line interface.
Password. Type the user's password.
Private Key (PEM Format). Keep this field blank.

Click the Save As button.
When the confirmation message appears, click OK.

Discovering CSP Clusters

When you discover your Cloud Services Platform (CSP) cluster with SL1, SL1 auto-aligns a series of Dynamic Applications to discover, configure, and monitor the CSP cluster and all of its associated component devices.

To discover your CSP cluster, perform the following steps:

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

Click the Unguided Network Discovery button. Additional information about the requirements for discovery appears in the General Information pane to the right.

Click Select. The Add Devices page appears:
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.

Click Next. The Credentials page of the Add Devices wizard appears:

On the Credentials page, locate and select the two SNMP credentials that you created (one for port 161 and the other for port 1610), and the Basic/Snippet credential and the SSH/Key credential for each of the CSP nodes you want to discover.

You must include a minimum of three credentials (one SNMP credential and two Basic/Snippet credentials) for each CSP node with unique credential information.

Click Next. The Discovery Session Details page of the Add Devices wizard appears:

Complete the following fields:

List of IPs/Hostnames. Type the IP address of each CSP node you want to discover.

Which collector will monitor these devices?. Select an existing collector to monitor the discovered devices. Required.
Run after save. Select this option to run this discovery session as soon as you click Save and Close.

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

Discover Non-SNMP. Enable this setting.

Click Save and Close to save the discovery session. The Discovery Sessions page (Devices > Discovery Sessions) displays the new discovery session.
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 CSP Clusters in the SL1 Classic User Interface

To discover your CSP cluster, perform the following steps:

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

Click the Create button. The Discovery Session Editor page appears.

Supply values in the following fields:

IP Address/Hostname Discovery List. Enter the IP address of each CSP node you want to discover.

SNMP Credentials. Select the two SNMP credentials that you created (one for port 161 and the other for port 1610) for each of the CSP nodes you want to discover.
Other Credentials. Select the Basic/Snippet credential and the SSH/Key credential for each of the CSP nodes you want to discover.
Discover Non-SNMP. Select this checkbox.

You must include a minimum of three credentials (one SNMP credential and two Basic/Snippet credentials) for each CSP node with unique credential information.

Optionally, supply values in the other fields in this page. For a description of the fields in this page, see the Discovery and Credentials section.
Click the Save button.
The Discovery Control Panel page will refresh. Click the lightning bolt icon () for the discovery session you created.
In the pop-up window that appears, click the OK button. The Discovery Session page displays the progress of the discovery session.

Viewing CSP Component Devices

When SL1 discovers your CSP cluster, SL1 creates component devices that represent each component in the cluster.

In addition to the Devices page, you can view all associated component devices in the following places in the user interface:

The Device Investigator Map page (click Map in the Device Investigator page) displays a map of a particular device and all of the devices with which it has parent-child relationships. Double-clicking any of the listed devices reloads the page to make the selected device the primary device.

The Device Components page (Devices > Device Components) displays a list of all root devices and component devices discovered by SL1. The Device Components page displays all root devices and component devices in an indented view, so you can easily view the hierarchy and relationships between child devices, parent devices, and root devices. To view the component devices associated with your CSP cluster, find the root device and click its plus icon (+).

The Component Map page (Classic Maps > Device Maps > Components) allows you to view devices by root node and view the relationships between root nodes, parent components, and child components in a map. This makes it easy to visualize and manage root nodes and their components. SL1 automatically updates the Component Map as new component devices are discovered. The platform also updates each map with the latest status and event information. To view the map for your CSP cluster, go to the Component Map page and select the map from the list in the left NavBar. To learn more about the Component Map page, see the section on Maps.

Relationships Between Component Devices

In addition to parent/child relationships between component devices, SL1 also creates relationships between CSP-2100 nodes and Cisco UCS Standalone servers.