Kaspersky AntiVirus Plugin for CommuniGate Pro

Note: The Kaspersky AntiVirus Plugin is available only for some platforms supported with the CommuniGate Pro server software. Before you order the KAV Plugin License, make sure that the available versions of the Plugin software run on your CommuniGate Pro Server platform.

Note: The Kaspersky AntiVirus Plugin requires CommuniGatePro version 6.0.11 or later.

---

Download the KAV Plugins

Kaspersky AntiVirus Plugins are available for certain platforms only.

Operating System	CPU	Download
		via http	via ftp
Linux (RedHat, SuSE, Debian)	x86_64
FreeBSD 10.x	x86_64
Microsoft Windows 7/8/10 2008 R2/2012	x86_64

The current version of the Plugin is 1.8

---

Installing on a Unix System

• Download the CGPKAV-platform-processor-version.tar.gz Plugin archive file.
• Log in as a super-user (root).
• Move the archive into /var/CommuniGate/ which is the CommuniGate Pro base directory.
• Unpack the Plugin archive with the gtar command (or with the gunzip and tar commands):
    gunzip CGPKAV-*.tar.gz
    tar -xf CGPKAV-*.tar
  The CGPKAV directory will be created inside the /var/CommuniGate/.
• Proceed with Testing the antivirus Plugin.

---

Installing on a MS Windows System

• Download the CGPKAV-Win32-Intel.zip or CGPKAV-Windows-x86_64.zip Plugin archive file.
• Move the archive into the CommuniGate Pro base directory C:\CommuniGate Files\
• Unpack the Plugin archive with any "unzip" tool:
    pkunzip CGPKAV-*.zip
  The CGPKAV directory will be created inside the base directory.
• Proceed with Testing the antivirus Plugin.

---

Updating the antivirus Plugin.

When updating the Kaspersky Plugin to a newer version, do the following steps:

• If you made any changes to the default configuration - save the contents of the CGPKAV.cfg file.
• Stop the current copy of the Plugin application via CommuniGate Pro WebAdmin interface.
• Delete all files form CGPKAV directory.
• Install the new version of the Plugin as described above in this document.
• Revise the new CGPKAV.cfg file and re-apply the necessary changes.

Note:To maintain the maximum virus protection you have to update to a newer version of the Plugin as soon as it is become available. By running an old versions you put yourself at risk because old versions may be unable to catch new virus types.

---

Testing the antivirus Plugin.

On Unix and MacOS X System:

• Change the current directory to the CommuniGate Pro base directory:
    cd /var/CommuniGate
  
• Launch the CGPKAV application from its directory:
    CGPKAV/CGPKAV
  It will report the Plugin version number, the Engine version number, the number of viruses in the database, the date of the latest update of the virus database, the internal key expiration date, and some other info.
• Type:
    1 FILE CGPKAV/test.msg
  the Plugin should report that it has found the EICAR test file.
• Quit CGPKAV by pressing Ctrl-D.

On a Windows System:

• Change the current directory to the CommuniGate Pro base directory:
    cd "C:\CommuniGate Files"
  
• Launch the CGPKAV.exe application from its directory:
    CGPKAV\CGPKAV.exe
  It will report the Plugin version number, the Engine version number, the number of viruses in the database, the date of the latest update of the virus database, the internal key expiration date, and some other info.

  Note: If the Plugin does not start, specify its full name including the drive letter:
    "C:\CommuniGate Files\CGPKAV\CGPKAV.exe"
  

• Type:
    1 FILE CGPKAV\test.msg
  the Plugin should report that it has found the EICAR test file.
• Quit CGPKAV.exe by pressing Ctrl-Z.

Note:The plugin contains an internal Kaspersky license key file in licenses subdirectory, that key is required for the Kaspersky Engine to work. The key has limited validity period. The new keys are given by us for free of charge.

---

Integrating the antivirus Plugin with CommuniGate Pro.

Open the General page in the Settings section of the WebAdmin Interface and click the Helpers link. Create the Helper as follows:

Note: For Linux, if the Plugin fails to start, try to clear sticky-bits with "chmod ug-s /opt/CommmuniGate/CGServer" command and restart CommuniGate.

Note: For Windows, if the Plugin fails to start, try to specify full Program Path, e.g. "C:\CommuniGate Files\CGPKAV\CGPKAV.exe"

The recommended Scanning Rule is as follows:

Note: It's not recommended to scan small messages (less than 2K) because they are unlikely to contain viruses.

Note: If you run the unlicensed version of the Plugin you're limited to one message per hour. Therefore you must not scan all messages because this will just block the mail flow. If you want to see how the Plugin catches viruses, then in the Scanning Rule you should specify more conditions in order to apply the ExternalFilter action only to messages from certain sender (from you) and with certain subject.

---

Configuring the Plugin.

On startup the KAV Plugin reads the contents of the CGPKAV.cfg file from the current directory. The format of the file data elements is described in http://www.communigate.ru/CommuniGatePro/Data.html. The description of the data elements you may find in the CGPKAV.cfg file. The default CGPKAV.cfg is available here.

It is safe to view and edit the CGPKAV.cfg file while the Plugin is running. After you have made changes to the CGPKAV.cfg, you should do one of the following:

• Restart the Plugin via CommuniGate Pro WebAdmin interface.
• Apply 'kill -HUP' to the CGPKAV process (in Unix).
• Create the CGPKAV/hup.sig signal file with any data in it. The Plugin will delete this file and re-read the configuration.