Setting Up the Virus Scanner AVMailGate on Openexchange Server

Support knowledgebase (rsimai_slox_avmailgate)
Applies to

Openexchange Server: Version 4

Situation

You want to install H+BEDV's virus scanner AVMailGate on Openexchange Server 4

Requisites

First, you have to decide which one of the features configurable through the web interface you want to deploy: If the configuration is subsequently modified via the web interface, the changes described below will be overwritten and your system might no longer work!

Procedure

AVMailGate can work with various MTAs (Mail Transfer Agents). Although these instructions specifically refer to Openexchange Server 4, they can also be applied to other Postfix systems.
  1. Installation

    Install the RPM avmailgate.rpm by means of YaST2 or from the command line with rpm -Uhv package_name from the UL CD1.
  2. Stop Postfix

    rcpostfix stop
    
  3. With or Without SPAM Filter

    Depending on whether the spam filter is activated or not, proceed as described below:
  4. Daemon Activation at System Startup

    Use YaST's runlevel editor to insert the service avgate for runlevels 3 and 5, or execute the command
    openexchange:~ # insserv -d -f /etc/init.d/avgate
    
  5. Scanner's SMTP Configuration

    Open the file /etc/avmailgate.conf with an editor and change the values for the variables ListenAddress and ForwardTo:
    ListenAddress   127.0.0.1  port 10025
    ForwardTo       SMTP: localhost port 10026
    
  6. Mail Messages to the Mailadmin

    Make sure that /etc/aliases contains an entry for 'avmailgate'. If this is not the case, insert it:
    avmailgate:     root
    
    Then execute the command:
    openexchange:~ # newaliases
    
  7. Starting Both Services

    Start both services with the commands
    openexchange:~ # rcavgate start
    openexchange:~ # rcpostfix start
    

Testing the Installation

You can test the operation of the virus scanner by way of a test pattern like eicar.
Refer to the URL below for more information.

  1. Open a text file
  2. Insert the following line in the file
    X5O!P%@AP[4\PZX54(P^)7CC)7}$EICAR-STANDARD-ANTIVIRUS-TEST-FILE!$H+H*
  3. Save the file as eicar.com
  4. Send this file as an attachment to any user in the system.
The mailadmin, the sender (and, depending on the configuration in /etc/avmailgate.conf, eventually the receiver), should now receive an e-mail message warning of a possible virus. In addition, the mailadmin receives further information on how to delete or deliver the message.
This is not an actual virus but only a test that can be performed on most virus scanners. However, never send this test file to external mail servers!

More information on this test is available at http://www.eicar.org/anti_virus_test_file.htm

Full Version, Updates, Help

SuSE does not provide any updates or software support for the virus scanner. To obtain a license for the product, please contact the manufacturer H+BEDV http://www.antivir.de/ directly. Without a valid key, the scanner writes its signature in the messages.
Some documentation on AVMailGate is locally available on your system at /usr/share/doc/packages/avmailgate/
See also:
o Setting Up AMaViS on the Openexchange Server

Keywords: SLOX, OPENEXCHANGESERVER, VIRUS, VIRUS SCANNER, AVMAILGATE

Categories: SuSE Linux IMAP Server

Feedback welcome: Send Mail to srsimai@suse.de (Please give the following subject: SDB-rsimai_slox_avmailgate)
SDB-rsimai_slox_avmailgate, Copyright SuSE Linux AG, Nürnberg, Germany - Version: 03. Mar 2003
SuSE Linux AG - Last generated: 03. Mar 2003 by afaber (sdb_gen 1.40.0)