Mailscanner quick install notes

2002-11-22

This describes the steps necessary to install mailscanner on
Red Hat 8.0.  This can be done by running the install.sh
script from the mailscanner distribution (preferred), or if
discrete separate packages are provided then the following
applies.


Service profile


pkg:		mailscanner

dependencies:	sendmail (and others indicated below)
		a supported anti-virus program

ports:		25

service:	MailScanner

daemons:	/usr/sbin/sendmail (two instances)
		/usr/sbin/MailScanner

configuration:	/etc/MailScanner/MailScanner.conf

notes:		The instance of sendmail which receives
		incoming mail queues it to /var/spool/mqueue.in.
		MailScanner uses /var/spool/MailScanner/incoming




Install sequence

1. Load dependencies.  Mailscanner depends upon the following
packages which are not part of Red Hat 8.0

perl-IO-stringy-2.108-1.noarch.rpm
perl-MailTools-1.50-1.noarch.rpm
perl-MIME-tools-5.411-pl4.2.noarch.rpm
perl-TimeDate-1.1301-2.noarch.rpm
tnef-1.1.1-2.i386.rpm

The source of these packages is included in the MailScanner
distribution. To build and install each one, you should use commands
like

rpmbuild --rebuild perl-IO-stringy-2.108-1.src.rpm
rpm -Uvh /usr/src/redhat/RPMS/noarch/perl-IO-stringy-2.108-1.noarch.rpm

2. Install a supported anti-virus package.

3. Install mailscanner package.

4. Adapt configuration to suit AV package.  Edit /etc/MailScanner/
MailScanner.conf and set the "Virus Scanners =" line to correspond
with the installed AV package(s), eg

     Virus Scanners = f-secure

5. Adapt the AV wrapper to suit.  For each of the supported
AV packages there is a wrapper script in /usr/lib/MailScanner/, eg
/usr/lib/MailScanner/f-secure-wrapper.  It may be necessary to
edit this file so that the path of the executable agrees with
the installed location, eg for F-Secure,

    PackageDir=/usr/bin/

is appropriate if the fsav executable is /usr/bin/fsav.
If your scanner is supported, but there is no wrapper for it, then
edit /etc/MailScanner/virus.scanners.conf to ensure the correct
location is set for your scanner's command-line scanner program.

6. Stop any old versions of MailScanner.

7. Stop and disable your original sendmail setup. To do this,

    service sendmail stop
    chkconfig sendmail off
    chkconfig --level 2345 sendmail off

8. Enable and start your new MailScanner setup. To do this,

    chkconfig MailScanner on
    chkconfig --level 2345 MailScanner on
    service MailScanner start
