NAME
automrc - automatically send mass re-centering (MRC) command to a UCSD
REFTEK DAS
SYNOPSIS
automrc [-p parameter-file] orbname
dc_name[,dc_name2[,dc_name3]]
SUPPORT
Contributed code: NO BRTT support.
THIS PIECE OF SOFTWARE WAS CONTRIBUTED BY THE ANTELOPE USER COMMUNITY. BRTT DISCLAIMS ALL OWNERSHIP, LIABILITY, AND SUPPORT FOR THIS PIECE OF SOFTWARE.
FOR HELP WITH THIS PIECE OF SOFTWARE, PLEASE CONTACT THE CONTRIBUTING AUTHOR.
DESCRIPTION
automrc reads data from a ring buffer and calculates LTA on the specified
packets. By default
automrc is using the 1sps data stream (*/CBB1S), but
this default can be overwritten by setting the parameter 'srcname' in the "
automrc.pf" file. Regular expressions can be used (e.g..*/CBBLS).
When the calculated LTA is higher than "max_lta" (set in
automrc.pf)
automrc tries to send an MRC command to the DAS through DC (dc
IP address is specified on the command line. There can be multiple
DCs specified.)
The
automrc will send "num_repeats" (set in
automrc.pf) MRC
commands to a DAS with a time period "timeout_btw_cmds" (set in
automrc.pf).
If
automrc needs to send an MRC command "max_mrc" (set in
automrc.pf)
times to a DAS it will notify "recipient" (set in
automrc.pf) by
email that multiple MRC commands failed. There can be multiple
recipients specified, separated by commas.
auto_mrc requires
two parameter files: the first
contains all DAS IDs existing in the RT system -
parameter-file
(
pkt.pf is default), and the second named
automrc.pf
contains the parameters for triggering resets.
pkt.pf is a regular parameter file which is used by IPD.
OPTIONS
-
-p parameter-file
A parameter file parameter-file
will be used to select all possible DAS IDs in a RT system.
A pkt.pf parameter file is used by default.
EXAMPLE
Send an MRC with the following options :
- read data from ORB on localhost ;
- send command via the DC port on IP address 132.239.4.194.
auto_mrc localhost 132.239.4.194
PARAMETER FILE
automrc parameter file elements are:
-
srcname
Regular expression to select which data packets are processed.
Default is .*/CBB1S
-
max_lta
Trigger threshold level for mass recenter. If abs(lta) > max_lta
on any channel, then a mass recenter is sent to that DAS. Units
are in digital counts!
Default is 20000.
-
lta_window
Number of seconds of data which lta is averaged over.
Default is 3600.
-
num_repeats
number of times to retransmit mass recenter commands to DAS.
Default is 2.
-
timeout_btw_cmds
number of seconds between retransmissions of mass recenter commands to a DAS.
Default is 30.
-
max_mrc
maximum number of times consecutive MRC commands can fail to recenter before sending
and email warning.
Default is 4.
-
receipient
list of email receipients to be notified if MRC commands do not work.
Default is rt@localhost.
PARAMETER FILE
srcname .*/CBB1S # data will be used in LTA calculation
max_lta 20000 # MAX allowed LTA value
lta_window 3600 # # of sec for LTA
num_repeats 2 # # times to repeat command for one das
timeout_btw_cmds 30 # # of sec between command send to DAS
max_mrc 4 # max # of failed MRC to send 'alarm' email
receipient rt@localhost # whom to send an email in a case of MRC failed
AUTHOR
Marina Glushko
Antelope User Group Contributed Software