Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

NMIS will try to make sure it's own fpingd.pl is running every time a collect or update is run if configured to use it (detailed below).  If fpingd is not enabled or the loss value for the node to ping cannot be found in the fping status file nmis-fping.nmis or nmis-fping.json (on newer systems) then NMIS will run a ping of it's own.  This code can be found in nmis.pl in sub runPing.


Warning
titleDo Not Edit nmis-fping.json

The fping status file nmis-fping.nmis, or nmis-fping.json (on newer systems) is automatically created and updated by fpingd. This file should NEVER be hand edited. At the very least hand editing will be overwritten by fpingd and at the worst a bad edit could result in disabling fpingd completely.

fpingd

fpingd is enabled by default, the config setting (in Config.nmis for NMIS8) to control this is:

Code Block
'daemon_fping_active' => 'true',

In NMIS9 the configuration option is nmisd_fping_worker

Code Block
'nmisd_fping_worker' => 'true',


Info
titleNot Using DNS?

If you are NOT using DNS make sure to set daemon_fping_dns_cache in /usr/local/nmis8/conf/Config.nmis to false, the default value is true.


fpingd runs a constant cycle of pinging all nodes updating the NMIS event table, sleeping and then doing it all over again. Every 10 poll cycles the Nodes.nmis file is re-read to look for changes.

...

Here is a table of the config variable and what it controls, these are all set in Config.nmis where you can find the default values:

Configuration VariableDefault (if not set at all)Controls

fastping_timeout

300

Controls the -t setting for fping which is:

-tn  Initial target timeout in milliseconds (default 500). In the default mode, this is the amount of time that fping waits for a response to its first request.  Successive timeouts are multiplied by the backoff factor.


fastping_packet56

Controls the -b setting for fping which is:

-bn  Number of bytes of ping data to send.  The minimum size (normally 12) allows room for the data that fping needs to  do its work (sequence number, timestamp).  The reported received data size includes the IP header (normally 20 bytes) and ICMP header (8 bytes), so the minimum total size is 40 bytes.  Default is 56, as in ping.  Maximum is the  theoretical maximum IP datagram size (64K), though most systems limit this to a smaller, system-dependent number.

 


If this is set to < 24 it will be set to 24.

fastping_retries3

Controls the -r setting for fping which is:

 -rn  Retry limit (default 3). This is the number of times an attempt at pinging a target will be made,  not  including  the first try.


fastping_count 3

Controls the -C setting for fping which is:

 -C   Similar to -c, but the per-target statistics are displayed in a format designed for automated response-time statistics gathering.  For example:

            % fping -C 5 -q somehost

            somehost : 91.7 37.0 29.2 - 36.8

            shows the response time in milliseconds for each of the five requests, with the "-" indicating that  no  response  was received to the fourth request.


fastping_sleep60The number of seconds fpingd will sleep before running another ping cycle + random(10)
fastping_node_poll
300
200The number of nodes to ping in one invocation of fping. We strongly recommend that this value is set to no more than 250; otherwise you risk exceeding the linux command line length limits which will cause incorrect operation of fpingd.pl.

fastping_interval


1

The interval between sending ping packets.

Some firewalls like to have larger gaps between packets, setting fastping_interval to 80 and fastping_target_interval to 100 could be used to pacify these devices.

fastping_target_interval1

The interval between ping packets to one target.

See fastping_interval.