AVG Linux E-mail Server User manual

www.grisoft.com

AVG Linux Email Server / User Manual

AVG 7.1 for Linux E-mail Server

User Manual

Document revision 71.7 (15.6.2006)

Data Security, Inc. Created 1991.

<[email protected]>

This product includes Flex software developed by the University of California, Berkeley and its

All other trademarks are property of their respective owners.

www.grisoft.com

AVG Linux Email Server / User Manual

Contents

1. Introduction........................................................................................... 3

2. Before Installation................................................................................. 4

2.1. Prerequisites .................................................................................... 4

2.2. Installation Package .......................................................................... 5

3. Installation and Launch ......................................................................... 6

4. Third Party Products ............................................................................ 10

4.1. AVG Anti-Virus Vendor Patches ..........................................................10

4.2. AMaViS...........................................................................................11

4.3. Qmail-Scanner.................................................................................13

4.4. Testing the Installation .....................................................................18

5. E-mail Scanning ................................................................................... 19

5.1. General Principles ............................................................................19

5.2. Performance and Resource Usage.......................................................19

5.3. Using Unix Socket for an Extra Security...............................................20

6. Commercial E-mail Servers .................................................................. 21

6.1. AVG for Lotus Notes/Domino Server Installation and Maintenance...........21

6.2. AVG for Kerio MailServer Maintenance.................................................29

7. Standalone Command Line Modules..................................................... 33

7.1. AVGSCAN Command.........................................................................33

7.2. AVGUPDATE Command .....................................................................36

7.3. On-access Scanner...........................................................................40

7.4. Service Signals ................................................................................42

8. Configuration File................................................................................. 43

8.1. AvgCommon....................................................................................43

8.2. OnAccessScanner.............................................................................44

8.3. AvgDaemon ....................................................................................44

8.4. AvgUpdate ......................................................................................45

9. FAQ and Technical Support .................................................................. 47

www.grisoft.com

AVG Linux Email Server / User Manual

1. Introduction

This User Manual is the full documentation describing AVG for Linux E-mail

Server.

a) AVG for Linux E-mail Server Kernel Features

AVG for Linux E-mail Server is a product based on the AVG for Linux

scanning kernel. The AVG for Linux kernel provides comprehensive and

reliable protection against viruses for Linux powered machines. It offers many

features, such as scheduled and on-demand scanning of folders, files, and

common archive types for possible virus infection. You can also perform a

scheduled or on-demand update of your AVG Anti-Virus either from the

Internet or from local update sources.

b) AVG for Linux E-mail Server E-mail Scanning Features

The incoming and outgoing e-mail messages processed by the supported mail

transport agents (MTA) are watched by constantly running AVG Anti-Virus

process (memory resident scanning daemon). This means the e-mail spooling

queues are protected and scanned regularly by AVG for Linux E-mail

Server. The AVG Anti-Virus e-mail scanning performance can be easily

controlled and configured using AVG for Linux daemon signals and

comprehensive configuration file parameters.

c) AVG for Linux E-mail Server – Command Line Modules

Powerful standalone command line modules are also included in the AVG for

Linux E-mail Server installation. You can perform all possible on-demand file

system tests and updates using these modules. They can be also utilized

within for example the cron utility in order to schedule a regular automatic

test or update.

www.grisoft.com

AVG Linux Email Server / User Manual

2. Before Installation

2.1. Prerequisites

Before installing AVG for Linux E-mail Server you must verify that your system

meets the following requirements:

a) Libraries

The following libraries are required in order to ensure the AVG for Linux

kernel can be installed and run properly:

olibc.so.6

b) Open Source E-mail Servers Supported

osendmail

The traditional sendmail mail transport agent (MTA, Linux synonym

for lightweight e-mail server) is included in most modern Linux

distributions. The latest version is also available for free at

http://www.sendmail.org.

oqmail

The latest version is available for free at http://cr.yp.to/qmail.html;

an extensive description of download, installation, and maintenance

issues related to qmail is also provided at http://www.lifewithqmail.org.

opostfix

The postfix MTA is a popular alternative to the widely used sendmail

e-mail server; the latest version is available for free at

http://www.postfix.org/.

oexim

This MTA can be also used as replacement for the common

