This section provides end-to-end guidance on working with the Cisco Catalyst Center integration.

Prerequisites

Before configuring the integration, ensure your environment meets the following requirements for gateway versions, credentials, and connectivity:

  • Use OpsRamp Classic Gateway (Linux) version 14.0.0 or later.
  • Use OpsRamp NextGen Gateway version 14.0.0 or later.
  • Upgrade to the latest Gateway version to benefit from recent bug fixes and enhancements.
  • Provide Cisco Catalyst Center API credentials with at least read-only privileges to fetch data from the end device.
  • Ensure that the Cisco Catalyst Center IP address or hostname, API port, and credentials are valid and accessible.
    • To verify connectivity from the gateway:
      • Verify network connectivity:
        ping <IP Address/Host Name>
      • Check port accessibility:
        telnet <IP Address/Host Name> <API Port>
      • Validate SSH access with the provided credentials:
        ssh -p <API Port> <username>@<Cisco Catalyst Center IP Address/HostName>

Configure the Cisco Catalyst Center

  1. From All Clients, select a client.
  2. Navigate to Setup > Account.
  3. Select the Integrations tab.
  4. The Installed Integrations page, where all the installed integrations are displayed. Click + ADD on the Installed Integrations page.
  5. If you do not have any installed applications, you will be navigated to the Available Integrations page. The Available Integrations page displays all the available applications along with the newly created application with the version.
    Note: Search for the application using the search option available. Alternatively, use the All Categories option to search.
  6. Click ADD in the Cisco Catalyst Center application.
    Note: Select the version from the drop down menu.
  7. In the Configurations page, click + ADD. The Add Configuration page appears.
  8. Enter the following BASIC INFORMATION:


FunctionalityDescriptionField Type
NameA user-defined display name for the integration instance.String
Cisco Catalyst Center IP Address/HostNameEnter the Cisco Catalyst Center IP Address/HostName. It should be accessible from Gateway.String
API PortEnter the Port. By default 443 is added.Integer
Is SecureSelect this checkbox if you want the communication between your system and the specified endpoint to be secured using protocols such as HTTPS (HTTP over SSL/TLS).
Default Selection: When selected, it signifies that the connection is encrypted, providing an added layer of security to the data being transmitted.		Checkbox
CredentialSelect or create the Credential from the drop-down list. Click +ADD to create credentials. The ADD CREDENTIAL window is displayed. Enter the following information:
  • Name: Enter the credential name.
  • Description: Enter the brief description of the credential.
  • User Name: Enter the Username.
  • Password: Enter the password.
  • Confirm Password: Confirm your password.
  • Port: Select the port number from the dropdown.
  • Connection Timeout (ms): Specify the connection timeout in milliseconds.
Dropdown
App Failure NotificationsWhen selected, you will be notified in case of an application failure such as Connectivity Exception, Authentication Exception.Checkbox
  1. Select the following Custom Attribute:
FunctionalityDescriptionField Type
Custom AttributeSelect the custom attribute from the dropdown list box.Dropdown
ValueSelect the value from the dropdown list box.Dropdown

Note: The custom attribute that you add here will be assigned to all the resources that are created by the integration. You can add a maximum of five custom attributes (key and value pair).

  1. In the RESOURCE TYPE section, select:
    • ALL: All the existing and future resources will be discovered.
    • SELECT: You can select one or multiple resources to be discovered.
  2. In the DISCOVERY SCHEDULE section, select Recurrence Pattern to add one of the following patterns:
    • Minutes
    • Hourly
    • Daily
    • Weekly
    • Monthly
  3. Click ADD.


Now the configuration is saved and displayed on the configurations page after you save it. From the same page, you may Edit and Remove the created configuration.

  1. Under the ADVANCED SETTINGS, Select the Bypass Resource Reconciliation option, if you wish to bypass resource reconciliation when encountering the same resources discovered by multiple applications.

    Note: If two different applications provide identical discovery attributes, two separate resources will be generated with those respective attributes from the individual discoveries.

  2. Click NEXT.

  3. (Optional) Click +ADD to create a new collector by providing a name or use the pre-populated name.

  4. Select an existing registered profile.

  5. Click FINISH.

The application is installed and displayed on the INSTALLED INTEGRATION page. Use the search field to find the installed integration.

Modify the Configuration

View the Cisco Catalyst Center Details

To discover resources for Cisco Catalyst Center

  1. Navigate to Infrastructure > Search > SOFTWARE DEFINED NETWORK > Cisco Catalyst Center.
  2. The Cisco Catalyst Center page is displayed, select the application name.
  3. The RESOURCE DETAILS page appears from the right.
  4. Click the ellipsis (…) on the top right and select View details.
  5. Navigate to the Attributes tab to view the discovery details.


  • Click the MERICS to view the metric details for Cisco Catalyst Center.


  • Click the ATTRIBUTES tab to view the attributes details for Cisco Catalyst Center.