Discovery > Discovery Modules > Network Infrastructure > Network - Basic Discovery > Range IPs by ICMP Job

Range IPs by ICMP Job

This section includes details about the job.

Introduction

This job performs an IP ping sweep on probe ranges.

ClosedTrigger TQL

Adapter Information

This job uses the IP ping sweep adapter.

ClosedAdapter Type

Jython

ClosedInput CIT

Discovery Probe Gateway

ClosedInput TQL

ClosedTriggered CI Data
Name Value
probeName ${SOURCE.name}
ClosedUsed Scripts
  • icmp_utils.py
  • IP_by_range.py
ClosedDiscovered CITs
  • Dependency
  • IpAddress
ClosedGlobal Configuration Files
  • globalSettings.xml
ClosedAdapter Parameters
Name Default Value Description
bulkSize 500

The bulk size of IP addresses for one ping in one system call. All IP addresses should be in one range.

For example, if the range contains 900 IP addresses and the bulk size is 500, the job will call DLL API twice. The first call is for the first 500 IP addresses, and the second call is for the remaining 400 IP addresses.

If the range contains 500 or less IP addresses, the job will only call DLL API once.
excludePatternsList  

The list of wildcard patterns, separated by semicolons (;). IP addresses that match any of the patterns are skipped.

Patterns may include:

  • numbers
  • dots
  • * (matches zero or more characters)
  • ? (matches exactly one character)
isIPv4PingEnabled true Indicates whether to ping all IPv4 addresses within the defined ranges.
isIPv6PingEnabled true Indicates whether to ping all IPv6 addresses within the defined ranges.
pingProtocol 1 The ping protocol: ICMP (1), ECHO PORT (2), or both (3).
range NA

The range of IPs to ping, separated by semicolons (;).

Sample: 1.2.3.0-1.2.3.10;1.2.3.50-1.2.3.60
retryDiscover 2

The number of the ping retry.

When the live IP addresses are missed, you can increase this value.
threadPoolSize 10 The number of threads in pool that performs port 7 echoing.
timeoutDiscover 3000

The ping timeout (in milliseconds).

When the network is too slow and the ping reply latency is too high, you can increase this value.

If the range contains multiple IP addresses, the timeout is for all the IP addresses in one ping action instead of only for one IP address.
virtualModeDiscover false Indicates whether to discover the virtual IP addresses.

Tip  

  • When configuring a lot of IP addresses in one range, you can increase the bulksize parameter value for efficiency and increase the timeoutDiscover parameter value for not missing the IP addresses.
  • When configuring a small number of IP addresses in many small ranges, you can decrease the timeoutDiscover parameter value for efficiency.