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
	- Linux kernel version >= 2.2
	- glibc version >= 2.1.3
	- rpm version >= 3.0
	- zlib version >= 1.1.3-6
	- ravcore version >= 8.9
	- ravmd version >= 8.4
	- ravpostfix version >= 8.4
	- 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.

3. Installed files
==================	
	The rpm files 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)

/etc/init.d/
/etc/init.d/rpostfix	#this script will start the ravpostfix daemon
/etc/init.d/ravmail		#this script will start the ravmd daemon (for RedHat)
				#for other distributions see section 6 below
/etc/rc.d/rc3.d/
/etc/rc.d/rc3.d/S75ravmail	#link to the above script
/etc/rc.d/rc5.d/
/etc/rc.d/rc5.d/S75ravmail	#link to the above script

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

/etc/opt/rav/ravmd.conf		#configuration file for ravmd

/var/opt/rav/ravmd.key		#key registration file for ravmd

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

	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/opt/rav/log/ directory. 

	The local SMTP server filter (ravpostfix) will log messages in the system
	mail info log file.

4. Configuration
================
	Configuration resides in /etc/opt/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 the ravmd.conf(5) man page and the comments from the 
	ravmd.conf file for more information.

5. Updating
===========
	We provide daily updates for viruses signatures databases.
	Automatic update:
	If you have installed RAV with rpm then in /etc/cron.hourly/
	or /etc/daily should be a shell script (ravmdupdate.sh).
	This program takes care of downloading 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.

	Manual update:
	From a root prompt run:
	/opt/rav/bin/ravupdate
	or use the old update function from 'ravav':
	/opt/rav/bin/ravav --update engine
	After the update process completed successfully you must restart the daemon:
	/etc/init.d/ravmail restart
	or
	killall -HUP ravmd
	
	You DON'T need to stop the mail server when restarting the RAV AntiVirus 
	scan daemon.

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

	The daemon starts with:
		/etc/init.d/ravmail start		(in RedHat)
	or
		/opt/rav/bin/ravmd  		(in other Linux distributions)
	
	You can restart ravmd with:
		/etc/init.d/ravmail restart	(for RedHat)
	or																	(in other Linux distributions)
		killall -HUP ravmd

	If you can't use the 'ravmail' script to start 'ravmd' then you must
	add next line:
	/opt/rav/bin/ravmd
	to one of your boot scripts, so that the RAV AntiVirus daemon starts
	when your system reboots.

	The SMTP filter daemon (ravpostfix) is started from 
	/etc/init.d/rpostfix script file when the system starts.

	The daemon starts with:
		/etc/init.d/rpostfix start		(in RedHat)
	or
		/opt/rav/bin/ravpostfix -s 10025 -c 10026 (in other Linux distributions)
	
	You can restart ravpostfix with:
		/etc/init.d/rpostfix restart		(in RedHat)

	If you can't use the 'rpostfix' script to start 'ravpostfix' then you
	must add line:
	/opt/rav/bin/ravpostfix -s 10025 -c 10026
	to one of your boot scripts, so that the SMTP filter starts 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/opt/rav directory.
	After you copied the key file you must restart RAV AntiVirus
	daemon:
		killall -HUP ravmd
	Then look in mail log file to see if registration was successfully
	finished.
