RAV AntiVirus v8 for Postfix
============================

Contents:

1. Hardware requirements
2. Software requirements
3. Installed files
4. Configuration
5. Updating
6. Start/Stop RAV AntiVirus daemon and SMTP filter daemon
7. Evaluation
8. Registration

1. Hardware requirements
========================
	- Compatible Intel CPU (>= 150 Mhz)
	- RAM >= 32 Mb

2. Software requirements
========================
	- Postfix version >= 20000531
	- FreeBSD >=4.1
	- in order to send warning mails as set in scanning configuration,
	you must have a MTA running on local machine and listening on port 25.
	In order warning mails don't be scanned you must set in ravmd.conf:
	smtp_port=10026

3. Installed files
==================	
	The packages provided will install on your computer the following
	directories, files and accounts:

ravms				#an user account used to run the filter and to
					#send warning mails when a virus was found
					#(if you set this option)

/usr/local/etc/rc.d/
/usr/local/etc/rc.d/ravmail.sh		#this script will start/stop the ravmd daemon
/usr/local/etc/rc.d/rpostfix.sh		#this script will start/stop the ravpostfix daemon

/usr/local/bin/ravmd		#RAV daemon, it load the RAV engine and
				#scans for viruses 
/usr/local/bin/ravmdupdate.sh	#a script used for daily updates
/usr/local/bin/ravpostfix		#the filter executed by Postfix to
				#scan all mail files
/usr/local/bin/ravav		#an executable used to download update files
				#it can be used to scan files too
				#type 'ravav -h' for help 

/usr/local/etc/rav/ravmd.conf		#configuration file for ravmd

/var/rav/
/var/rav/ravmd.key		#key registration file for ravmd
/var/rav/run/		#contains RAV sockets and pid files
/var/rav/bulk/		#keeps saved bulk mails
/var/rav/log/		#default location of log files
/var/rav/tmp/		#temporary mail files
/var/rav/quarantine/	#by default here are saved
				#the infected/suspicious files
/var/rav/rave/		#the directory of RAV engine files
/var/rav/rave/*		#the engine files

	RAV AntiVirus filter for postfix (ravpostfix) will log messages
	in the system mail info log	file (see value for mail.* or mail.info
	from 'syslog.conf' file).
	If RAV AntiVirus scanning daemon (ravmd) is started with the '--syslog'
	parameter in the command line it will log messages in the system mail
	info log  file (see value for mail.* or mail.info from 'syslog.conf'
	file). Keep an eye on that file to watch   over the scanning process.
	Otherwise, by default, the log files are located in the
	/var/rav/log/ directory. 

4. Configuration
================
	Configuration resides in /usr/local/etc/rav/ravmd.conf file. RAV
	AntiVirus scanning daemon (ravmd) reads this configuration when it is
	started or restarted. So if you modify something in ravmd.conf then
	you must send a HUP signal to ravmd (see section 6).

	Please read ravmd.conf(5) man page and the comments from ravmd.conf
	file for more information.

5. Updating
===========
	We provide daily updates for viruses signatures databases.
	Automatic update:

	The /usr/local/bin/ravmdupdate.sh script takes care of downloading
	the new files and restarting RAV AntiVirus scanning daemon. The results
	of these processes will be sent to an e-mail account specified in
	ADMIN_ADDRESS variable from the	ravmdupdate.sh script.
	You have to create a cron job in order to execute the ravmdupdate.sh
	script file periodically. We recommend to run it every half an hour.
	
	Manual update:
	
	From a root prompt run:
	/usr/local/bin/ravupdate
	(you can configure the 'ravupdate' utility from the '/usr/local/etc/rav/rup.conf' file)
	or use the old update function from 'ravav':
	/usr/local/bin/ravav --update engine

	After the update process successfully completed you must
	restart the daemon:	 
	killall -HUP ravmd
	or
	/usr/local/etc/rc.d/ravmail.sh reload

	You DO NOT need to stop the mail server when restarting
	the RAV AntiVirus scan daemon.

6. Start/Stop RAV AntiVirus daemon
==================================
	The daemon must be restarted after every databases updates or every
	modification in ravmd.conf file.

	The daemon starts with:
	/usr/local/bin/ravmd
	or
	/usr/local/etc/rc.d/ravmail.sh start

	The configuration and scanning engine are reloaded with:
	killall -HUP ravmd 
	or
	/usr/local/etc/rc.d/ravmail.sh reload

	You can restart ravmd with:
	/usr/local/etc/rc.d/ravmail.sh restart

	RAV AntiVirus daemon will be started by /usr/local/etc/rc.d/ravmail.sh
	script when your system reboots.

	The ravpostfix daemon starts with:
	/usr/local/bin/ravpostfix -s 10025 -c 10026
	or
	/usr/local/etc/rc.d/rpostfix.sh start

	ravpostfix daemon will be started by the /usr/local/etc/rc.d/rpostfix.sh
	script when your system reboots.

7. Evaluation
=============
	By downloading the evaluation version from 
	http://www.ravantivirus.com you will be able to use all the
	functions of the product (scanning, cleaning, daily updates) for
	30 days and for two different mail domains specified in the configuration
	file.

	VERY IMPORTANT:
	For RAV, a 'domain' is the string following the '@' symbol in an e-mail
	address.

8. Registration
===============
	After evaluation you may purchase the product to work for a
	number of mail domains. The price is scalable to the number of 
	domains	protected by RAV AntiVirus. After purchase you'll receive 
	an activation key from GeCAD Software which will enable you to 
	configure the antivirus for the specified number of domains.

	The activation key will be sent to you by e-mail as a file which
	should be copied in the /var/rav directory.
	After you copied the key file you must restart RAV AntiVirus
	daemon:
	killall -HUP ravmd
	Look in mail log file to see if registration was successfully
	finished.
