NETMAIN_SRVR(8) Domain/OS BSD NETMAIN_SRVR(8)
NAME
netmain_srvr - collect network error stats
SYNOPSIS
/etc/netmain_srvr [options] [pathname]
DESCRIPTION
netmain_srvr collects and stores performance statistics for the Apollo
token ring network. Use netmain_srvr to gather information; use the
netmain program to display and analyze the information.
You can set parameters for netmain_srvr from the command line and from an
options file. Once the server is running, you can change any parameter
using the netmain program. To include parameters in an options file,
specify the -cmdf option.
When you specify -cmdf pathname, netmain_srvr reads the options listed in
the options file first and then reads any other options on the
netmain_srvr command line. If options specified in the file and on the
command line differ, netmain_srvr uses the command line settings. For
example, if the options file specifies a log file length as -ll 1500, and
the command line specifies -ll 3000, netmain_srvr uses -ll 3000.
If a netmain_srvr does not start properly, a record of the failure
appears in `node_data/netmain_srvr.err_log.
OPTIONS
-a[ppend] Append to an existing log file with this name, if one
already exists; otherwise, create a log file with this
name. This option is only valid when a log file pathname
is specified with the -l option. Contrast this with the
-nappend option.
-cmdf pathname Accept options from an ASCII text file pathname. You may
use this option only from the command line, not in the
options file. There can only be one options file.
-l[og] [pathname] (default)
Create a log file. Optionally, specify a pathname, which
is relative to the `node_data/net_log directory. If
either this option or the pathname is not specified, the
log file name is derived from the current date:
`node_data/net_log/net_log.yy.mm.dd. The log file is
stored on the disk of the node running netmain_srvr, and
must remain there for netmain_srvr to write to it.
-ll n (default)
Set an upper limit on the length of the log file. The file
size limit n is in 1024-byte units. The default value for
n is 3000. You must use this option when you start the
monitor and if you don't want to use the default length
for the first log file, since you cannot change the name
of a log file once it's open.
-na[ppend] (default)
Create a new log file, over-writing any log with that
name, if one exists. This option is only valid when a log
file pathname is specified with the -l option. Contrast
this with the -append option.
-nl[log] Do not write to a log file. netmain_srvr still runs
probes and observers.
-ntopo[_init] (default)
Override the -topo_init option, if -topo_init is specified
in an options file. -ntopo is useful only on the command
line.
-obs[erve] observer time ...
Set the interval at which the named observer wakes up.
Specify time as hh:mm:ss, hh:mm, or never, if you do not
want the monitor to run the observer. Multiple
observer/time pairs are permitted. See the default times
listed below for each observer.
-re_obs[erve] observer time ...
Set the "Recheck interval" -- the interval that the
observer waits before rechecking a node that has caused an
alarm condition. By setting a recheck interval, you
ensure that the observer only reports on a node once every
time period. If the recheck interval is too short, the
observer may produce many redundant alarms. Specify time
as hh:mm:ss, or hh:mm. Multiple observer/time pairs are
permitted. See the default recheck intervals listed below
for each observer.
-s[ample] probe time ...
Set the interval at which the named probe wakes up.
Specify time as hh:mm:ss, hh:mm, or never, if you do not
want the monitor to run the probe. Multiple probe/time
pairs are permitted. See the default times listed below
for each probe.
-sk[ip] probe distance ...
Set the skip distance for the probe named. If the skip
distance is n, the named probe samples approximately 1/n
of the nodes every time it wakes up. Multiple
probe/distance pairs are permitted. See the default skip
distances listed below for each probe.
-topo[_init] pathname
Initialize the monitor's total node list from a data file.
The file may contain any number of node names or
hexadecimal IDs, separated by spaces or on separate lines.
If there is a "#" or "{" in any line, that character and
all characters to the right of it are ignored (that is,
"#" and "{" are comment markers).