diff options
author | Andreas Klemm <andreas@FreeBSD.org> | 2001-03-25 11:48:48 +0000 |
---|---|---|
committer | Andreas Klemm <andreas@FreeBSD.org> | 2001-03-25 11:48:48 +0000 |
commit | 7f5871556973851363566e9ce143a0da5fa87493 (patch) | |
tree | 8ac49b56866d62769781c680106238153ae51354 /net-mgmt/flowscan | |
parent | Add 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
Notes
Notes:
svn path=/head/; revision=40343
Diffstat (limited to 'net-mgmt/flowscan')
-rw-r--r-- | net-mgmt/flowscan/Makefile | 32 | ||||
-rw-r--r-- | net-mgmt/flowscan/files/flowscan.sh | 26 | ||||
-rw-r--r-- | net-mgmt/flowscan/pkg-message | 30 | ||||
-rw-r--r-- | net-mgmt/flowscan/pkg-plist | 42 |
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 |