An example config file, which all supported options:
PingAddresses = 192.168.100.0/255.255.255.0;192.168.100.10-192.168.199.19;192.168.200.1;192-192.168-168.100-199.0-9; PingNames = bb_mail; AllowedAddresses = 192.168.0.0/255.255.0.0 BroadcastNetwork = 192.168.100.0/255.255.255.0 SearchUsingNmblookup = 1 #also try nmblookup FirstWait = 30 #30 hundredth seconds SecondWait = -1 #only one try #SecondWait = 60 #try twice, and the second time wait 0.6 seconds UpdatePeriod = 300 #update after 300 secs DeliverUnnamedHosts = 0 #don't publish hosts without name MaxPingsAtOnce = 256 #send up to 256 ICMP echo requests at once
More and simpler config file examples you can find here.
This is probably the most important entry.
-network address/network mask:
-a range of following IP adresses:
-an IP-address can be presented by its four decimal numbers, you can specify
ranges for each of these four numbers:
It is also valid to leave this entry empty.
here you can additionally specify hosts to ping using their names.
The names have to be divided by semicolons.
This is also very important. LISa will only ping addresses,
accept clients and answer broadcasts from addresses, which are covered by the
addresses given in this line. You can add up to 32 network addresses/network masks
or single addresses. Divide them by ; and don't put empty space between the
This entry contains exactly one network address/subnet mask.
To this network broadcasts will be sent. Usually this should be your
own network address/subnetmask.
Here you can give 0 or 1, the default is 0.
After LISa sent the echo requests the first time, it can be possible
that some hosts were not found. To improve the results, LISa can ping a
second time. This time it will only ping hosts, from which it didn't receive
answers. If you have good results with pinging only once, you can disable
the second time with setting SecondWait to -1.
This is the interval in seconds after which LISa will update its list of running hosts
(i.e. ping or nmblookup
or get the list of hosts from the LISa server which actually does the pinging).
Valid values are between 30 seconds and 1800 seconds (half an hour).
If you have a big network, don't make the interval to small (to keep
network load low). Values from 300 to 900 seconds (5 to 15 minutes) might be
a good idea. Keep in mind that the update period is doubled
if nobody accesses the server, up to 4 times, so the interval will become
16 times the value given here and will be reseted to the value given here
if somebody accesses the server.
If an answer to an echo request from an IP address was received, were LISa
could not determine a name, it will be only published to you if you set this to 1.
I am not really sure if this is a useful feature, but maybe
there are some infrastructure devices in your network without assigned names,
so they don't have to be published. Set this to 0 if you want to keep them
When sending the pings (echo requests), LISa sends a bunch of these at once
and then waits for the answers. By default there are 256 pings sent at once,
usually you should not need to change this value. If you make it much bigger,
the internal receive buffers for the answers to the echo requests may become to small,
if you make it to small, the updating will be slower.
1.) You are member of a small network with 24 bit network mask, i.e.
up to 256 hosts:
PingAddresses = 192.168.100.0/255.255.255.0 AllowedAddresses = 192.168.100.0/255.255.255.0 BroadcastNetwork = 192.168.100.0/255.255.255.0 FirstWait = 20 #20 hundredth seconds SecondWait = 30 #30 hundredth seconds on the seconds try UpdatePeriod = 300 #update after 300 secs
2.) You are only interested in hosts running smb services and you don't have
routers in your network:
AllowedAddresses = 192.168.100.0/255.255.255.0 BroadcastNetwork = 192.168.100.0/255.255.255.0 SearchUsingNmblookup = 1 #use nmblookup UpdatePeriod = 300 #update after 300 secs
3.) The same network, but here both nmblookup and pinging is used.
Additionally the host named "bb_mail" is checked.
PingAddresses = 192.168.100.0/255.255.255.0 PingNames = bb_mail AllowedAddresses = 192.168.0.0/255.255.0.0 BroadcastNetwork = 192.168.100.0/255.255.255.0 SearchUsingNmblookup = 1 #also try nmblookup FirstWait = 30 #30 hundredth seconds SecondWait = -1 #only one try UpdatePeriod = 300 #update after 300 secs MaxPingsAtOnce = 256 #send up to 256 ICMP echo requests at once
4.) And now a configuration file for resLISa, PingAddresses is not used by resLISa,
neither is BroadcastNetwork.
PingNames = bb_mail;some_host;some_other_host AllowedAddresses = 192.168.0.0/255.255.0.0 SearchUsingNmblookup = 1 # use nmblookup FirstWait = 30 #30 hundredth seconds SecondWait = -1 #only one try UpdatePeriod = 300 #update after 300 secs DeliverUnnamedHosts = 1 #also publish hosts without name MaxPingsAtOnce = 256 #send up to 256 ICMP echo requests at once