Configuring Cisco ACI Multi-Site Manager for Monitoring

Download this manual as a PDF file

The following sections describe how to configure and discover Cisco ACI Multi-Site Manager for monitoring by SL1 using the "Cisco: ACI Multi-Site Manager" PowerPack:

Prerequisites

Before you can monitor Cisco ACI Multi-Site Manager in SL1, you must do the following:

  • Your Data Collector must have API access to the Cisco ACI Multi-Site Manager Orchestrator
  • The API user needs permissions for "auth", "get token", and "poll" for metrics

Creating a Credential for Cisco ACI Multi-Site Manager

To configure SL1 to monitor Cisco ACI Multi-Site architecture, you must first create a SOAP/XML credential. This credential allows the Dynamic Applications in the "Cisco: ACI Multi-Site Manager" PowerPack to communicate with your Cisco ACI Multi-Site account.

The PowerPack includes an example SOAP/XML credential that you can edit for your own use.

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:

  1. Go to the Credentials page (Manage > Credentials).
  2. Locate the Cisco: ACI MM Sample Credential credential, click its Actions icon () and select Duplicate. A copy of the credential appears.

  1. Click the Actions icon () for the "Cisco: ACI MM Sample Credential copy" credential and select Edit. The Edit Credential page appears:

  1. 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 Select the organizations the credential belongs to drop-down field to align the credential with those specific organizations.
  • URL. Specify the IP of the Cisco ACI Multi-Site web interface
  • HTTP Auth User. Enter the username for the Cisco ACI Multi-Site web interface
  • HTTP Auth Password. Enter the password for the Cisco ACI Multi-Site web interface
  1. Click the Save & Close button.

Creating a Credential for Cisco ACI Multi-Site Manager in the SL1 Classic User Interface

To configure SL1 to monitor Cisco ACI Multi-Site architecture, you must first create a SOAP/XML credential. This credential allows the Dynamic Applications in the "Cisco: ACI Multi-Site Manager" PowerPack to communicate with your Cisco ACI Multi-Site account.

The PowerPack includes an example SOAP/XML credential that you can edit for your own use.

To configure a SOAP/XML credential:

  1. Go to the Credential Management page (System > Manage > Credentials).
  2. Locate the Cisco: ACI MM Sample Credential credential, then click its wrench icon (). The Edit SOAP/XML Credential modal page appears.

  1. Enter values in the following fields:

Basic Settings

  • HTTP Auth User. Enter the username for the Cisco ACI Multi-Site web interface
  • HTTP Auth Password. Enter the password for the Cisco ACI Multi-Site web interface
  • URL. Specify the IP of the Cisco ACI Multi-Site web interface
  1. Click the Save As button.

Creating a Cisco ACI Multi-Site Manager Virtual Device and Discovering Cisco ACI Multi-Site

To discover a Cisco ACI Multi-Site architecture, you must create a virtual device that represents the root device. A virtual device is a user-defined container that represents a device or service that cannot be discovered by SL1. You can use the virtual device to store information gathered by policies or Dynamic Applications.

If you have multiple Cisco ACI Multi-Site architecture you want to monitor, you should create a separate virtual device for each root device. You can also create different organizations for each architecture.

To create a virtual device that represents your Cisco ACI Multi-Site architecture:

  1. Go to the Device Manager page (Devices > Classic Devices, or Registry > Devices > Device Manager in the classic SL1 user interface).
  2. Click the Actions button and select Create Virtual Device from the menu. The Create Virtual Device modal page appears.

  1. Enter values in the following fields:
  • Device Name. Enter a name for the device. For example, you could enter "ACI Multi-Site" in this field.

  • Organization. Select the organization for this device. The organization you associate with the device limits the users that will be able to view and edit the device. Typically, only members of the organization will be able to view and edit the device.
  • Device Class. Select Cisco Systems | ACI Multi-Site Manager Cluster.
  • Collector. Select CUG.
  1. Click the Add button to create the virtual device.
  2. Once you have created the device, go to the Device Manager page (Devices > Classic Devices, or Registry > Devices > Device Manager in the classic SL1 user interface) and select the virtual device you created.
  3. In the Select Action menu, select MODIFY By Template and click Go.
  4. In the Device Template Editor window, select the Dyn Apps tab.
  5. Click the plus sign in the Subtemplate Selection pane.
  6. In the Dynamic Application Settings pane, select the "Cisco: ACI Multi-Site Manager Node Discovery" Dynamic Application.
  7. In the Credentials drop-down, select the "Cisco: ACI MM Sample Credential". Click Apply.

Once you have completed modifying the device template, discovery will run and the Dynamic Applications will be aligned.

Verifying Discovery and Dynamic Application Alignment

To verify that SL1 has automatically aligned the correct Dynamic Applications during discovery:

  • After creating the virtual device and aligning the credential to the template, go to the Devices page and click on the ACI Multi-Site virtual device. From the Device Investigator page, click the Collections tab.
  • All applicable Dynamic Applications for the switch are automatically aligned during discovery and will appear in the Collections tab.

You should see the following Dynamic Applications aligned to the ACI Multi-Site virtual device:

  • Cisco: ACI Multi-Site Manager Component Counts
  • Cisco: ACI Multi-Site Manager Node Discovery
  • Cisco: ACI Multi-Site Manager Site Discovery
  • Cisco: ACI Multi-Site Manager Tenant Discovery
  • Cisco: ACI Multi-Site Manager Token

The following Dynamic Applications will automatically align to their corresponding device components:

  • Cisco: ACI Multi-Site Manager Node Configuration
  • Cisco: ACI Multi-Site Manager Site Config
  • Cisco: ACI Multi-Site Manager Site Performance
  • Cisco: ACI Multi-Site Manager Tenant Config

Verifying Discovery and Dynamic Application Alignment in the SL1 Classic User Interface

To verify that SL1 has automatically aligned the correct Dynamic Applications during discovery:

  • After creating the virtual device and aligning the credential to the template, go to the Device Manager page and click the wrench icon () for the ACI Multi-Site virtual device. From the Device Properties page, click the Collections tab. The Dynamic Application Collections page appears.
  • All applicable Dynamic Applications for the switch are automatically aligned during discovery.

You should see the following Dynamic Applications aligned to the ACI Multi-Site virtual device:

  • Cisco: ACI Multi-Site Manager Component Counts
  • Cisco: ACI Multi-Site Manager Node Discovery
  • Cisco: ACI Multi-Site Manager Site Discovery
  • Cisco: ACI Multi-Site Manager Tenant Discovery
  • Cisco: ACI Multi-Site Manager Token

The following Dynamic Applications will automatically align to their correspondent device components:

  • Cisco: ACI Multi-Site Manager Node Configuration
  • Cisco: ACI Multi-Site Manager Site Config
  • Cisco: ACI Multi-Site Manager Site Performance
  • Cisco: ACI Multi-Site Manager Tenant Config

Viewing Component Devices

In addition to the Devices page, you can view the Cisco ACI Multi-Site Manager and 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 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 a Cisco ACI Multi-Site Manager, find the virtual 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 a Cisco ACI Multi-Site Manager device, 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.