sourCEntral - mobile manpages




add_txrx − add two new Data Sources called ’tx’ and ’rx’ to an RRD file


add_txrx <file> ...


This utility is used when upgrading from FlowScan-1.005 (or less) to FlowScan-1.006 (or greater). It is used to add two new Data Sources to FlowScan ".rrd" files. e.g.:

$ make install # install FlowScan-1.006 in your existing FlowScan dir
$ cd $prefix/graphs
$ add_txrx total.rrd *.*.*.*_*.rrd

tx - a count of the unique source IP addresses
that have transmitted flows
rx - a count of the unique destination IP addresses
that have received flows

These Data Sources will allows FlowScan users to calculate the average number of bytes, packets, and flows per host and to determine the overall level of activity (in terms of numbers of individual hosts) for each subnet and for the entire campus.

The values will be recorded only if you use the TopN directive with the CampusIO and/or SubNetIO reports. TopN was introduced in FlowScan-1.006.

For instance, if you set CampusIO’s TopN to a value greater than zero, the tx value in FlowScan’s "total.rrd" is the number of unique source IP addresses (hosts) from which FlowScan has seen outbound flows.

Upgrading your RRD Files

If you are upgrading, it is necessary to add two new Data Sources to the some of your existing RRD files. Before running flowscan, backup your RRD files, e.g.:

$ cd $prefix/graphs
$ tar cf saved_rrd_files.tar *.rrd

then do this:

$ cd $prefix/graphs
$ ../bin/add_txrx total.rrd [1-9]*.*.*.*_*.rrd

SEE ALSO, event2vrule(1), flowscan(1), ip2hostname(1), locker(1)


This manual page was written by Anibal Monsalve Salazar, for the Debian Project.