MailScanner Installation Guide ? Perl

On most modern systems, Perl <http://www.perl.org> will be
pre-installed. If not, it can be downloaded from many locations
including www.perl.org <http://www.perl.org>, and binary distributions
are also available for platforms such as Solaris
<http://www.sunfreeware.com>.

MailScanner has been tested with Perl 5.8 and everything works very well.


    Perl Modules

The following Perl modules are needed by MailScanner:

    * POSIX (ships with perl 5)
    * Sys::Syslog (ships with perl 5)
    * Net-CIDR <http://www.perl.com/cgi-bin/cpan_mod?module=Net::CIDR>
      (I used version 0.08 <../files/modules/Net-CIDR-0.08.tar.gz>)
    * IO-stringy <http://www.zeegee.com/code/perl/IO-stringy/> (I used
      version 2.108 <../files/modules/IO-stringy-2.108.tar.gz>)
    * MIME-Base64
      <http://www.perl.com/cgi-bin/cpan_mod?module=MIME::Base64> (I used
      version 2.12 <../files/modules/MIME-Base64-2.12.tar.gz>)
    * MailTools <http://perl.overmeer.net/> (I used version 1.50
      <../files/modules/MailTools-1.50.tar.gz>)
    * File-Spec <http://www.perl.com/cgi-bin/cpan_mod?module=File::Spec>
      (I used version 0.82 <../files/modules/File-Spec-0.82.tar.gz>)
    * HTML-Tagset
      <http://www.perl.com/cgi-bin/cpan_mod?module=HTML::Tagset> (I used
      version 3.03 <../files/modules/HTML-Tagset-3.03.tar.gz>)
    * HTML-Parser
      <http://www.perl.com/cgi-bin/cpan_mod?module=HTML::Parser> (I used
      version 3.26 <../files/modules/HTML-Parser-3.26.tar.gz>)
    * MIME-tools <http://www.zeegee.com/code/perl/MIME-tools/> *with an
      important security patch <mime-tools-patch.txt>,
      and a 2nd important security patch <mime-tools-patch2.txt>,
      and a 3rd important security patch <mime-tools-patch3.txt>,
      and a 4th important security patch <mime-tools-patch4.txt>*
      (version 5.411, I used version 5.411
      <../files/modules/MIME-tools-5.411.tar.gz> and I advise against
      any of the newer versions)
      *Note:* To make life easier for you, here is a copy already
      patched <../files/modules/MIME-tools-5.411-patched.tar.gz>.
    * File-Temp <http://www.perl.com/cgi-bin/cpan_mod?module=File::Temp>
      (at least version 0.12)
    * Convert-TNEF
      <http://www.perl.com/cgi-bin/cpan_mod?module=Convert::TNEF> (at
      least version 0.17)
    * Net-CIDR <http://www.perl.com/cgi-bin/cpan_mod?module=Net::CIDR>
    * Compress-Zlib
      <http://www.perl.com/cgi-bin/cpan_mod?module=Compress::Zlib>
    * Archive-Zip
      <http://www.perl.com/cgi-bin/cpan_mod?module=Archive::Zip>
    * Convert-BinHex
      <http://www.perl.com/cgi-bin/cpan_mod?module=Convert::BinHex> 

The additional modules are all available from your nearest CPAN
<http://www.cpan.org/> mirror, or from their respective authors' sites
which are linked in the list above.

Install the modules listed above in the order they are given, ensuring
you do the "make test" step for each one to check they work. The steps
required to install each module are contained in their accompanying
documentation.


      Notes

If you are having trouble installing them, check out my hints and tips
<gcc.shtml> page.

In order to apply the patches to MIME-tools, you will have to download
the source (follow the MIME-tools link above), unpack it, apply the 4
patches and then build and install the module by hand. If you don't know
how to apply patches, read "man patch". If you don't know how to install
a Perl module, then read the "Installing" file in the MIME-tools package
you are about to download.

When you do the "make test" step for MIME-tools, do not worry if the
"spamd" tests fail, as MailScanner does not use "spamd" anyway.

------------------------------------------------------------------------
Julian Field <http://www.ecs.soton.ac.uk/info/people/jkf>