Installation of QMVC on a QMAIL MTA
===================================

Documentation
-------------
The documents are found in the directory ./doc.

- Read BLURB.qmvc first to have a basic understanding.
- Read SCANNERS.qmvc to get an idea about how QMVC uses AV Scanners.
- Read QMVC_17.html for additional information.


Install the Virus Scanner
-------------------------
Currently supported:
- ClamAV
- F-Secure (3.x / 4.x)
- McAfee 
- Sophos
- Trend-Micro
- CA InoculateIT

Make yourself familiar with the Virus Scanners doing some tests.


Install some necessary UNIX commands
------------------------------------
- ksh (5.2.14)
- file
- grep/egrep
- uudecode

There are different version (ie. gnu) around which slightly differ.


Download and install Dan Bernstein's "mess822"
----------------------------------------------
http://www.cr.yp.to/mess822.html


Download and install Sam Varshavchik's "Maildrop"
------------------------------------------------
http://www.flounder.net/~mrsam/maildrop/

- QMVC needs the 'reformime' program.


(Perhaps) Download and install Christos Zoulas "file" utility
-------------------------------------------------------------
ftp://ftp.astron.com/pub/file/


Configure your AV Scanners
--------------------------
by checking the file conf-scanners and
perhaps adjust the default paths in there.
For ClamAV and FSAV you have several options,
in particular a client/server mode.
For the Daemons, you find superivse run scripts
in the directory ./run.

Caution: If you have added a new AV Scanner post 
	 initial QMVC installation, you have to run 
	 the "install" script again !


Execute the installation script "./install"
------------------------------------------
by default, most actions are logged as "instlog_YYYYMMDD".
It tells you in particular:

- where are the necessary UNIX commands
- who is your effective QMAIL postmaster
- which AV Scanners are recognized.


Post configuration
------------------
Control files (/var/qmvc/control):

- control/filters - the main control file for QMVC's activity.
  Read man qmvc-filters.

- control/scannners - defines which AV Scanners you are using,
  in which order; up to four can be assigned.
  Read man qmvc-scanners.
  Check, whether the file "scanners" is correctly populated.
  The installation routine only looks for standarded paths.
  If you have a customized installation, you have to adjust the paths
  in the configuration file conf-scanners.

- control/mailheader - additional checks on the email header
  and conformance.
  Read qmvc-control.

- control/noscantypes - MIME types to be excluded for AV scanning.
  This file this read, ony if qmvc is called with parameter '-n'.

- control/respmail - include SMTP addresses for responsible persons. 
  Those will be shown in incident E-Mails to SENDERS/RECIPIENTS of
  badmails and infected mails.


Activation of qmvc
------------------
- Include the call of qmvc into all relevant .qmail files 
  ( n particular /var/qmail/alias/.qmail-default):
  |/usr/local/bin/qmvc or
  |qmvc			(/var/qmvc/bin/qmvc --> /usr/local/bin/qmvc) 
  ./Maildir/		(you need to specify this or other delivery mechanisms)

- BUT NEVER into
	.qmail-root
	.qmail-postmaster
	.qmail-mailer-daemon

All changes can be done on a runnig QMAIL system. Read man qmvc.

If something goes wrong, simply comment the call to QMVC with a "#"
in the first column.

Cologne, 2004-05-23
Erwin Hoffmann (feh@fehcom.de)