Discovery

The following sections describe how to discover ancillary Cisco Unified Communications devices for monitoring by SL1 using the "Cisco: UC Ancillary" PowerPack:

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 ().

Discovering Ancillary Cisco UC Devices

To create and run a discovery session that will discover ancillary Cisco UC devices, 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. In the Discovery Control Panel, click Create.
3. The Discovery Session Editor page appears. In the Discovery Session Editor page, define values in the following fields:

• IP Address/Hostname Discovery List. Type the IP addresses for the devices you want to discover.
• SNMP Credentials. Select the SNMP credential you created for the ancillary devices.
• Other Credentials. Select the SSH/Key credential you created for the ancillary devices.
• Discover Non-SNMP. Select this checkbox.
• Model Devices. Select this checkbox.

4. 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.
5. Click Save to save the discovery session, and then close the Discovery Session Editor window.
6. 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.
7. The Discovery Session window appears. When the ancillary devices are discovered, click the device icon () to view the Device Properties page for each device.

Discovering Cisco UC AncillaryComponent Devices

To create and run a discovery session that will discover a Cisco UC Ancillary appliance:

1. Go to the Devices page () or the Discovery Session page (Devices > Discovery Sessions) and click the Add Devices button.
2. Click the Unguided Network Discovery Workflow button. Additional information about that requirements for discovery appears in the General Information pane to the right.



3. Click Select. The Add Devices page appears.
4. Complete the following fields:

• Discovery Session Name. Type a unique name for this discovery session. This name is displayed in the list of discovery sessions on the Discovery Session tab.
• Description.Optional. Type a short description of the discovery session. You can use the test in this description to search for the discovery session on the Discovery Session tab.
• Select the organization to add discovered devices to. Select the name of the organization to which you want to add the discovered devices.

5. Click Next. The Credentials page of the Add Devices wizard appears.
6. On the Credentials page, locate and select the SSH/Key credential you created for Cisco UC Ancillary appliances.
7. Click Next. The Discovery Sessionpage of the Add Devices wizard appears.
8. Complete the following fields:

• List of IP/Hostnames. Type the IP address for the Cisco UC Ancillary appliance.
• 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.
• Advanced options. Click the down arrow () to complete the following fields:
  • Discover Non-SNMP. Enable this setting.
  • Model Devices. Enable this setting.
  • Select Device Template. If you configured a Cisco UC Ancillary device template, select it here. Otherwise, leave the default selection.

9. If you enabled the Run after save option, click the Save and Run button. The discovery session will run and the Discovery Logs page will display any relevant log messages. If the discovery session locates and adds any devices, the Discovery Logs page will include a link to the Device Investigator page for the discovered device.
10. If you did not enable the Run after save option, click the Save and Close button. The Discovery Session page (Devices > Discovery Sessions) will display the new discovery session.

 

Manually Aligning Dynamic Applications

When you run the discovery session for ancillary UC devices, SL1 automatically aligns the necessary Dynamic Applications to the devices.

To verify that the Dynamic Applications aligned to the devices correctly:

1. After discovery has completed, click the device icon () for any of the discovered devices. The Device Properties page appears.
2. From the Device Properties page, click the Collections tab. The Dynamic Application Collections page appears.
3. All applicable Dynamic Applications for the device are automatically aligned during discovery.

   It can take several minutes after the discovery session has completed for Dynamic Applications to appear in the Dynamic Application Collections page.

If the "Cisco: Dial Peer Voice Summary" or "Cisco: Active Voice Call Legs Performance" Dynamic Applications did not automatically align to a voice device, you might need to manually align the SSH/Key credential to the physical router running the Cube feature set and then run discovery again.

To manually align the SSH/Key credential to the router:

1. Go to the Device Manager page (Devices > Classic Devices, or Registry > Devices > Device Manager in the classic SL1 user interface).
2. Locate the physical router running the Cube feature set and click its wrench icon (). The Device Properties page appears.
3. Select the SSH/Key credential you created for ancillary UC devices.

   If there are other credentials (for example, an SNMP credential) already aligned to the device, hold the <Ctrl> or <Command> key when selecting the SSH/Key credential to keep the other credentials aligned to the device as well.

4. Click Save.
5. Close the Device Properties page and go to the Discovery Control Panel page (System > Manage > Classic Discovery or System > Manage > Discovery in the classic user interface).
6. Locate the discovery session for ancillary UC devices and click its lightning bolt icon () to re-run the discovery session.

If any of the other Dynamic Applications did not automatically align to a device during discovery, you can align them manually to the device.

To manually align a Dynamic Application to a device:

1. From the Dynamic Application Collections page (Registry > Devices > wrench icon > Collections), click the Action button and then select Add Dynamic Application. The Dynamic Application Alignment page appears.
2. In the Dynamic Applications field, select the Dynamic Application you want to align.
3. In the Credentials field, select one or more of the credentials you created for the ancillary UC devices.
4. Click Save.
5. Repeat steps 1-4 for any other unaligned Dynamic Applications.

Viewing Ancillary Cisco UC Devices

When SL1 discovers your ancillary UC devices, SL1 creates component devices that represent each component in your ancillary UC system.

In addition to the Device Manager page, you can view component devices in the following places in the user interface:

• The Device View modal page (click the bar-graph icon [] for a device, and then click the Topology tab) displays a map of the selected device and all of the devices with which it has parent-child relationships. Double-clicking any of the devices reloads the page with the selected device as 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 your ancillary UC devices, find a device cluster 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 ancillary UC devices, go to the Component Map page and select a map from the list in the left NavBar. To learn more about the Component Map page, see the section on Views.