File: add_txrx.1

package info (click to toggle)
flowscan 1.006-13
  • links: PTS
  • area: main
  • in suites: squeeze
  • size: 728 kB
  • ctags: 185
  • sloc: sh: 1,670; perl: 1,518; makefile: 148
file content (52 lines) | stat: -rw-r--r-- 1,764 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
.TH ADD_TXRX 1
.SH NAME
add_txrx \- add two new Data Sources called 'tx' and 'rx' to an RRD file
.SH SYNOPSIS
.B add_txrx <file> ...
.SH "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 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

.SH "SEE ALSO"
.BR add_ds.pl (1),
.BR event2vrule (1),
.BR flowscan (1),
.BR ip2hostname (1),
.BR locker (1)
.SH AUTHOR
This manual page was written by Anibal Monsalve Salazar,
for the Debian Project.