VIRGE INSTALLATION

===================================================================
NOTE: Please read README.POSTFIX_PROXY if you want to install Virge
      with Postfix.
===================================================================

This is the tricky part :)

First, make sure you have what is needed for Virge to run:

- Sendmail (8.10.x or 8.11.x or 8.12.x)
- Procmail

If you want to scan for viruses, you will need at least one of:

- Sophie ( http://www.vanja.com/tools/ )
- Trophie ( http://www.vanja.com/tools/ )
- AVPDaemon ( http://www.avp.ch )

Virge has been tested on:

- Linux (2.2.x and 2.4.x kernels)
- Solaris 2.7 (Sparc) with gcc
- Solaris 2.8 (x86) with gcc
- HP-UX 10.20 with gcc
- FreeBSD 4.3 with gcc
- OpenBSD 2.9 with gcc

I really welcome any feedback (bad or good) on Virge functionality.

Steps for installation:

Type './configure'

If you wish to change default location where Virge looks for config
file, edit "virge.h" file and modify the V_CONFIG_PATH list of paths.

You can also invoke Virge with "-c" switch if you wish to use alternative
configuration file

If everything went okay, type 'make'

If there were no errors, you will have 'virge' binary in current
directory.

In "etc/" directory, you will find sample "virge.conf" file. Take a
look at it, and modify it according to your needs. Make sure you
read "doc/configuration.txt" before configuring Virge.

In source directory, you will find 'virge.conf' file. By default,
Virge looks for /etc/virge.conf so copy the sample file there. Edit
the configuration file, and set the options you need. Also, there are
comments in the configuration file that should help you understand
each option.

NOTE: procmail must be setuid root in order for for Virge to work
properly!

Once this all is setup, you can try to execute virge with:

./virge -C

Configuration check should be performed, and problems will be reported.
Also, directories (as specified in "virge.conf" file) will be
created, if they don't exist.

NOTE: you can ignore errors about non-existant logs - logfiles will be
created by Virge, when needed.

If everything was okay, copy 'virge' to '/usr/bin/virge' (for example),
and modify sendmail configuration file. Instead of ...

--
Mlocal, P=/usr/bin/procmail, F=lsDFMAw5:/|@qSPfhn9, S=EnvFromL/HdrFromL, R=EnvToL/HdrToL,
        T=DNS/RFC822/X-Unix,
        A=procmail -Y -a $h -d $u
--

...use...

--
Mlocal, P=/usr/bin/virge, F=lsDFMAw5:/|@qSPfhn9, S=EnvFromL/HdrFromL, R=EnvToL/HdrToL,
        T=DNS/RFC822/X-Unix,
        A=virge -s $f -a $h -d $u
--

You might also want to add 'mail' (or whatever user Virge is running
as) to 'trusted' users list in "sendmail.cf" file, with:

Tmail

(look for 'Troot' - you'll find a section where to add 'Tmail')

You will find sample 'extensions' and 'allow.users' files in 'etc'
directory. 'extensions' file can contain either full filename or
regular expressions. So, if you have:

\.exe$

all files ending with '.exe' will be matched.

If you have 'winmail.dat', then only files called 'winmail.dat' will be
matched. Note that 'some_winmail.dat' will not be matched.

'allowed.users' file contains list of *local* users for which the mails
should not be checked. For example, if you don't want your mail to be
checked for attachments/viruses, simply add it to 'allow.users' file.

Example:

root
admin
foobar

Now, the mail for these 3 users will be delivered immediately, without
any checking.

Don't forget to install "extensions" file (at least) into 'etc_dir',
as specified in "virge.conf" file.

I have included small "test/" subdirectory, where (as of this writing)
there are 3 mailfiles which you can use with Virge from command line:

virge -f <sender_email_address> -d <local_recipient> < test/test.1
virge -f <sender_email_address> -d <local_recipient> < test/test.2
virge -f <sender_email_address> -d <local_recipient> < test/test.3

In 1st case, mail will be delivered with no problems, since it is plain
text format (no attachments).

In 2nd case, "eicar.com" file is attached (it is NOT A VIRUS), which
will trigger virus alert if AVPDaemon, Sophie or Trophie are used with
Virge. If virus scanning is disabled, then mail will be rewritten and
"eicar.com" removed because of ".com" extension. Please, make sure you
do have "extensions" file in place (/virge/etc/extensions, for example)
before testing these cases. If "extensions" file does not exist, NO
ATTACHMENT CHECKING WILL OCCUR!

In 3rd case, 2 files are attached - "eicar.com" and "eicar.xxx". Both
are the same file, and if the virus scanning is enabled, virus alert
will be triggered. If virus scanning is disabled, then "eicar.com" will
be removed, while "eicar.xxx" will be let through.

Refer to "doc/sophie.txt" and "doc/avp.txt" for more details on using
Sophie, AVPDaemon and Trophie with Virge.
