Configure Shazzam probe parameters and payload size

When you run Discovery, the Shazzam probe finds your active network devices by scanning specified ports on specified IP ranges. If the list of IP ranges being scanned is very large, you can configure the Shazzam payload for JSON encoding to reduce its size address ranges.

Before you begin

Role required: admin

About this task

You control the behavior of individual Shazzam probes using basic and advanced parameters.

For instructions on configuring probe parameters, see Set probe parameters.

Procedure

  1. Navigate to Discovery Definition > Probes.
  2. Select Shazzam.
  3. Add or edit parameters in the Probe Parameters related list.
  4. Configure the basic Shazzam parameter.
    These parameters are defined in the config.xml file on the MID Server, but you can edit the values in the Shazzam probe record as well. Changes to specific parameters that could disconnect you from the MID Server are prohibited in the probe record and can only be made in the configuration file.
    Table 1. Basic Shazzam parameters
    Parameter Description
    shazzam_chunk_size Maximum number of IP addresses Shazzam will scan in parallel. This parameter primarily controls outbound port consumption.

    Default: 100

    regulator_max_packets Sets the number of packets that Shazzam can launch in the time interval specified by the regulator_period_ms parameter.

    Default: 1

    regulator_period_ms Sets the interval, in milliseconds, in which Shazzam can launch packets.

    Default: 1

  5. Configure the advanced Shazzam parameters.
    These parameters are available for fine tuning the Shazzam probe. These values are defined in the probe record only.
    Table 2. Shazzam advanced parameters
    Parameter Description
    report_inactive When true, reports device that are alive but inactive. For example, a device has no ports open but refuses at least one port connection request.

    Default: true

    shazzam_report_dead When true, reports devices with dead IP addresses. For example, a device that has all ports closed.

    Default: false

    GenericTCP_waitForConnectMS Sets the number of milliseconds the GenericTCP scanner waits for a connection.

    Default: 1000

    BannerTCP_waitForConnectMS Sets the number of milliseconds the BannerTCP scanner waits for a connection and banner.

    Default: 1500

    HTTP_waitForConnectMS Sets the number of milliseconds the HTTP scanner waits for a connection.

    Default: 500

    HTTP_waitForResponseMS Sets the number of milliseconds the HTTP scanner waits for a response.

    Default: 500

    NBT_waitForResponseMS Sets the number of milliseconds the NBT scanner waits for a response.

    Default: 500

    NBT_alternativePort Defines an alternative port number for the NBT scanner.

    Default: N/A

    SNMP_taps Sets the number of taps (requests) the SNMP scanner attempts.

    Default: 2

    SNMP_tapIntervalMS Sets the number of milliseconds the SNMP scanner waits between taps.

    Default: 1000

    SNMP_waitForResponseMS Sets the number of milliseconds the SNMP scanner waits for a response after the last tap.

    Default: 1000

    SNMP_alternativePort Defines the alternative port number for the SNMP scanner.

    Default: N/A

    DNS_waitForResponseMS Sets the number of milliseconds the DNS scanner waits for a response.

    Default: 1000

    DNS_alternativePort Sets an alternative port number for the DNS scanner.

    Default: N/A

    debug Enables debug logging if set to true.

    Default: false

    scanner_log Enables scanner logging if set to true. This logging information appears in the Shazzam probe response.

    Default: false

Control Shazzam payload size

A system property in the Kingston Patch 6 release converts Shazzam payloads into JSON strings, which dramatically reduces their size. This setting prevents nodes from running out of memory when a single schedule discovers large numbers of IP ranges.

Before you begin

Role required: admin

About this task

The glide.discovery.shazzam_ranges_json property is set to true for new instances at Patch 6. This configuration encodes the payload as a JSON string. The property is configurable by admin users and is available in the Discovery Definition > Properties module. The property is called Use JSON for IP ranges in Shazzam in the module.

This property is set to false in upgraded instances and is not visible.

To enable JSON coding for upgraded instances:

Procedure

  1. In the navigation filter, type sys_properties.list and press Enter.
  2. Click New in the list view of system properties.
  3. Complete the form, using these field values:
    • Name: glide.discovery.shazzam_ranges_json
    • Description: Encodes the Shazzam payload in JSON.
    • Value: true
  4. Click Submit.
    The property is added to the sys_properties table, but does not appear in the Discovery Properties module.