We didn't have much time to write this installation
manual, and this version of the Beholder/Tricklet sources                      
have only been tested on Sun's using SunOs 4.1.x using                         
the gcc compiler. I'll try to be as complete as possible,                      
then your on your own:                                                         

OK, this is what you need:

        - an understanding of UNIX and SNMP
        - a UNIX box with a working ANSI C 
          compatible compiler, gcc works fine.
        - a tcp/ip stack on that box, normally
          present in every networking system
        - some SNMP-able devices, if you don't have
          them, this stuff is of no use to you.

I'll walk you through the installation step-by-step. I
assume your current directory is the root of
this distribution.

step 1:
        Go to a directory where you have some space. 
        Make a directory and chdir to that directory.                                                                        
        Unzip the distribution using the latest unzip.
        So:

                cd ~/cprog
                mkdir btng2
                cd btng2
                unzip -a -d ~/tmp/btng2unx.zip

step 2:
	edit the file dnpap/dnpap/gcc_unx.std. You should
	only have to change the pathnames in 
	this file. You could have a look at the compiler 
        definitions if you want.

step 3:
	from the top directory of the distribution 
	type

		make -f gcc_unx.mak install

	This should result in a couple of binaries to
	appear in the ./bin directory.

step 4:
	installation is done by hand. You will need 
	three target directories, one to put the 
	binaries in, one to put the configuration
	files in, and one to put the MIB definition
	files in. We ourselfs use the following:

		/usr/local/bin		-> executables
		/usr/local/lib/dnpap	-> config files
		/usr/local/lib/mibhome	-> mib files

	Optionaly you can copy the manual pages
	from doc/man to your man environment or:

		cp doc/man/*.1 /usr/local/man/man1

step 5:                                                      
        create two environment variables:                    
                                                             
                CONFIGPATH /usr/local/lib/dnpap              
                MIBHOME /usr/local/lib/mibhome               
                                                             
        these two should always be defined when you          
        use this software.
        CONFIGPATH points to the directory with the
        .ini and .cfg files.
        MIBHOME points to the directory containing
        the .def and the mibs files.

step 6:
        Go to the init directory, and edit global.cfg.
	Set the following variables to suite your
        needs.

                mgmt.agent
                mgmt.medium
                mgmt.community

                mibdf.mibhome

	The last one should be set to the directory where
	the MIB files are stored. The first three can
	always be overwritten on the command line.

	Compile the global.cfg file using the cfg2ini command.
	This will create the file global.ini, so:

		cfg2ini global.cfg

step 7:
	Try out the commands, for example:

		echo "sysDescr" | snmp-get dnpap.et.tudelft.nl

	Read the manual pages and see what Beholder/Tricklet
	can do for you.

step 8
	If you have, love and use Perl, look at the perl directory
	in the distribution. Copy the files perl/spook.unx and
	perl/rmon/collector.pl to your Perl library directory, so:

		cp perl/spook.unx /usr/local/perl/lib/spook.pl
		cp perl/rmon/collector.pl /usr/local/perl/lib

	Run and Examine the following perl scripts:

		perl/demoget.pl
		perl/demotbl.pl
		perl/rmon/etherstats.pl

	The last one requires a running RMON monitor like
	the beholder TNG.


That's it, let me know if you have any trouble, and inform me
of porting troubles. I'll try to include all clean bug fixes in
future distributions


Jan		Jan.vOorschot@dnpap.et.tudelft.nl




