add_txrx(1) [debian man page]

ADD_TXRX(1)						      General Commands Manual						       ADD_TXRX(1)

NAME

       add_txrx - add two new Data Sources called 'tx' and 'rx' to an RRD file

SYNOPSIS

       add_txrx <file> ...

DESCRIPTION

       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 FlowS-
       can-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

       add_ds.pl(1), event2vrule(1), flowscan(1), ip2hostname(1), locker(1)

AUTHOR

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

																       ADD_TXRX(1)