Installation guide

Requirement

SendmailAnalyzer can work in any platform where Sendmail and Perl could run. What you need is a modern Perl distribution 5.8.x or more is good but older version should also work.

You need the following Perl modules. If they are not yet include in your OS distribution you can always find them at http://search.cpan.org/

        MIME::Base64;
        MIME::QuotedPrint;
        GD
        GD::Graph
        GD::TextUtil
        GD::Graph::bars3d;

Or if you have Internet access from your server, you can execute the following command to install GD::Graph::bars3d and all its dependencies.

	perl -MCPAN -e 'install GD::Graph::bars3d'

The graph output are generated using the libgd and libpng. You can get them at the following places:

	http://www.libgd.org/
	http://www.libpng.org/

Installation

Generic install

Here is the generic installation steps, but if you want you can create and install your own distribution package, see "Package install" bellow.

1) Unpack the distribution tarball in the desired location as follow:

        tar xzf sendmailanalyzer-x.x.tar.gz
        cd sendmailanalyzer-x.x/
        perl Makefile.PL
        make && make install

2) Follow the instruction given at the end of install. With this default install everything will be installed under /usr/local/sendmailanalyzer.

3) Edit sendmailanalyzer.conf file to customize your SendmailAnalyzer reports. See the configuration file and CONFIGURATION section bellow for usage.

Package install

In the packaging/ directory you will find all scripts and file to generate binary RPM, Slackware and Debian package. See README in this directory.

Custom install

You can create your fully customized SendmailAnalyzer installation by using the Makefile.PL Perl script. Here is a sample:

	perl Makefile.PL \
		LOGFILE=/var/log/maillog \
		BINDIR=/usr/bin \
		CONFDIR=/etc \
		PIDDIR=/var/run \
		BASEDIR=/var/lib/sendmailanalyzer \
		HTMLDIR=/var/www/sendmailanalyzer \
		MANDIR=/usr/man/man3 \
		DOCDIR=/usr/share/doc/sendmailanalyzer

If you want to build a distro package, there are two other options that you may use. The QUIET option is to tell to Makefile.PL to not show the default post install README. The DESTDIR is to create and install all files in a package build base directory. For example for Fedora RPM, thing may look like that:

	# Make Perl and SendmailAnalyzer distrib files
	%{__perl} Makefile.PL \
	    INSTALLDIRS=vendor \
	    QUIET=1 \
	    LOGFILE=/var/log/maillog \
	    BINDIR=%{_bindir} \
	    CONFDIR=%{_sysconfdir} \
	    PIDDIR=%{rundir} \
	    BASEDIR=%{_localstatedir}/lib/%{uname} \
	    HTMLDIR=%{webdir} \
	    MANDIR=%{_mandir}/man3 \
	    DOCDIR=%{_docdir}/%{uname}-%{version} \
	    DESTDIR=%{buildroot} < /dev/null

See spec file in packaging/RPM for full RPM build script.