dbreplay - replay a database to an orbserver w/o modifying time
dbreplay [-b max-behind]
[-de]
[-F foreignkeys]
[-n #pkts]
[-p pktsuffix]
[-r rate]
[-s subset]
[-t timestep]
[-T timeout]
[-v]
[-w orbclient]
[-x]
db|vw
[[[server] mintime] maxtime|period]
dbreplay reads an input database and sends packets composed from
the waveforms to an orbserver. It's intended for testing
components of a real time system, using existing databases.
The only required argument is a input database db or view vw which includes
wfdisc. You may specify an orb server; the default is the
current machine.
If you wish you may also specify a time range,
with a start time, followed by either a period (eg, 0:20 for 20 minutes)
or an explicit end time.
-
-b max-behind
-
-w orbclient
Watch the specified orbclient, and stop putting data into orbserver(1)
until the specified client is no more than max-behind seconds behind
the input. orbclient may be a regular expression.
The default max-behind is 60 seconds.
-
-T timeout
When waiting for a specified client, give up after some timeout period.
By default, this timeout period is zero, meaning it waits forever.
-
-d
Send the appropriate station side of the database in addition to the waveforms.
This is specified with a view from dbreplay.pf, which is subset to the
specified time range.
-
-e
Send the appropriate event side of the database in addition to the waveforms.
This is specified with a view from dbreplay.pf, which is subset to the
specified time range, with a leading window which is also specified inside
dbreplay.pf.
-
-F foreignkeys
use the specified database to translate from local sta/chan pairs to foreign
net/sta/chan/loc.
-
-n #packets
Stop after sending n packets.
-
-p pktsuffix
This allows specifying the output packet suffix.
-
-r rate
The default is to send data at a rate which approximates the original
real time. However, you may specify faster rates by setting rate > 1,
or by specifying an orbclient to watch with the -w option.
-
-s subset
Subset the input database according to the specified expression.
-
-t timestep
Specify the timestep per packet. The actual packets from
dbreplay may vary in time length if data is missing, but this
is the nominal time window per packet. The default timestep is
1 minute; this is longer than the typical packet from a data logger,
but results in improved efficiency in the reprocessing.
-
-v
Be more verbose
-
-x
Eliminate the empty trailer packet (with a time two hours after the last
data packet) which is usually appended after all the data.
This packet normally causes orb2db(1) to flush
all received data to disk.
-
station_database
specifies a list of various candidate views from which the
station side of the database transmitted by dbreplay is constructed.
The first view with more than zero records is transmitted.
-
event_database
specifies a list of various candidate views from which the
event side of the database transmitted by dbreplay is constructed.
The first view with more than zero records is transmitted.
-
event_leadtime
The event database is subset according to the input time range, but including
some extra lead time to (potentially) get teleseism events.
% dbreplay -de -s "chan=~/.*Z/" -n 13 -r 1000 -v demo :
instrument : selected 22 records of 22
sensor : selected 39 records of 39
site : selected 13 records of 13
sitechan : selected 39 records of 39
arrival : selected 9 records of 12
assoc : selected 9 records of 9
netmag : selected 5 records of 5
origin : selected 1 records of 1351
stamag : selected 4 records of 4
KNET_EKS2_BHZ/replay 446 byte (1186 samples) packet from \
5/17/1992 21:55:04.700 through 5/17/1992 21:56:04.000
KNET_AAK_BHZ/replay 944 byte (1075 samples) packet from \
5/17/1992 21:55:10.250 through 5/17/1992 21:56:04.000
.
.
.
KNET_KBK_BHZ/replay 268 byte (289 samples) packet from \
5/17/1992 21:57:04.050 through 5/17/1992 21:57:18.500
sent 13 packets (10342 bytes)
sent 2:15 minutes of data in 410.287 milliseconds
# put demo database on the orb, but not so fast that any orb2orb
# falls behind.
% dbreplay -w orb2orb demo :
-
Can't open connection to ring buffer at '%s'
Orb buffer isn't running, perhaps?
-
Can't open database %s
-
No records selected
Something wrong with the input database
-
unknown packet type 'pktsuffix'
The specified packet type is not recognized.
-
stuffPkt failed
The stuff packet routine stuffPkt(3) failed.
-
Couldn't send packet
orbput(3) failed.
The subset specified on the command line is not applied to the event and
station databases. If it's desired to subset these databases, this should
be done by editing dbreplay.pf.
db2orb(1)
Daniel Quinlan
Boulder Real Time Technologies, Inc.
Table of Contents
Antelope Release 4.6 Linux 2.4.19-4GB 2004-10-21
Boulder Real Time Technologies, Inc
For more information, contact support@brtt.com