Network Discovery Reference

This page provides a reference for network discovery configuration variables, filter script variables, and discovery sources in NetXMS.

For procedures on configuring network discovery, see Network Discovery.

Server Configuration Variables

Variable Default Description

NetworkDiscovery.ActiveDiscovery.BlockSize

1024

Block size (number of addresses) for active discovery scans.

NetworkDiscovery.ActiveDiscovery.EnableSNMPProbing

1

Enable or disable SNMP probing during active network discovery. If enabled, the server sends SNMP requests to detect devices that respond to SNMP but not to ICMP pings.

NetworkDiscovery.ActiveDiscovery.EnableTCPProbing

0

Enable or disable TCP probing during active network discovery. If enabled, the server tries to establish TCP connections to a list of well-known ports to detect devices that are not responding to ICMP pings.

NetworkDiscovery.ActiveDiscovery.InterBlockDelay

0

Interval in milliseconds between scanning address blocks during active discovery.

NetworkDiscovery.ActiveDiscovery.Interval

7200

Interval in seconds between active network discovery polls.

NetworkDiscovery.ActiveDiscovery.Schedule

(empty)

Schedule used to start active network discovery polls, in cron format.

NetworkDiscovery.DisableProtocolProbe.Agent

0

Disable probing discovered addresses for NetXMS agent.

NetworkDiscovery.DisableProtocolProbe.EtherNetIP

0

Disable probing discovered addresses for EtherNet/IP support.

NetworkDiscovery.DisableProtocolProbe.SNMP.V1

0

Disable SNMP version 1 when probing discovered addresses for SNMP support.

NetworkDiscovery.DisableProtocolProbe.SNMP.V2

0

Disable SNMP version 2 when probing discovered addresses for SNMP support.

NetworkDiscovery.DisableProtocolProbe.SNMP.V3

0

Disable SNMP version 3 when probing discovered addresses for SNMP support.

NetworkDiscovery.DisableProtocolProbe.SSH

0

Disable probing discovered addresses for SSH support.

NetworkDiscovery.Filter.Flags

0

Discovery filter settings.

NetworkDiscovery.MergeDuplicateNodes

0

Enable or disable merge of duplicate nodes. When enabled, configuration of duplicate node(s) will be merged into the original node and duplicate(s) will be deleted.

NetworkDiscovery.PassiveDiscovery.Interval

900

Interval in seconds between passive network discovery polls.

NetworkDiscovery.Type

0

Discovery type: 0=disabled, 1=passive only, 2=active only, 3=passive and active.

NetworkDiscovery.UseDNSNameForDiscoveredNodes

0

Enable or disable the use of DNS name instead of IP address as primary name for newly discovered nodes.

NetworkDiscovery.UseFQDNForNodeNames

1

Enable or disable the use of fully qualified domain names as primary names for newly discovered nodes.

NetworkDiscovery.UseSNMPTraps

0

Use SNMP trap information for new node discovery.

NetworkDiscovery.UseSyslog

0

Use syslog messages for new node discovery.

Discovery Filter Hooks

Discovery filtering is implemented via two hook scripts. For available variables and attributes, see the NXSL reference:

Discovery Sources

Source Description

ARP tables

Collected from monitored nodes — read locally via the agent where available, via SNMP as fallback (passive)

Routing tables

Collected via SNMP or agent from routers (passive)

Address range scan

Active scan of configured address ranges: ICMP ping sweep plus SNMP probing (enabled by default, NetworkDiscovery.ActiveDiscovery.EnableSNMPProbing) and optional TCP probing (NetworkDiscovery.ActiveDiscovery.EnableTCPProbing, disabled by default) (active)

Agent registration

Agents announcing themselves to the server; controlled by Agent.EnableRegistration (enabled by default). Registered agents bypass discovery filters

SNMP trap source

Source address of traps from unknown hosts (optional)

Syslog source

Source address of syslog messages from unknown hosts (optional)