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, VirtualWisdom 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 VirtualWisdom can connect to and collect metrics from the target integration device:

    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.

    • Pure1 Application ID - If you are using Pure1, the Application ID provided by the Pure1 registration process.

    • Pure1 Private Key File - If you are using Pure1, the decrypted private key generated for the Pure1 API registration.

    • Pure1 Public Key File - If you are using Pure1, the public key generated for the Pure1 API registration.

    • 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:

    • Pure Server Hostname/IP - The fully qualified domain name or IP address of the Pure server.

    • Port Number - The port number used to connect to the Pure server.

    • Username - The username to use when connecting to the Pure server.

    • Password - The password to use (for the specified username) when connecting to the Pure server.

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

Note

Please refer to the Pure1 Requirements and Configuration topic for information on how to obtain the Pure1-related items.

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 VirtualWisdom 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

    Important

    For the item labeled Pure1 Private Key File, you'll need to use the decrypted private key file you created per the Pure1 Requirements and Configuration instructions.

  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