sendmail e-mail server, although its configuration and maintenance

principles differ; the latest version of the exim e-mail server is available

for free at http://www.exim.org.

c) Commercial E-mail Servers Supported

oLotus Notes/Domino Server for Linux

oKerio MailServer for Linux

d) AMaViS – A Mail Virus Scanner

One of the varieties of AMaViS (amavis, amavisd, amavisd-new or

amavis-ng) is needed for the sendmail, postfix,exim and qmail mail

transport agents in order to enable e-mail scanning with the use of AVG for

Linux E-mail Server. AMaViS is available for free at http://www.amavis.org.

Note: We recommend using the amavisd-new scanner which offers the best

compatibility with AVG for Linux E-mail Server and better overall

performance for all supported mail transport agents.

www.grisoft.com

AVG Linux Email Server / User Manual

Refer to chapter 4.2 Third Party Products/AMaViS to see how to install the

AMaViS scanner, and how to integrate it with AVG for Linux E-mail Server.

e) Qmail-Scanner

If you use the qmail MTA, an alternative solution to AMaVis mail virus

scanner is

Qmail-Scanner – the e-mail content scanner designed to be used exclusively

with qmail. Qmail-Scanner is available for free at http://qmail-

scanner.sourceforge.net/.

Refer to section 4.3 Third Party Products/Qmail-Scanner to see how to install

the Qmail-Scanner mail virus scanner and how to integrate it with AVG for

Linux E-mail Server.

f) DAZUKO Kernel Module

The DAZUKO kernel module is necessary for the proper function of the AVG

for Linux E-mail Server on-access scanner. DAZUKO is available for free at

http://www.dazuko.org.

Refer to section 7.3 Standalone Command Line Modules/On-access Scanner

for detailed information on this topic.

2.2. Installation Package

AVG for Linux E-mail Server installation packages are available on the installation

CD in the form of RPM packages for various Linux distributions, or in the form of a

precompiled .tar.gz package. You can also download the latest appropriate package

version from http://www.grisoft.com,Download/Programs section.

www.grisoft.com

AVG Linux Email Server / User Manual

3. Installation and Launch

AVG for Linux E-mail Server installation packages are provided as RPM files or

.tar.gz package.

zFor the installation from the RPM file, use the

$ rpm -i avg71{edition}-r{version}-a{version of avi}.i386.rpm

command in your shell (accessible for example using the xterm application

within your X window system).

For the installation from the .tar.gz package, use the

z$ tar -xvzf avg71{edition}-r{version}-a{version of avi}.i386.tar.gz

command in the directory where the package is located to unpack its content.

Switch to the unpacked avg7-linux directory then and run the

$ ./install.sh

installation script.

Note: The program files of the AVG for Linux E-mail Server versions 11 and older

are installed into the /usr/local/lib/avg7 directory. Even if you perform the full

update of older version of your AVG Anti-Virus, the directory structure remains the

same (ensuring the backwards compatibility). However, all essential components of

AVG for Linux E-mail Server are always updated properly to offer you the

maximum security and reliability.

The versions 12 and newer are comprehensively installed into the /opt/grisoft

directory. Symbolic links are created in various system directories, leading to the

/opt/grisoft directory subtree. If you want to upgrade the old directory structure,

you must completely reinstall your AVG for Linux E-mail Server. Note that in this

documentation is always described the preferred newer location of AVG for Linux

E-mail Server installation!

In the installation packages' names:

zthe version stands for the minor version number of AVG for Linux E-mail

Server,

zthe distribution string stands for the specification of Linux distribution (if

necessary to distinguish it) which is the package intended for,

zthe specification string stands for the AVG Anti-Virus internal virus

database specification number.

Installation of GUI from a Specific Package:

Graphical user interface (GUI) can be installed from specific packages, found at

http://www.grisoft.com,Download/Programs section.

zYou can install GUI from a .tar.gz package as follows (for distributions that do

not support RPM installation):

Download latest .tar.gz and unpack it:

www.grisoft.com

AVG Linux Email Server / User Manual

# tar xzvf avggui-1.0-{release}.i386.tar.gz

Change directory to avggui:

# cd avggui1

Run the installation script as root then:

$ ./install.sh

