Skip to main content

Creating a New Discovery Instance

About This Task

Access to the target integration device is required for discovery to occur.

After you configure and subscribe to the integration instance, IPM adjusts the appropriate Wisdom Pack license count to reflect additional license consumption.

Prerequisites

To perform this task, the user must meet the following requirements:

  • Ensure that all items identified in Installation Prerequisites have been met.

  • Have the following information available for integration configuration. These are needed so IPM can connect to and collect metrics from the target integration device:

    Warning

    This integration does not support device connection through a proxy.

    The following fields apply to all devices:

    • Name - A name which identifies this configuration from other configurations of the same type.

    • Poll Interval - The interval (in minutes) at which data is collected from the target devices.

    • Monitoring Level - Determines if all devices in this configuration should poll for metrics and entity changes, just entity changes, or do nothing.

    The following fields apply to each device entry:

    • Nexus Hostname/IP - The fully qualified domain name or IP address of the Nexus switch

    • Authentication Type

      User can specify values from the dropdown list :

      NX-API

      SNMP v2c

      Telemetry

      SNMP v3 Auth Privacy

      SNMP v3 Auth No Privacy

      SNMP v3 No Auth No Privacy

    • NX-API Port - The port number used to connect to the NX-API.

    • Use HTTPS - If checked, use HTTPS instead of HTTP when communicating with the NX-API manager. *

    • Verify HTTPS - If checked, use HTTPS instead of HTTP when communicating with the Nexus. *

    • Certificate File - The certificate file used to validate HTTPS connection with Nexus. *

      • Self-signed certificates can be automatically fetched from the target device using these fields:

        • Nexus Hostname/IP

        • NX-API Port

      gRPC Port default value is 5997. User should specify the port value configured as per Cisco Switch

    • SNMP Timeout (Sec) *

    • SNMP Community - The SNMP community string to use when connecting to the Nexus switch. *

    • SNMP Max Timeouts - The maximum timeout when connecting via SNMP to the Nexus switch. *

    • SNMP Privacy Protocol *

    • SNMP Auth Protocol *

    • NX-API Username - The username to use when connecting to the NX-API. *

    • NX-API Password - The password to use (for the specified username) when connecting to the NX-API. *

    • SNMP User Name - The SNMP username to use when connecting to the Nexus switch. *

    • SNMP Auth Password - The SNMP password to use (for the specified username) when connecting to the Nexus switch via SNMP v3 *

    • SNMP Privacy Password *

    • SNMP Context Name *

    • Licensing Status - Identifies the current licensing status of this configuration, which is determined after first publish.

    * Required Field

  • If you intend to use credential sets when configuring devices, the credential sets must already have been created.

Steps

  1. From the Settings page, click Integrations in the Probes and Integrations section.

    image15.png
  2. Click View for the licensed integration you want to configure.

    • If this is an initial configuration: You are directed to the New Integration page to configure the first integration.

    • If there are existing configurations: The Integration page opens, displaying a list of all existing licensed and unlicensed configurations.

  3. Click New.

    scrn-vwi-generic-integ-list-new.png

    The New Integration page displays.

  4. Enter a Name for the configuration and click Next.

    Each configuration must have a unique name, to avoid save errors. If you are using more than one IPM integration, it is recommended that a naming convention be used to ensure unique configuration names for each integration.

    vwi-scrn-integ-config-new-name.png

    A second configuration page displays.

    vwi-scrn-pure1-config.png

    Note: Each integration has slightly different configuration pages. Shown above is a generic representation of a New Integration page.

  5. Select a Poll Interval.

    When selecting the poll interval, note that metric collection automatically begins when the first poll interval is reached.

  6. Select a Monitoring Level: Discovery and Metric Collection (the default), Discovery Only, or Disabled. For new configurations, the default is the best choice. More information about each choice follows.

    • Discovery and Metric Collection (default) - for each polling interval, discovery and metrics will be collected, and licenses will be consumed.

    • Discovery Only - for each polling interval, discovery and metrics will be collected, but the metric data will be discarded. Licenses will not be consumed. Please note that this option will not lead to less load on the target system(s).

    • Disabled - all communication with the target system(s) will cease and licenses will not be consumed.

  7. In the Devices area, add the configurations.

    • To add one configuration at a time, click Add.

      You must select a credential set or enter a name/IP address, username, and password.

    • To add multiple configurations at one time, click Import, select a CSV file to upload, and then select how the file content should impact existing records.

      You can Replace, Merge, or Add records.

      Warning

      If you select Replace, the entire contents currently in the table are deleted and replaced. This deletion cannot be undone.

      See Using a CSV File for Configuration for details about using a configuration file.

  8. Complete the device connection details and then click Save.

  9. Click Save on the Configuration page.

    If properly configured, the hosts are subscribed when the first metrics data is collected, based on the polling interval. You can verify subscription from the Integration page, that lists integration configuration instances.

Next Steps

Optional: Create credential sets and assign to devices