1 cd11-backfilldb-tool – Guralp Systems CD1.1 User Manual

Page 57

Advertising
background image

Operator's Guide

cd11-timedb-tool - used to summarise or display
headers from the frames database maintained by the
CD1.1 multiplexer, data-mux-cd11.

cd11-frame-analyser-tool - used to dump and
decode a CD1.1 frame (or multiple frames), either as
they are received or selected by time-stamp.

cd11-management-tool - used to change the logging
level of any of the CD1.1 modules without restarting
them, and/or to change the authentication key ID.

All of these tools have detailed usage messages which are
accessible by invoking the tool with, as an argument, either -h
or --help.

9.2.1 cd11-backfilldb-tool

The CD1.1 sender, data-out-cd11, maintains a database of un-
transmitted or unacknowledged frames, which it uses to
perform back-fill. In normal operation with good network links,
this database is quite likely to be empty.

The command-line program cd11-backfilldb-tool allows the
listing, addition or removal of frames for which back-fill is to be
performed.

The back-fill database file for the first sender instance is
normally /var/lib/data-out-cd11.0/backfilldb - other
instances use similar path-names with the “0” incremented for
each instance. The tool should be invoked with the path to the
back-fill database as the last argument.

If no other arguments are given, the tool reports the most
recent frame time-stamp and the number of gaps (contiguous
sequences of missing frames) in the database:

eam999 # cd11-backfilldb-tool /var/lib/data-out-

cd11.0/backfilldb
Most recent timestamp : 2009-12-06T23:40:40Z

Number of missing ranges: 2

This is the same behaviour as when the -s (or --summary)
argument is given.

Giving the -d (or --detail) argument displays a table showing
the start and end time-stamps for each gap:

June 2010

57

Advertising