1
0
mirror of https://git.FreeBSD.org/ports.git synced 2024-11-23 00:43:28 +00:00

- 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
This commit is contained in:
Andreas Klemm 2001-03-25 11:48:48 +00:00
parent ff2c8e595c
commit 7f58715569
Notes: svn2git 2021-03-31 03:12:20 +00:00
svn path=/head/; revision=40343
8 changed files with 230 additions and 30 deletions

View File

@ -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>

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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>

View File

@ -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

30
net/flowscan/pkg-message Normal file
View File

@ -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

View File

@ -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