Configuration and Discovery

Download this manual as a PDF file

Use the following menu options to navigate the SL1 user interface:

  • To view a pop-out list of menu options, click the menu icon ().
  • To view a page containing all of the menu options, click the Advanced menu icon ().

The following sections describe how to configure and discover Cisco UCS Director devices for monitoring by SL1 using the "Cisco: UCS Director" PowerPack:

Copying the REST API Access Key for a UCS Director Account

When configuring the Basic/Snippet credential that SL1 uses to discover and monitor UCS Director, you must include the REST API Access Key for a UCS Director administrator user account as the credential password.

To locate and copy the REST API Access Key:

  1. Log in to UCS Director as an administrator, and then click the username at the top of the page.

  1. The User Information modal page appears. Click the Advanced tab.

  1. Click the Copy Key Value button to copy the REST API Access Key.

Configuring a UCS Director Credential

To configure SL1 to monitor UCS Director, you must first create a Basic/Snippet credential. This credential allows the Dynamic Applications in the "Cisco: UCS Director" PowerPack to connect with a UCS Director server. An example Basic/Snippet credential that you can edit for your own use is included in the "Cisco: UCS Director" PowerPack.

To create a Basic/Snippet credential:

  1. Go to the Credentials page (Manage > Credentials).
  2. Locate the "UCS Director - Example" credential, then click its Actions icon () and select Duplicate from the drop-down field. The "UCS Director - Example copy" credential appears.
  3. Click the Action icon () for the "UCS Director - Example copy" credential, then select Edit. The Edit Credential page appears.

    4. Edit Basic/Snippet credential for Cisco UCS Director

  4. Enter values in the following fields:
  • Name. Enter a new name for the credential. This field is required.
  • 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.
  • Timeout. Enter the time, in milliseconds, after which SL1 will stop trying to communicate with the UCS Director device. The default value is 60000. This field is required.
  • Hostname/IP. Type "http://%D:22"
  • Port. Type "80".
  • Username. Keep the default.
  • Password. Enter the REST API Access Key that you located inthe section Copying the REST API Access Key for a UCS Director Account.
  1. Click Save & Close.

Configuring a UCS Director Credential in the SL1 Classic User Interface

To configure SL1 to monitor UCS Director in the classic user interface, you must first create a Basic/Snippet credential. This credential allows the Dynamic Applications in the "Cisco: UCS Director" PowerPack to connect with a UCS Director server. An example Basic/Snippet credential that you can edit for your own use is included in the "Cisco: UCS Director" PowerPack.

To create a Basic/Snippet credential to access a UCS Director server in the classic user interface:

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

  1. Locate the "UCS Director - Example" credential, then click its wrench icon (). The Edit Basic/Snippet Credential modal page appears.

  1. Enter values in the following fields:
  • Credential Name. Enter a new name for the UCS Director credential.

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

Discovering UCS Director

To model and monitor your Cisco UCS Director devices, you must run a discovery session to discover the UCS Director component devices that SL1 will use as the root devices for monitoring the applications.

After the discovery session completes, the Dynamic Applications in the "Cisco: UCS Director" PowerPack automatically align to the component device, and then the PowerPack discovers, models, and monitors the remaining Cisco UCS Director devices.

To discover the devices that you want to monitor:

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

    2. Unguided Discovery for Cisco UCS Director

  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:

    2. Cisco UCS Director Credential Selection for Unguided Discovery

  2. On the Credentials page, select the SNMP credential and the Basic/Snippet credential you created.
  3. Click Next. The Discovery Session Details page of the Add Devices wizard appears:
  4. Unguided Discovery session details for Cisco UCS Director
  5. Complete the following fields:
  • List of IPs/Hostnames. Type the IP address or hostname for the set of Cisco Meeting Server devices that you want to monitor.
  • 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.
  • Model Devices. 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.

Discovery UCS Director Devices in the SL1 Classic User Interface

To create and run a discovery session in the SL1 classic user interface that will discover UCS Director, perform the following steps:

  1. Go to the Discovery Control Panel page (System > Manage > Classic Discovery or System > Manage > Discovery in the classic user interface).
  2. Click the Create button to create a new discovery session. The Discovery Session Editor window appears.
  3. Edit the following fields in the Discovery Session Editor window:
  1. Optionally, you can enter values in the other fields on this page. For more information about the other fields on this page, see the Discovery & Credentials section.
  2. Click the Save button 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. When UCS Director is discovered, click its device icon () to view the Device Properties page for the UCS Director server.

Viewing UCS Director Component Devices

In addition to the Device Manager page (Devices > Classic Devices, or Registry > Devices > Device Manager in the classic SL1 user interface), you can view UCS Director component devices in the following places in the user interface:

  • The Device View modal 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 devices listed 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 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 UCS Director, find the UCS Director 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 UCS Director, 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 Views.