INSTALL INSTRUCTIONS for using GraphDefang with MIMEDefang
by Kevin A. McGrail (kmcgrail@pccc.com)

Maintained at: http://www.pccc.com/downloads/



Required Perl Modules:

File::ReadBackwards 
GD 
GD::Graph 
GD::Text::Align (part of the GDTextUtils package) 
Date::Parse; 
Date::Format; 
MLDBM 
Storable (might already be installed with your perl) 


#GD REQ'S NOTE: (GD, GD::Graph & GD::Text::Align)

GD is a very useful C Library written by Thomas Boutell (http://www.boutell.com/gd/).  There are also 
many perl modules which enhance and take advantage of this fabulous library.  

There is another install HOW-TO that covers libgd and some various related entities at:
  http://www.pccc.com/downloads/gd/

#Storable REQ'S NOTE:

This was already installed with my perl 5.8.0 installation.


#WGET, UNTAR & INSTALL THE VARIOUS SUPPORT DISTRIBUTIONS
#
# NOTE: Yes, I do know that CPAN can do this automatically but I am a bit of a freak who likes to confirm
# the exact version I am getting.
#


#CREATE A TEMP DIR FOR THE TAR FILES
rm -rf /tmp/20031011GRAPH/
mkdir /tmp/20031011GRAPH/
cd /tmp/20031011GRAPH/

#GET ALL THE TAR FILES
wget http://www.peregrinehw.com/downloads/MIMEDefang/MLDBM-2.01.tar.gz
wget http://www.peregrinehw.com/downloads/MIMEDefang/File-ReadBackwards-1.00.tar.gz
wget http://www.peregrinehw.com/downloads/MIMEDefang/TimeDate-1.16.tar.gz
wget http://www.bl.org/~jpk/graphdefang/download/graphdefang-0.9.tgz
#IF AUTHORS SITE IS DOWN A MIRROR COPY IS HERE
#wget http://www.peregrinehw.com/downloads/MIMEDefang/graphdefang-0.9.tgz
wget http://www.peregrinehw.com/downloads/MIMEDefang/graphdefang-Makefile.PL

#CLEAR OUT OLD SOURCE
rm -rf /usr/src/graphdefang-0.*
rm -rf /usr/src/File-ReadBackwards-1.*
rm -rf /usr/src/TimeDate-1.*
rm -rf /usr/src/MLDBM-2*


#INSTALL: File::ReadBackwards
#
#HOMEPAGE: http://search.cpan.org/~uri/File-ReadBackwards-1.00/
	cd /usr/src
	tar zxvf /tmp/20031011GRAPH/File-ReadBackwards-1.00.tar.gz
	cd File-ReadBackwards-1.00
        perl Makefile.PL
        make
        make test
        make install


#INSTALL: TimeDate (which installs Date::Parse & Date::Format)
#
#HOMEPAGE: http://search.cpan.org/~gbarr/TimeDate-1.16/
	cd /usr/src
        tar zxvf /tmp/20031011GRAPH/TimeDate-1.16.tar.gz
	cd TimeDate-1.16
	perl Makefile.PL
        make
        make test
        make install

#INSTALL: MLDBM
#
#HOMEPAGE: http://search.cpan.org/~chamas/MLDBM-2.01/
	cd /usr/src
        tar zxvf /tmp/20031011GRAPH/MLDBM-2.01.tar.gz
	cd MLDBM-2.01
	perl Makefile.PL
        make
        make test
        make install

#INSTALL: GraphDefang
#
#HOMEPAGE: http://www.bl.org/~jpk/graphdefang/

#NOTE: THE PROGRAM IS SIMPLY UNTARRED AT IT'S LOCATION TO RUN
	cd /usr/local/
	tar zxvf /tmp/20031011GRAPH/graphdefang-0.9.tgz --no-same-owner
        ln -s graphdefang-0.9/ graphdefang
	cd /usr/local/graphdefang

        #CHECK PREREQ'S AND INSTALL MAN FILES
	cp /tmp/20031011GRAPH/graphdefang-Makefile.PL Makefile.PL
	perl Makefile.PL
	make
	make install

	cp graphdefang-config-mimedefang-example graphdefang-config
	vi graphdefang-config
	#Set $DATAFILE & $OUTPUT_DIR
	#NOTE: $OUTPUT_DIR should be a published web directory

        #ASSUMING YOUR APACHE IS SETUP FOR PHP/PERL PROPERLY, YOU CAN NOW DO THIS
        #cp web/index.php & web/graphdefang.cgi to published web directory
	#set the $OUTPUT_DIR in index.php
        #set the $GRAPHDEFANGDIR = '/usr/local/graphdefang'

        #NOTE: BUG FIX
	#add 'my %TZ;' at the top of graphdefanglib.pl to prevent a Perl error when using the web/graphdefang.cgi

        #ADD GRAPHDEFANG.PL TO CRONTAB	
	1,16,31,46 * * * * root /usr/local/graphdefang/graphdefang.pl

	#RUN graphdefang.pl and you should be working
	

#REMOVE THE TEMPORARY FILES
rm -rf /tmp/20031011GRAPH/