summaryrefslogtreecommitdiff
path: root/net-mgmt/flowscan
diff options
context:
space:
mode:
authorAndreas Klemm <andreas@FreeBSD.org>2001-03-25 11:48:48 +0000
committerAndreas Klemm <andreas@FreeBSD.org>2001-03-25 11:48:48 +0000
commit7f5871556973851363566e9ce143a0da5fa87493 (patch)
tree8ac49b56866d62769781c680106238153ae51354 /net-mgmt/flowscan
parentAdd a start stop script to the port which starts up services (diff)
- completely new functionalities, so bumped port revision
this was overdue, since this complex port needs more docu, explanation, preparation, etc ... - installation directory moved from ${PREFIX}/var/flows to ${PREFIX}/var/db/flows to match our typical /var filesystem layout, but since I want to package this port, I don't want to write into /var/filesystem its up to the user, to move the data around later if he has a large /var and likes the data to reside there. - create needed directories in ${PREFIX}/var/db/flows (bin and graphs) use a .keep_me file, so that things are packaged properly - install needed documentation the INSTALL file is essential as well as the various example file. NOPORTDOCS only covers unneeded files, which are not crucial for installation - the ${PREFIX}/var/db/flows/bin directory carries the sample files for the flowscan script. Therefore those sample files reside there. Other sample files like the crontab settings are up to the user, so they reside in ${PREFIX}/share/doc/flowscan - install a sample rc file in ${PREFIX}/etc/rc.d, its deactivated, since this is a port that needs thinking and handcrafting config files before use... - added a pkg-message file, that explains pre-requisites (cisco configuration) and other post installation tasks as well as a BIG WARNING, that enabling Netflow Switching and Netflow Data Export on your Cisco CORE or DISTRIBUTION routers might affect the routers switching performance. You should know IF you need to do it and if its o.k. IF you enable it. - output pkg-message on port based installation as well since the warnings are important. - updated PLIST
Diffstat (limited to 'net-mgmt/flowscan')
-rw-r--r--net-mgmt/flowscan/Makefile32
-rw-r--r--net-mgmt/flowscan/files/flowscan.sh26
-rw-r--r--net-mgmt/flowscan/pkg-message30
-rw-r--r--net-mgmt/flowscan/pkg-plist42
4 files changed, 115 insertions, 15 deletions
diff --git a/net-mgmt/flowscan/Makefile b/net-mgmt/flowscan/Makefile
index 1a3f8c33894a..99c5b0a804bc 100644
--- a/net-mgmt/flowscan/Makefile
+++ b/net-mgmt/flowscan/Makefile
@@ -7,7 +7,7 @@
PORTNAME= flowscan
PORTVERSION= 1.006
-PORTREVISION= 1
+PORTREVISION= 2
CATEGORIES= net
MASTER_SITES= http://net.doit.wisc.edu/~plonka/FlowScan/
DISTFILES= FlowScan-${PORTVERSION}.tar.gz
@@ -24,10 +24,36 @@ BUILD_DEPENDS= ksh:${PORTSDIR}/shells/pdksh \
CFLOWD_FLOWSCAN_PATCH= yes
HAS_CONFIGURE= yes
-CONFIGURE_ARGS+= --prefix=${PREFIX}/var/flows
+CONFIGURE_ARGS+= --prefix=${PREFIX}/var/db/flows
WRKSRC= ${WRKDIR}/FlowScan-${PORTVERSION}
pre-install:
- ${MKDIR} -p ${PREFIX}/var/flows/bin
+ @ ${MKDIR} -p ${PREFIX}/var/db/flows/bin
+ @ ${MKDIR} -p ${PREFIX}/var/db/flows/graphs
+ @ ${TOUCH} ${PREFIX}/var/db/flows/graphs/.keep_me
+
+post-install:
+ @ ${INSTALL_SCRIPT} ${FILESDIR}/flowscan.sh \
+ /usr/local/etc/rc.d/flowscan.sh.sample
+.for i in CampusIO.cf Napster_subnets.boulder SubNetIO.cf flowscan.cf \
+ local_nets.boulder our_subnets.boulder
+ @ ${INSTALL_DATA} ${WRKSRC}/cf/${i} \
+ ${PREFIX}/var/db/flows/bin/${i}.sample
+.endfor
+ @ ${MKDIR} -p ${PREFIX}/share/doc/flowscan
+ @ ${INSTALL_DATA} ${WRKSRC}/example/crontab \
+ ${PREFIX}/share/doc/flowscan/crontab.sample
+ @ ${INSTALL_DATA} ${WRKSRC}/rc/linux/cflowd \
+ ${PREFIX}/share/doc/flowscan/cflowd.sample
+ @ ${INSTALL_DATA} ${WRKSRC}/rc/linux/flowscan \
+ ${PREFIX}/share/doc/flowscan/flowscan.sample
+ @ ${INSTALL_DATA} ${WRKSRC}/INSTALL ${PREFIX}/share/doc/flowscan
+.if !defined(NOPORTDOCS)
+ @ ${ECHO_MSG} "===> Installing documentation for ${PKGNAME}"
+.for i in README README.html INSTALL.html TODO
+ @ ${INSTALL_DATA} ${WRKSRC}/${i} ${PREFIX}/share/doc/flowscan
+.endfor
+.endif
+ @ cat ${.CURDIR}/pkg-message
.include <bsd.port.mk>
diff --git a/net-mgmt/flowscan/files/flowscan.sh b/net-mgmt/flowscan/files/flowscan.sh
new file mode 100644
index 000000000000..df8911baac5f
--- /dev/null
+++ b/net-mgmt/flowscan/files/flowscan.sh
@@ -0,0 +1,26 @@
+# rc script for flowscan
+# Andreas Klemm <andreas@FreeBSD.org>, So 25 Mär 2001 12:46:10 CEST
+# $FreeBSD$
+
+if ! PREFIX=$(expr $0 : "\(/.*\)/etc/rc\.d/$(basename $0)\$"); then
+ echo "$0: Cannot determine the PREFIX" >&2
+ exit 1
+fi
+
+bindir=${PREFIX}/var/db/flows/bin
+logfile=${PREFIX}/var/db/flows/flowscan.log
+perl=/usr/bin/perl
+scandir=${PREFIX}/var/db/flows
+
+case "$1" in
+'start')
+ cd ${scandir} \
+ && ${perl} ${bindir}/flowscan \
+ >>${logfile} 2>&1 </dev/null \
+ >/dev/null
+ ;;
+
+'stop')
+ killall flowscan
+ ;;
+esac
diff --git a/net-mgmt/flowscan/pkg-message b/net-mgmt/flowscan/pkg-message
new file mode 100644
index 000000000000..bceddd3f5170
--- /dev/null
+++ b/net-mgmt/flowscan/pkg-message
@@ -0,0 +1,30 @@
+This is not an "easy" port. You have to take many things into consideration,
+what flow data to collect (disk space, etc), how and when to remove unneeded
+flow files. And you have to know, what it is all about. If you don't know
+Cisco NetFlow switching and its data export feature, then I recommend you
+to deinstall this port.
+
+Prerequisites:
+A) You need to read the installation instructions closely, see:
+ ${PREFIX}/share/doc/flowscan/INSTALL
+
+B) You need to configure your Cisco Router, to enable Netflow Switching
+ and Netflow data export.
+
+PLEASE NOTE, YOU HAVE TO KNOW EXACTLY, IF YOU REALLY WANT TO ENABLE NETFLOW
+SWITCHING ON YOUR CISCO CORE OR DISTRIBUTION ROUTERS, WHAT PERFORMANCE IMPACT
+MIGHT BE INVOLVED WHEN DOING THIS, WITH THE GOAL, NOT TO LOOSE YOUR ROUTING/
+SWITCHING PERFORMANCE. BE WARNED !!!
+
+Post-installation tasks involve:
+a) Configure cflowd properly for your needs, see above mentioned docu !
+ Example files reside in ${PREFIX}/etc, files:
+ cflowd.conf.example and cfdcollect.conf
+b) Configure flowscan, see above mentioned docu !
+ Example files reside in ${PREFIX}/var/db/flows/bin, files:
+ "foo".sample ...
+c) Customize and install crontab file, example see:
+ ${PREFIX}/share/doc/flowscan/crontab.sample
+
+d) Activate flowscan startscript by renaming it as usual, see example in:
+ ${PREFIX}/etc/rc.d/flowscan.sh.sample
diff --git a/net-mgmt/flowscan/pkg-plist b/net-mgmt/flowscan/pkg-plist
index f4ed43780744..dd9bc50e2be7 100644
--- a/net-mgmt/flowscan/pkg-plist
+++ b/net-mgmt/flowscan/pkg-plist
@@ -1,12 +1,30 @@
-var/flows/bin/flowscan
-var/flows/bin/FlowScan.pm
-var/flows/bin/CampusIO.pm
-var/flows/bin/SubNetIO.pm
-var/flows/bin/locker
-var/flows/bin/add_ds.pl
-var/flows/bin/add_txrx
-var/flows/bin/event2vrule
-var/flows/bin/ip2hostname
-@dirrm var/flows/bin
-@dirrm var/flows
-@dirrm var
+etc/rc.d/flowscan.sh.sample
+var/db/flows/bin/flowscan
+var/db/flows/bin/FlowScan.pm
+var/db/flows/bin/CampusIO.pm
+var/db/flows/bin/SubNetIO.pm
+var/db/flows/bin/locker
+var/db/flows/bin/add_ds.pl
+var/db/flows/bin/add_txrx
+var/db/flows/bin/event2vrule
+var/db/flows/bin/ip2hostname
+var/db/flows/bin/CampusIO.cf.sample
+var/db/flows/bin/Napster_subnets.boulder.sample
+var/db/flows/bin/SubNetIO.cf.sample
+var/db/flows/bin/flowscan.cf.sample
+var/db/flows/bin/local_nets.boulder.sample
+var/db/flows/bin/our_subnets.boulder.sample
+var/db/flows/graphs/.keep_me
+share/doc/flowscan/README
+share/doc/flowscan/README.html
+share/doc/flowscan/INSTALL
+share/doc/flowscan/INSTALL.html
+share/doc/flowscan/TODO
+share/doc/flowscan/crontab.sample
+share/doc/flowscan/cflowd.sample
+share/doc/flowscan/flowscan.sample
+@dirrm var/db/flows/graphs
+@dirrm var/db/flows/bin
+@dirrm var/db/flows
+@dirrm var/db
+@dirrm share/doc/flowscan