zIf your distribution supports it, you can install GUI from RPM package:

Download latest rpm and install it:

# rpm -i avggui-1.0-{release}.i386.rpm

Launch the /opt/grisoft/avggui/bin/avggui_update_licinfo.sh script as root

for updating license information after installation.

Note: You can configure PAM authentication (used in avggui run by a non-root user

when changing license information) in the file /etc/pam.d/avggui.

a) Distributions Currently Supported

Distribution Installation package

Mandrake Linux, Red

Hat, Red Flag, Fedora

Core and other

systems supporting

the RPM packager

utility

avg71{edition}-r{version}-a{version of

avi}.i386.rpm

Any other Linux

distribution (e. g.

Debian, Slackware,

Gentoo etc.)

avg71{edition}-r{version}-a{version of

avi}.i386.tar.gz

b) The Installation Process

The installation process will automatically determine all features of your

system and will perform the proper installation of AVG for Linux E-mail

Server on your computer. Perform installation from the packages mentioned

in the table above to also install the AVG for Linux E-mail Server command

line modules (besides the e-mail scanning daemons).

(See chapter 7. Standalone Command Line Modules for detailed information on

this topic).

www.grisoft.com

AVG Linux Email Server / User Manual

c) Product Registration

After the installation process you need to register your AVG for Linux E-mail

Server unless it has been registered already during the installation process;

this applies to special packages for AVG Anti-Virus vendor partners.

The registration can be performed by launching the

$ avgscan -register

command in your shell.

(See chapter 7.1 Standalone Command Line Modules/AVGSCAN Command for

details).

d) Launching the E-mail Scanning Daemon

Having installed and registered your AVG for Linux E-mail Server you must

start the AVG for Linux services. These services completely cover both e-mail

and on-access scanning modules that run as memory resident daemons. The

daemons can be controlled using the signal mechanism and AVG for Linux E-

mail Server configuration file.

(See chapters 7.4 Standalone Command Line Modules/Service Signals and 8.

Configuration File for detailed information).

Launch the services as root (only root can send signals to daemons):

# /etc/init.d/avgd start

If you are not logged in as root, the command responds with respective

warning.

You can use the

$ su

command and apply the superuser password to change your identity to the

root.

Note: The fact you are logged in as root is usually indicated by the '#'

character at the beginning of your prompt. The normal user identity is

indicated by the '$' character.

See chapter 5. E-mail Scanning for detailed information on the e-mail

scanning daemon.

Note: The e-mail scanning daemon serves its purpose only when a mail

transport agent and possibly the necessary third party software are present

and properly configured! See chapter 4. Third Party Products for basic

information on how to install and setup additional tools needed to enable the

e-mail anti-virus protection with AVG for Linux E-mail Server.

www.grisoft.com

AVG Linux Email Server / User Manual

For proper function of the on-access scanning daemon the DAZUKO kernel

module is required. Refer to section 7.3 Standalone Command Line

Modules/On-access Scanner for detailed information on this topic.

The included command line modules can be operated as described in chapter

7. Standalone Command Line Modules.

www.grisoft.com

AVG Linux Email Server / User Manual

4. Third Party Products

Third party software is needed to preprocess incoming and outgoing e-mail

messages content before they can be scanned by AVG for Linux E-mail Server.

Two solutions are available for particular e-mail servers – the AMaViS and the

Qmail-Scanner security packages.

Both of these packages require AVG for Linux E-mail Server and optionally some

AVG Anti-Virus vendor patches to be installed before attempting to install and

configure them properly on your system. The AMaViS e-mail content scanner can

be used with the sendmail, postfix, qmail and exim mail transport agents; the

Qmail-Scanner can be used with qmail only.

Supported commercial e-mail servers (Lotus Notes/Domino and Kerio

MailServer) do not require such tools. See chapter 6. Commercial E-mail Servers

for more information on this topic.

4.1. AVG Anti-Virus Vendor Patches

Before installing the AMaViS package amavis (various versions supported) you

must apply the AVG Anti-Virus patch. Supposing you have unpacked the

installation file, switch to the unpacked directory, copy the amavis-{version}-

avg.patch file there (included in the AVG for Linux

E-mail Server installation package), and apply the patch using the

