2 cd11-framedb-tool – Guralp Systems CD1.1 User Manual

Page 59

Advertising
background image

Operator's Guide

-V, --version Display version number.

-s, --summary Display summary of backfilldb.

-d, --detail Dump details (entries) of

backfilldb.

-c, --clear-before <date> Clear entries before <date> from

backfilldb.

-C, --clear-all Clear all entries from

backfilldb.

-a, --add <date>/<date> Add an entry between two dates.

The default action is to display a summary of the database.

This tool should only be used to modify the database when

data-out-cd11 is not running. Actions are executed in

reverse order to the commandline.

9.2.2 cd11-framedb-tool

The CD1.1 sender, data-out-cd11, maintains a database of
transmitted frames, mapping its sequence numbers to their
channels and time-stamps. Where multiple senders transmit a
common subset of frames, one frame can have different
sequence numbers, when seen from the points of view of the
different senders. If a Data Consumer (DC) requests
retransmission of a packet, it will do so by sequence number
but the multiplexer stores frames by channel and time-stamp.
The frame database allows the sender to receive the
retransmission request from the DC by sequence number and,
subsequently, to pass the request on to the multiplexer by
channel and time-stamp.

The command-line program cd11-framedb-tool allows the
listing or removal of frames from this database.

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

If no other arguments are given, the tool provides a brief
summary of the contents of the database, as shown below.

eam999# cd11-framedb-tool /var/lib/data-out-cd11.0/framedb

Most recent sequence number : 38295
First unacknowledged sequence number: 38293

frame date: 2009-12-06T23:40:20Z
Last unacknowledged sequence number: 38295

frame date: 2009-12-06T23:40:40Z
eam999#

June 2010

59

Advertising