Installing Raddle
=================

Use the RPM packages if you can - this is quick and easy.

Otherwise:

1)	If your OS does not come with net-snmp configured for Perl:
	Get the source code for net-snmp, configure it, and install.
	You will need to configure the Perl agent support, e.g.:

		./configure \
			--prefix=/usr/local/snmp \
			--enable-shared \
			--enable-embedded-perl \
			--with-perl-modules \
			--with-default-snmp-version=2 \
			--with-sys-contact=UNSET \
			--with-sys-location=UNSET \
			--with-persistent-directory=/var/net-snmp \
			--without-copy_persistent_files \
			--with-logfile=/var/log/net-snmp
		make
		make install

	More detailed instructions can be found in net-snmp/README

2)	To install Raddle, follow the usual Perl sequence:

		perl Makefile.PL
		make
		make test
		make install

3)	Get the source for Honeyd and Arpd. Build both and install.
	These packages are available from:

	http://www.honeyd.org/

	NOTE that if you plan to run Honeyd and Raddle on the loopback
	interface of a recent Linux system then you will need to apply a patch
	to ignore checksums. A pre-patched version is available from the
	Raddle site on Sourceforge.

4)	Try it out:

	Follow the instructions in examples/branch-network/README to
	set up a small emulated network and test it.



Andrew Findlay
25 November 2003

$Id: INSTALLATION,v 1.5 2009/11/13 13:29:52 afindlay Exp $