$ patch -p1 < amavis-{version}-avg.patch

command.

Run autoconf with the

$ autoconf

command.

Then create the aclocal.m4 file using the

$ touch aclocal.m4

command and continue with the installation as described in chapter 4.2 Third Party

Products/AMaViS.

Note: The patch is needed only for the amavis variant of AMaViS. For the version

‘p7’ and higher of the recommended amavisd-new you just have to uncomment

the AVG Anti-Virus related lines in the amavisd.conf file. For older versions, use

the respective amavisd-new patch

Besides the amavis patch, the Qmail-Scanner (versions 1.20, 1.22) patch is also

needed when you are planning to install this tool. Switch to the unpacked Qmail-

Scanner installation directory and copy the qmail-scanner-{version}-avg.patch

file (included in the AVG for Linux E-mail Server installation package) there.

Apply the patch using the

This manual suits for next models

Table of contents

Other AVG Software manuals

AVG

AVG 9 INTERNET SECURITY - REVISED 11-2009 User manual

AVG

AVG ANTI-VIRUS 2011 - REV 2011.06 User manual

AVG

AVG 9.0 EMAIL SERVER EDITION - V 90.4 User manual

AVG

AVG ANTI-VIRUS BUSINESS EDITION 9.0 - REV 90.6 User manual

AVG

AVG 8.5 ANTI-VIRUS PLUS FIREWALL User manual

AVG

AVG 9.0 FILE SERVER - REV 90.1 User manual

AVG

AVG ANTI-VIRUS 2011 - REV 2011.09 User manual

AVG

AVG AVG 8.5 ANTI-VIRUS PLUS FIREWALL - REV 85.8 User manual

AVG

AVG ANTI-VIRUS FREE EDITION 9.0 User manual

AVG

AVG 8.5 FILE SERVER EDITION - V 85.5 User manual

AVG

AVG ANTI VIRUS PLUS FIREWALL 9 - REV 90.31 User manual

AVG

AVG ANTI-VIRUS FREE EDITION 9.0 User manual

AVG

AVG 8.5 ANTI-VIRUS - REV 85.8 User manual

AVG

AVG 8.5 ANTI-VIRUS - LINUX-FREEBSD REV 85.2 User manual

AVG

AVG ANTI-VIRUS 2011 - REV 2011.10 User manual

AVG

AVG 9.0 FILE SERVER - V 90.8 User manual

AVG

AVG ANTI-VIRUS 2011 - REV 2011.11 User manual

AVG

AVG ANTI-VIRUS BUSINESS EDITION 2011 - REV... User manual

AVG

AVG IDENTITY PROTECTION User manual

AVG

AVG IDENTITY PROTECTION - V 85.3 User manual

AVG

AVG 9 INTERNET SECURITY - REVISED 6-2010 User manual

AVG

AVG ANTI-VIRUS BUSINESS EDITION 2011 - REV... User manual

AVG

AVG 8.5 ANTI-VIRUS - LINUX-FREEBSD REV 85.2 User manual

AVG

AVG IDENTITY PROTECTION - REV 90.5 User manual

Popular Software manuals by other brands

COMPRO

COMPRO COMPROFM manual

Muratec

Muratec OFFICEBRIDGE ONLINE user guide

Oracle

Oracle Contact Center Anywhere 8.1 installation guide

Adobe

Adobe 65007312 - Photoshop Lightroom Programmer's guide

Avaya

Avaya NULL One-X for RIM Blackberry user guide

HP ProLiant BL420c user guide

PS Audio

PS Audio PowerPlay Programming manual

Brady

Brady LOCKOUT PRO 3.0 Administrator's guide

Avaya

Avaya Interaction Center user guide

Texas Instruments

Texas Instruments TI-83 Plus Silver Edition Guide book

Novell

Novell GROUPWISE 8 - INTERNET AGENT manual

Oracle

Oracle Application 9i Configuration guide

Acer

Acer RDM user guide

Canon

Canon Vixia HF21 instruction manual

Canon

Canon ZR950 instruction manual

Samsung

Samsung Auto Backup user manual

Polycom

Polycom Vortex EF2201 Application note

Brocade Communications Systems

Brocade Communications Systems Brocade 8/12c user manual