
   Vexira Antivirus for Mail servers
   Frequently Asked Questions (FAQ)
   modified June 11, 2003


Q: What is the difference between Vexira Antivirus for Linux server
   and Vexira Antivirus for Mail servers (a.k.a. Vexira MailArmor)?

A: Vexira Antivirus for Linux server or workstation is a command line
   scanner developed to virus protect the local file system from
   executing or storing virus infected files. It enables you to
   perform virus scans on the file system of the server (e.g. if you
   use your Linux server as a file server with Samba). Vexira
   Antivirus for Mail servers is a email virus scanner which checks
   all incoming and outgoing emails (SMTP) on a Linux email server for
   viruses. You can install both virus protection systems on the same
   server but they have different functions.

---------------------------------------------------------------------

Q: How does Vexira Antivirus for Mail servers work?

A: Vexira Antivirus for Mail servers acts as a store-and-forward agent
   whereby the email virus scanning work is shared by two programs
   named vagated and vagatefwd. Vagated receives the emails, filters
   them according to the IP address and places them in a specific
   spool directory. This program can operate as an independent server
   occupying port 25 (SMTP) or being started by the internet super
   daemon 'inetd'. Vagatefwd is the daemon which reads the email
   messages stored in the spool directory, decodes any attachments and
   then starts the Vexira virus scanner. Depending on the result, the
   mails are quarantined or forwarded to the mail transport agent
   (mail server).

   Besides quarantined, deleting or forwarding the infected email, it
   also issues status signals via 'syslog'. The 'postmaster' receives
   a mail with a detailed report, and the sender and receiver can also
   be notified of the infection in addition.

---------------------------------------------------------------------

Q: Which mail transport agents (email servers) does Vexira work with?

A: Vexira works with the most common mail transport agent such as
   Sendmail, Postfix, qmail, Exim, SuSE and others.

---------------------------------------------------------------------

Q: Which Linux, FreeBSD or OpenBSD distributions does Vexira work
   with?

A: Vexira works independently of a particular Linux, FreeBSD, OpenBSD
   distribution. It depends entirely on the mail transport agent.
   Almost all Linux i386, FreeBSD i386 and OpenBSD i386 operating
   systems are supported.
   
   The application is available for downloading as a zipped TAR file
   (TGZ) and can therefore be installed on any compatible system.

---------------------------------------------------------------------

Q: Are there differences between the Linux, FreeBSD or OpenBSD
   versions?

A: Please make a note of the directory containing sendmail (e.g.
   /usr/lib/sendmail or /usr/sbin/sendmail) and enter it accordingly
   in the configuration file vamailarmor.conf ("ForwardTo" entry).

---------------------------------------------------------------------

Q: How often is Vexira updated for new viruses?

A: Updates are provided on a weekly basis or daily as needed for fast
   spreading viruses.
   
   The updating process is built-in to Vexira and can be fully
   automatic for both the virus scanning engine and the virus
   detection database.

---------------------------------------------------------------------

Q: Is the source code of the Vexira programs for Linux freely
   available?

A: No.

---------------------------------------------------------------------

Q: Will Vexira work on anything other than the Intel x86-compatible
   processor?

A: Not yet. As soon as Vexira Antivirus for Linux is ported, Vexira
   Antivirus for Mail servers will be available for other processors
   too.

---------------------------------------------------------------------

Q: How do I configure Sendmail?

A: There are two ways to make Vexira work with Sendmail. The 
   backdoor port redirection method or piping mechanism.
    
   For more details, please refer to the INSTALL and INSTALL.sendmail
   files contained within the archive.

---------------------------------------------------------------------

Q: How do I configure exim?

A: Vexira works with Exim from version 3.0 upwards. Please read and
   follow the instructions in INSTALL and INSTALL.exim

---------------------------------------------------------------------

Q: How do I configure qmail?

A: There are two possible ways of integrating Vexira under qmail. One
   of these is to send emails further through the sendmail wrapper of
   qmail. Follow the installation insrtruction of qmail and read and
   follow the instructions in INSTALL and INSTALL.qmail

---------------------------------------------------------------------

Q: How do I configure Postfix?

