This is the documentation for the development version. There are no official binaries for it; build it from the source code in git. Download links on these pages work only after the release. For the current release, see version 7.0.

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

Settings saved in Configuration > Network discovery take effect immediately. When changed directly as server configuration variables, the variables marked * take effect only after a server restart.

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 the DNS name instead of the IP address as the primary host name of newly discovered nodes. The name is used only if it resolves back to the same address. The object name is not changed.

NetworkDiscovery.UseFQDNForNodeNames *

1

Keep the domain part of node names that the configuration poll sets (Objects.Nodes.SyncNamesWithDNS, Objects.Nodes.SyncNamesWithSNMPSysName, Objects.Nodes.ResolveNames). When disabled, the name is cut at the first dot. See Node Name Resolution. This variable is not in the Network discovery view, so a change always requires a server restart.

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)