netmain_srvr — Apollo

7.0; NETMAIN_SRVR (network_maintenance_server),revision 7.0, 83/09/01
NETMAIN_SRVR (NETWORK_MAINTENANCE_SERVER) -- Collect network error statistics.
usage:  NETMAIN_SRVR [-L[OG] [pathname] | -NL[OG]] [-LL log-len]
                     [-T[IMESTAMP] time] [-S[AMPLE] probe time ...]
                     [-S[KIP] probe distance ...]


FORMAT

  NETMAIN_SRVR [options]

  NETMAIN_SRVR collects and stores error statistics for the network.
  It should be run as a server process (via the DM command CPS).
  See the "DOMAIN System Administrator's Guide" for full details.

  NETMAIN_SRVR should not be run on diskless nodes.

  All of the parameters that can be set from NETMAIN_SRVR's command line (see
  OPTIONS) can be changed from the NETMAIN program after the server is
  running.


OPTIONS

  -L[OG] [pathname]
                   Create a log file. The pathname, if specified,
                   is a pathname relative to the `node_data/net_log
                   directory. If the pathname is not specified,
                   it defaults to a name derived from the current
                   date. The log file should be kept on the disk
                   of the node running NETMAIN_SRVR.

  -LL n            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.

  -NL[OG]          Specify that no log file be kept. Probes still run.

  -S[AMPLE] probe time ...
                   Set the interval at which the named probe wakes up.
                   Time is specified as hh:mm:ss, hh:mm, or 'Never'.
                   Multiple probe/time pairs are permitted.

  -SK[IP] probe distance ...
                   Set the skip distance for the probe named. Roughly,
                   if the skip distance is n, 1/n of the nodes are
                   sampled every time the named  probe wakes up. Multiple
                   probe/distance pairs are permitted.

  -T[IMESTAMP] time
                   Set the timestamp interval. If no other entries are
                   logged for the period given, the monitor creates a
                   timestamp. Time is specified as hh:mm:ss, hh:mm, or
                   'Never'.  The default value is 0:5:00

  The monitor contains these probes (in addition to the special timestamp
  probe):

                      Default     Default
      Name             time        skip
      ============    =======     =======
      ERR_COUNTS      0:30:00       1           Skip distance applies
      EST_TOPOLOGY    Never         NA          only to probes that
      HW_FAIL         0:01:00       NA          examine other nodes.
      TOPOLOGY        1:00:00       NA


EXAMPLES

  Command: CPS NETMAIN_SRVR -LL 1500 -L tuesday_error_log

  Command: CPS NETMAIN_SRVR -S error_counts 0:15 hw_fail never


RELATED TOPICS

  Information is available about related programs.  Type:

      - HELP CPS
        for information about running server processes.

      - HELP NETMAIN
        for instructions on controlling NETMAIN_SRVR after it starts,
        and on analyzing the data collected.

      - HELP NETMAIN_NOTE
        for information about adding notes to the network error log.
Museum

Related Articles