A: There are two possible ways of integrating Vexira under Postfix.
   One of these is to make Vexira listen at port 25 and forward the
   emails to Postfix after virus scanning them. The other and
   recommend way is to integrate Vexira as a Postfix content filter.
   For more details read and follow the instructions in INSTALL and
   INSTALL.postfix

---------------------------------------------------------------------

Q: How do I integrate Vexira MailArmor into the SuSE Email Server 2/3?

A: You can integrate Vexira as a content filter since postfix is used
   by the SuSE Email Server II and III. See also section "How do i
   configure postfix".

---------------------------------------------------------------------

Q: How do I configure Vexira with SuSE 8.0?

A: You have two possibilities:

   1. sendmail is running on backdoor port. Please read
   INSTALL.sendmail und follow the instructions. Next edit
   /etc/sysconfig/mail and set SMTPD_LISTEN_REMOTE to "yes". The mails
   will be looped between Vexira MailArmor and sendmail if
   SMTPD_LISTEN_REMOTE is "no".

   2. The same happens if you are using the piping method ForwardTo
   /usr/lib/sendmail -oem -oi. If you add -Am to this line then the
   mails will be "normally" delivered, BUT only if Vexira is running
   as user root and group root (but this is not recommended).

---------------------------------------------------------------------

Q: How do I configure Vexira in combination with SuSE Linux Groupware
   Server (Lotus Domino R5 Application Server)?

A: First follow the installation instruction in INSTALL

   Then make the next two steps:

   1. Configure the SMTP-Port with help of your admin web interface
      from port 25 (default) to port 825.

   2. Vexira has to send all mails to 825. Therefore you have to
      modify the following entry "ForwardTo" in vamailarmor.conf:

      ForwardTo    SMTP: localhost port 825

---------------------------------------------------------------------

Q: What is the meaning of the files df-*, qf-*, Qf-*, xf-*, vf-* and
   mf-* in the spool directory of Vexira?

A: An email is represented by two files in the spool directory of
   Vexira. One is a data file, the other a control file. The data file
   is identified by a "df-" at the beginning of the file name.

   The corresponding control file can assume different file names
   depending on the processing status of the email:
   "xf-": Control file is currently being processed
   "qf-": Email is ready for a virus check
   "Qf-": Email is ready for direct forwarding without a virus check
   "vf-": Email contains a virus
   "mf-": A MIME problem has occurred in this email

---------------------------------------------------------------------

Q: What happens when an infected email is detected?

A: An infected email is identified by "vf-" at the beginning of the
   name of the control file in the spool directory of Vexira. These
   emails are quarantined. The corresponding data file contains the
   email in which the virus was found, which can now be either deleted
   together with the control file or forwarded by executing the queue
   manager vaq. Extreme care should be taken when forwarding virus
   infected email messages since the infection will still be present
   and will be received by the recipient.

---------------------------------------------------------------------

Q: What is the meaning of the message "bind failed (Address already in
   use)" in /var/log/mail (mail.log or maillog)?

A: This message appeared if Vexira could not bind to the port
   (default: 25) you have specified an vamailarmor.conf (see option
   ListenAddress). This means that another program is already
   listening on port 25. Test this with "lsof -i" or just do a "telnet
   localhost 25", then you will see what program is listening on the
   smtp port. 
  
---------------------------------------------------------------------

Q: What is the meaning of the message "init failed, err=3" in
   /var/log/mail or /var/log/maillog?

A: This message means that port 25 is occupied by another daemon. This
   probably means that you failed to close your mail transport agent
   properly before installing Vexira or to adapt the configuration
   file of your mail transport agent. For more details, please refer
   to the varius installation instructions which you will find in the
   TGZ file.

---------------------------------------------------------------------

Q: What is the meaning of the message "init failed, err=6" in
   /var/log/mail or /var/log/maillog?

A: This means that your Vexira directory contains a wrong virus
   definition file (VDF). The definition file must coincide with the
   program version.

---------------------------------------------------------------------

Q: What is the meaning of the message "Relaying denied for rcpt" in
   /var/log/mail, /var/log/maillog or /var/log/mail.log?

A: This means that the host connected to Vexira is not allowed to send
   E-Mails via the Vexira Antivirus for Mail server. Hosts that are
   allowed to relay can be found in the "vamailarmor.acl".

Example:

   /etc/vamailarmor.acl

   # These hosts and/or domains are local.

   local: localhost
   local: 127.0.0.1
   local: xyz.com
   local: abc.org

   # These hosts and networks are allowed to relay.

   relay: 127.0.0.1/8
   relay: 192.168.0.0/16

   The above entries in "vamailarmor.acl" mean that any email to
   localhost, 127.0.0.1, xyz.com or abc.org is allowed to be relayed
   with no care of what is entered in "relay:". Connections from hosts
   starting with the IP Address of 127 and connections from hosts
   starting with the IP Address of 192.168 are allowed to relay with
   no care of what is entered in "local:".

   The interpretation of the keyword local in vamailarmor.acl can be
   modified in the vamailarmor.conf file in section
   "MatchMailAddressForLocal".
   
   You can set this option to RECIPIENT, SENDER or BOTH to allow
   matching of domain name of the recipient and/or sender mail
   address, to check if it's to be considered local.
   
   If MatchMailAddressForLocal is RECIPIENT, and the recipient address
   matches the domain given in "local:", mail will be accepted.

   If MatchMailAddressForLocal is SENDER, and the sender address
   matches the domain given in "local:", mail will be accepted.

   If MatchMailAdressForLocal is BOTH, and the recipient or the sender
   adresses matches the domain given in "local:" mail will be
   accepted.

---------------------------------------------------------------------

Q: I have copied the file license.key to the Vexira program directory
   but Vexira will still only run in non-key mode. Why?

A: Your licence has probably expired or you did not set the
   permissions correctly. The license.key needs to have uucp
   permissions for user and group or root.

   You also need to stop all Vexira processes and restart them before
   the license.key is initialized.
   
---------------------------------------------------------------------

Q: Why are emails received via the SMTP command ETRN not scanned?

A: If you use the SMTP command ETRN to retrieve your emails from the
   server, they will not pass through the local SMTP daemon. To avoid
   this problem, use pop, imap and fetchmail to retrieve your emails.

---------------------------------------------------------------------

Q: Sendmail can no longer send any emails once Vexira is installed.

A: You are probably using a SuSE distribution in which the security
   level is set to SECURE or PARANOID. Change the following entry in
   the file /etc/permissions.paranoid: Locate the line
   "/var/spool/mqueue" and change the rights from 755 to 775. Don't
   forget to start SuSEconfig afterwards.

---------------------------------------------------------------------

Q: Since Vexira has been installed, procmail will no longer deliver
   emails to the local mailboxes.

A: This problem occurs in some systems. One possible solution is to
   set the SUID bit of /usr/bin/procmail.

---------------------------------------------------------------------

Q: The daemon vagated terminates the connection before any data can be
   sent. What's wrong?

A: This problem occurs in the Red Hat 7.0 distribution. The glibc
   supplied with Red Hat 7.0 contained a bug. A new version of it is
   available for updates on the FTP server of Red Hat. Please download
   the two RPM packages glibc-2.2-12.i386.rpm and
   glibc-common-2.2-12.i386.rpm, and this will solve the problem.

---------------------------------------------------------------------

Q: Does Vexira work with fetchmail?

A: Yes. Fetchmail transfers all emails to the process, which listens
   on port 25 (SMTP)

---------------------------------------------------------------------

Q: How can I test Vexira after installation?

A: There is a test file signature called Eicar which is detected by
   all quaility antivirus scanners.
   
   To use this, simply copy the following character string to a file
   and send it to Vexira:
   
   X5O!P%@AP[4\PZX54(P^)7CC)7}$EICAR-STANDARD-ANTIVIRUS-TEST-FILE!$H+H*

   You can also visit the website http://www.eicar.com and download
   the Eicar files and attach them to the test email

---------------------------------------------------------------------

Q: I have bought Vexira, how do I get support?

A: Please visit http://support.centralcommand.com and check the
   frequently updated FAQ on our website. Otherwise contact us at
   support@centralcommand.com or +1 330 723 2062 for more assistance.
