madscientist
/
PKG-SNF4CGP-NIX
Watch 1
Star 0
Fork 0
Code Issues 0 Pull Requests 0 Releases 0 Wiki Activity
Browse Source

Copied default.html from undated documentation posted in the WIN package. This should bring the WIN and NIX cgp docs up to date. 

git-svn-id: https://svn.microneil.com/svn/PKG-SNF4CGP-NIX/trunk@50 7ef522f6-be79-40a8-b7df-0a85b3383509
master
madscientist 14 years ago
parent
ab01c2cc85
commit
15e21d038f
1 changed files with 475 additions and 352 deletions
Split View Show Diff Stats
  1. 475
    352
      SNF4CGP_Developer_Package/Doc_CommuniGatePro/default.html

+ 475
- 352
SNF4CGP_Developer_Package/Doc_CommuniGatePro/default.html View File

@@ -1,389 +1,512 @@
<HTML>
<HEAD>
<TITLE>CommuniGate Pro: ARM Research Labs Sniffer Antispam Plugin</TITLE>
<link rel="stylesheet" href="GuideStyle.css" type="text/css" />
<link rel="stylesheet" href="AdminStyle.css" type="text/css" />

</HEAD>
<BODY BGCOLOR=white>

<TABLE border=0 cellPadding=0 cellSpacing=0 width="100%">
<td><img src="CGPLogo.gif" alt="CommuniGate Pro" /></td>
<tr><td class="tabBodyOuter">
<table width="100%" cellspacing="0" cellpadding="0" class="tabBody"><tr><td>
<h1>ARM Research Labs Sniffer Plugin for CommuniGate Pro</h1>
<div class="guideTOC"><ul>

<TABLE width="100%" cellspacing="0" cellpadding="0" class="tabBody" >


<LI><A href="#Download">Download the Sniffer Plugin</A>
<LI><A href="#Install" name=Install>Installation</A>
<UL>
<LI><A href="#WIN32">Installing on a MS Windows 200x/NT/XP/9x System</A>
<LI><A href="#Linux">Installing on a Linux System</A>
<LI><A href="#FreeBSD">Installing on a FreeBSD or OpenBSD System</A>
<LI><A href="#Source">Installing from source</A>
</UL>
<LI><A href="#Upgrading">Upgrading to a newer version</A>
<LI><A href="#Config">Configuring the Sniffer Plugin</A>
<LI><A href="#Test">Testing the Sniffer Plugin</A>
<LI><A href="#Options">Command line options</A>
<LI><A href="#Integrate">Integrating the Sniffer Plugin with CommuniGate Pro</A>
<LI><A href="#Update">Updating the spam definitions database</A>

</ul></div>
</TD></TR></TABLE>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-15">
<title>CommuniGate Pro: ARM Research Labs Sniffer Antispam Plugin</title>
<link rel="stylesheet" href="GuideStyle.css" type="text/css" />
<link rel="stylesheet" href="AdminStyle.css" type="text/css" />
</head>

</table>
</TABLE>
<body>

<table border="0" cellPadding="0" cellSpacing="0" width="100%">

<tr>
<td class="tabBodyOuter">

<table class="tabBody" width="100%" cellspacing="0"
cellpadding="0">
<tr>

<td>

<h1>ARM Research Labs Sniffer Plugin for CommuniGate
Pro</h1>

<div class="guideTOC">
<ul>

<table class="tabBody" width="100%" cellspacing="0"
cellpadding="0">

<li><a href="#Download">Download the Sniffer Plugin</a>

<li><a href="#Install" name=Install>Installation</a>

<ul>

<li><a href="#WIN32">Installing on a MS Windows
200x/NT/XP/9x system</a>

<li><a href="#Linux">Installing on a Linux
system</a>

<li><a href="#FreeBSD">Installing on a FreeBSD
system</a>

<li><a href="#OpenBSD">Installing on an OpenBSD
system</a>

<li><a href="#Source">Installing from source</a>

<P><B>Note:</B> The ARM Research Labs Sniffer Plugin is available only
for <I>some</I> platforms supported with the CommuniGate Pro server
software. Before you order the Sniffer Plugin License, make sure that
</ul>

<li><a href="#Upgrading">Upgrading to a newer
version</a>

<li><a href="#Config">Configuring the Sniffer
Plugin</a>

<li><a href="#Test">Testing the Sniffer Plugin</a>

<li><a href="#Options">Command line options</a>

<li><a href="#Integrate">Integrating the Sniffer
Plugin with CommuniGate Pro</a>

<li><a href="#Update">Updating the spam definitions
database</a>

</ul>
</div>
</td>
</tr>

</table>
</tr>
</table>
</tr>
</td>
</table>

<p><b>Note:</b> The ARM Research Labs Sniffer Plugin is not available
on platforms. Before you order the Sniffer License, make sure that
the available versions of the Sniffer Plugin software run on your
CommuniGate Pro Server platform.

<P><B>Note:</B> The ARM Research Labs Sniffer Plugin requires
CommuniGatePro version 5.2.3 or later.


<H2><HR><A NAME="Download"></A>Download the ARM Research Labs Sniffer Plugins</H2>
<DL><DD>
<P>ARM Research Labs Sniffer antispam plugins are available for certain platforms only.

<TABLE class="guideTable" BORDER=1 CELLSPACING=0 CELLPADDING=1>
<TR BGCOLOR="#cccccc">
<TH NOWRAP rowspan=2 width=50%>Operating System</TH>
<TH NOWRAP rowspan=2>CPU</TH>
<TH NOWRAP colspan=2>Download</TH>
</TR>

<TR BGCOLOR="#cccccc">
<TH NOWRAP>via<BR>http</TH>
<TH NOWRAP>via<BR>ftp</TH>
</TR>

<TR>
<TD ALIGN=CENTER>Microsoft Windows NT/2000/XP<BR>Microsoft Windows 95/98</TD>
<TD ALIGN=CENTER>x86</TD>
<TD ALIGN=CENTER><A HREF="http://www.armresearch.com/pub/plugins/CGPSNF-Win32-Intel.zip">
<IMG SRC="DownLoad.gif" BORDER=0 WIDTH=16 HEIGHT=16></A></TD>
<TD ALIGN=CENTER><A HREF="ftp://ftp.armresearch.com/pub/plugins/CGPSNF-Win32-Intel.zip">
<IMG SRC="DownLoad.gif" BORDER=0 WIDTH=16 HEIGHT=16></A></TD>
</TR>

<TR>
<TD ALIGN=CENTER rowspan=2>Linux (RedHat/Fedora/CentOS, Ubuntu, SuSE)</TD>
<TD ALIGN=CENTER>x86</TD>
<TD ALIGN=CENTER><A HREF="http://www.armresearch.com/pub/plugins/CGPSNF-Linux-Intel.tar.gz"><IMG SRC="DownLoad.gif"
BORDER=0 WIDTH=16 HEIGHT=16></A></TD>
<TD ALIGN=CENTER><A HREF="ftp://ftp.armresearch.com/pub/plugins/CGPSNF-Linux-Intel.tar.gz"><IMG SRC="DownLoad.gif"
BORDER=0 WIDTH=16 HEIGHT=16></A></TD>

<TR>
<TD ALIGN=CENTER>x86_64</TD>
<TD ALIGN=CENTER><A HREF="http://www.armresearch.com/pub/plugins/CGPSNF-Linux-x86_64.tar.gz"><IMG SRC="DownLoad.gif"
BORDER=0 WIDTH=16 HEIGHT=16></A></TD>
<TD ALIGN=CENTER><A HREF="ftp://www.armresearch.com/pub/plugins/CGPSNF-Linux-x86_64.tar.gz"><IMG SRC="DownLoad.gif"
BORDER=0 WIDTH=16 HEIGHT=16></A></TD>

</TR>

<TR>
<TD ALIGN=CENTER rowspan=2>FreeBSD 7.x</TD>
<TD ALIGN=CENTER>x86</TD>
<TD ALIGN=CENTER><A HREF="http://www.armresearch.com/pub/plugins/CGPSNF-FreeBSD7.x-Intel.tar.gz"><IMG SRC="DownLoad.gif"
BORDER=0 WIDTH=16 HEIGHT=16></A></TD>
<TD ALIGN=CENTER><A HREF="ftp://ftp.armresearch.com/pub/plugins/CGPSNF-FreeBSD7.x-Intel.tar.gz"><IMG SRC="DownLoad.gif"
BORDER=0 WIDTH=16 HEIGHT=16></A></TD>

<TR>
<TD ALIGN=CENTER>x86_64</TD>
<TD ALIGN=CENTER><A HREF="http://www.armresearch.com/pub/plugins/CGPSNF-FreeBSD7.x-x86_64.tar.gz"><IMG SRC="DownLoad.gif"
BORDER=0 WIDTH=16 HEIGHT=16></A></TD>
<TD ALIGN=CENTER><A HREF="ftp://www.armresearch.com/pub/plugins/CGPSNF-FreeBSD7.x-x86_64.tar.gz"><IMG SRC="DownLoad.gif"
BORDER=0 WIDTH=16 HEIGHT=16></A></TD>

</TR>

<TR>
<TD ALIGN=CENTER rowspan=2>OpenBSD 4.4 or later</TD>
<TD ALIGN=CENTER>x86</TD>
<TD ALIGN=CENTER><A HREF="http://www.armresearch.com/pub/plugins/CGPSNF-OpenBSD4.4-Intel.tar.gz"><IMG SRC="DownLoad.gif"
BORDER=0 WIDTH=16 HEIGHT=16></A></TD>
<TD ALIGN=CENTER><A HREF="ftp://ftp.armresearch.com/pub/plugins/CGPSNF-OpenBSD4.4-Intel.tar.gz"><IMG SRC="DownLoad.gif"
BORDER=0 WIDTH=16 HEIGHT=16></A></TD>

<TR>
<TD ALIGN=CENTER>x86_64</TD>
<TD ALIGN=CENTER><A HREF="http://www.armresearch.com/pub/plugins/CGPSNF-OpenBSD4.4-x86_64.tar.gz"><IMG SRC="DownLoad.gif"
BORDER=0 WIDTH=16 HEIGHT=16></A></TD>
<TD ALIGN=CENTER><A HREF="ftp://www.armresearch.com/pub/plugins/CGPSNF-OpenBSD4.4-x86_64.tar.gz"><IMG SRC="DownLoad.gif"
BORDER=0 WIDTH=16 HEIGHT=16></A></TD>

</TR>

</TABLE>

</DL>

<P>The current version of the Plugin is 0.1.0.
<P>The current version of the ARM Research Labs Sniffer Engine is 3.0.11.


<H3><HR><A name=Upgrading></A>Upgrading to a newer version.</H3>
<P>When upgrading the Plugin to a newer version, do the following:
<UL>
<LI>Stop the current copy of the plugin application via CommuniGate Pro WebAdmin interface.
<LI>Install and configure the new version of the Plugin as described above in this document.
</UL>

<H3><HR><A name="WIN32"></A>Installing on a MS Windows 200x/NT/XP/9x System.</H3>
<UL>
<LI>Open the command-line interface window and
CommuniGate Pro Server platform.</p>

<h2><hr><a name="Download"></a>Download the ARM Research Labs Sniffer Plugins</h2>
<dl><dd>
<p>ARM Research Labs Sniffer antispam plugins are available for certain platforms only.</p>

<table class="guideTable" border=1 cellspacing=0 cellpadding=1>

<tr bgcolor="#cccccc">
<th nowrap rowspan=2 width=50%>Operating System</th>
<th nowrap rowspan=2>CPU</th>
<th nowrap colspan=2>Download</th>
</tr>

<tr bgcolor="#cccccc">
<th nowrap>via<br>http</th>
<th nowrap>via<br>ftp</th>
</tr>

<tr>
<td align=center>Microsoft Windows NT/2000/XP<BR>Microsoft Windows 95/98</td>
<td align=center>x86</td>
<td align=center><a HREF="http://www.armresearch.com/message-sniffer/download/CGPSNF-Win32-Intel.zip">
<img src="DownLoad.gif" border=0 width=16 height=16></a></td>
<td align=center><img src="DisabledDownLoad.gif" border=0 width=16 height=16></td>
</tr>

<tr>
<td align=center rowspan=2>Linux (RedHat/Fedora/CentOS, Ubuntu, SuSE)</TD>
<td align=center>x86</td>
<td align=center><a
HREF="http://www.armresearch.com/message-sniffer/download/CGPSNF-Linux-Intel.tar.gz">
<img src="DownLoad.gif" border=0 width=16 height=16></a></td>
<td align=center><img src="DisabledDownLoad.gif" border=0 width=16 height=16></td>

<tr>
<td align=center>x86_64</td>
<td align=center><a href="http://www.armresearch.com/message-sniffer/download/CGPSNF-Linux-x86_64.tar.gz">
<img src="DisabledDownLoad.gif" border=0 width=16 height=16></a></td>
<td align=center><img src="DisabledDownLoad.gif" border=0 width=16 height=16></td>
</tr>

<tr>
<td align=center rowspan=2>FreeBSD 7.x</td>
<td align=center>x86</td>
<td align=center><a href="http://www.armresearch.com/message-sniffer/download/CGPSNF-FreeBSD7.x-Intel.tar.gz">
<img src="DownLoad.gif" border=0 width=16 height=16></a></td>
<td align=center><img src="DisabledDownLoad.gif" border=0 width=16 height=16></td>

<tr>
<td align=center>x86_64</td>
<td align=center><a href="http://www.armresearch.com/message-sniffer/download/CGPSNF-FreeBSD7.x-x86_64.tar.gz">
<img src="DisabledDownLoad.gif" border=0 width=16 height=16></a></td>
<td align=center><img src="DisabledDownLoad.gif" border=0 width=16 height=16></td>

</tr>

<tr>
<td align=center rowspan=2>OpenBSD 4.4 or later</td>
<td align=center>x86</td>
<td align=center><a href="http://www.armresearch.com/message-sniffer/download/CGPSNF-OpenBSD4.4-Intel.tar.gz">
<img src="DownLoad.gif" border=0 width=16 height=16></a></td>
<td align=center><img src="DisabledDownLoad.gif" border=0 width=16 height=16></td>

<tr>
<td align=center>x86_64</td>
<td align=center><a href="http://www.armresearch.com/message-sniffer/download/CGPSNF-OpenBSD4.4-x86_64.tar.gz">
<img src="DisabledDownLoad.gif" border=0 width=16 height=16></a></td>
<td align=center><img src="DisabledDownLoad.gif" border=0 width=16 height=16></td>

</tr>

<tr>
<td align=center>Source for Linux/FreeBSD/OpenBSD</td>
<td align=center>Any</td>
<td align=center><a HREF="http://www.armresearch.com/message-sniffer/download/snf4cgp.tar.gz">
<img src="DownLoad.gif" border=0 width=16 height=16></a></td>
<td align=center><img src="DisabledDownLoad.gif" border=0 width=16 height=16></td>
</tr>

</table>

</dl>

<p>Downloads by ftp are not available</p>
<p>The current version of the Plugin is 0.1.0.</p>
<p>The current version of the ARM Research Labs Sniffer Engine is 3.0.12.</p>

<h3><hr/><a name=Upgrading></a>Upgrading to a newer version.</h3>
<p>When upgrading the Plugin to a newer version, do the following:</p>

<ul>

<li>Stop any running copy of the Sniffer Plugin application via
CommuniGate Pro WebAdmin interface.

<li>Install and configure the new version of the Sniffer Plugin as
described in this document.

</ul>

<h3><hr><a name="WIN32"></a>Installing on a MS Windows 200x/NT/XP/9x system.</h3>
<ul>
<li>Open the command-line interface window and
change the current directory to the CommuniGate Pro <I>base directory</I>.
<LI>Use any &quot;unzip&quot;-type tool to unpack the
<TT>CGPSNF-Win32-Intel.zip</TT> file. The <TT>CGPSNF</TT> directory will be created inside the <I>base directory</I>.
<LI>Proceed with <A HREF="#Config">Configuring the Sniffer Plugin</A>.
</UL>

<H3><HR><A name=Linux></A>Installing on a Linux System.</H3>
<UL>
<LI>Log in as a super-user (root).
<LI>Change the current directory to the CommuniGate Pro <I>base directory</I>.
<LI>Unpack the Plugin archive with the <TT>gtar</TT> command (or
with the <TT>gunzip</TT> and <TT>tar</TT> commands):<TT><BR>
&nbsp;&nbsp;gunzip CGPSNF-Linux-Intel.tar.gz<BR>
&nbsp;&nbsp;tar -xf CGPSNF-Linux-Intel.tar</TT><BR>
The <TT>CGPSNF</TT> directory will be created inside the <I>base directory</I>.
<LI>Proceed with <A HREF="#Config">Configuring the Sniffer Plugin</A>.
</UL>

<H3><HR><A name=FreeBSD></A>Installing on a FreeBSD or OpenBSD System.</H3>
<UL>
<LI>Log in as a super-user (root).
<LI>Change the current directory to the CommuniGate Pro <I>base directory</I>.
<LI>Unpack the Plugin archive with the <TT>gtar</TT> command (or
with the <TT>gunzip</TT> and <TT>tar</TT> commands):<TT><BR>
&nbsp;&nbsp;gunzip CGPSNF-FreeBSD-Intel.tar.gz<BR>
&nbsp;&nbsp;tar -xf CGPSNF-FreeBSD-Intel.tar</TT><BR>
The <TT>CGPSNF</TT> directory will be created inside the <I>base directory</I>.
<LI>Proceed with <A HREF="#Config">Configuring the Sniffer Plugin</A>.
</UL>

<H3><HR><A name=Source></A>Installing from source.</H3>
<li>Use any &quot;unzip&quot;-compatible tool to unpack the
<tt>CGPSNF-Win32-Intel.zip</tt> file. The <tt>CGPSNF</tt> directory will be created inside the <I>base directory</I>.
<li>Proceed with <a HREF="#Config">Configuring the Sniffer Plugin</a>.
</ul>

<h3><hr><a name=Linux></a>Installing on a Linux system.</h3>
<ul>
<li>Log in as a super-user (root).
<li>Change the current directory to the CommuniGate Pro <I>base directory</I>.
<li>Unpack the Plugin archive with the <tt>tar</tt> command:<tt><br>
&nbsp;&nbsp;tar -xzf CGPSNF-Linux-Intel.tar.gz</tt><br>
The <tt>CGPSNF</tt> directory will be created inside the <I>base directory</I>.
<li>Proceed with <a HREF="#Config">Configuring the Sniffer Plugin</a>.
</ul>

<h3><hr><a name=FreeBSD></a>Installing on a FreeBSD system.</h3>
<ul>
<li>Log in as a super-user (root).
<li>Change the current directory to the CommuniGate Pro <I>base directory</I>.
<li>Unpack the Plugin archive with the <tt>tar</tt> command:<tt><br>
&nbsp;&nbsp;tar -xzf CGPSNF-FreeBSD-Intel.tar.gz</tt><br>
The <tt>CGPSNF</tt> directory will be created inside the <I>base directory</I>.
<li>Proceed with <a HREF="#Config">Configuring the Sniffer Plugin</a>.
</ul>

<h3><hr><a name=OpenBSD></a>Installing on an OpenBSD system.</h3>
<ul>
<li>Log in as a super-user (root).
<li>Change the current directory to the CommuniGate Pro <I>base directory</I>.
<li>Unpack the Plugin archive with the <tt>tar</tt> command:<tt><br>
&nbsp;&nbsp;tar -xzf CGPSNF-OpenBSD-Intel.tar.gz</tt><br>
The <tt>CGPSNF</tt> directory will be created inside the <I>base directory</I>.
<li>Proceed with <a HREF="#Config">Configuring the Sniffer Plugin</a>.
</ul>

<h3><hr><a name=Source></a>Installing from source.</h3>
You can build the Sniffer Plugin from source:
<UL>
<LI>Download the <TT>snf4cgp-X.Y.Z.tar.gz</TT>, where X.Y.Z is the
version.
<LI>Extract the sources with the command:<TT><BR>
&nbsp;&nbsp;tar -xzf snf4cgp-X.Y.Z.tar.gz</TT><BR>
This creates a directory <TT>snf4cgp-X.Y.Z</TT>.
<LI>Change directory to <TT>snf4cgp-X.Y.Z</TT>:<TT><BR>
&nbsp;&nbsp;cd snf4cgp-X.Y.Z</TT><BR>
<LI>Configure and build the system:<TT><BR>
&nbsp;&nbsp;./configure<BR>
&nbsp;&nbsp;./make</TT><BR>
<LI>Become super-user (root).
<LI>Create the Sniffer Plugin:<TT><BR> &nbsp;&nbsp;make
module</TT><BR> This creates a Plugin archive
named <TT>CGPSNF-X.Y.Z-MODULE.tar.gz</TT>.
<LI>Proceed with <A HREF="#Install">Installing the Sniffer
Plugin</A> for your system, using the Plugin archive that was
<ul>
<li>Download the <tt>snf4cgp.tar.gz</tt>.
<li>Extract the sources with the command:<tt><br>
&nbsp;&nbsp;tar -xzf snf4cgptar.gz</tt><br>
This creates a directory <tt>snf4cgp-X.Y.Z</tt>, where X.Y.Z is the
version of the module.
<li>Change directory to <tt>snf4cgp-X.Y.Z</tt>:<tt><br>
&nbsp;&nbsp;cd snf4cgp-X.Y.Z</tt><br>
<li>Configure and build the system:<tt><br>
&nbsp;&nbsp;./configure<br>
&nbsp;&nbsp;./make</tt><br>
<li>Become super-user (root).
<li>Create the Sniffer Plugin:<tt><br> &nbsp;&nbsp;make
module</tt><br> This creates a Plugin archive
named <tt>CGPSNF-X.Y.Z-MODULE.tar.gz</tt>.
<li>Proceed with <a HREF="#Install">Installing the Sniffer
Plugin</a> for your system, using the Plugin archive that was
created.
</UL>

<H3><HR><A name=Config></A>Configuring the Sniffer Plugin.</H3>

<P>In the module directory (<TT>/var/CommuniGate/CGPSNF</TT> on a
Linux or Linux-like system):
<UL>
<LI>Copy the configuration file <TT><BR>
&nbsp;&nbsp;snf_engine.xml.sample</TT><BR> to <TT><BR>
&nbsp;&nbsp;snf_engine.xml</TT><BR> and customize as
needed. Please see the <A href="http://www.armresearch.com">ARM
Research Labs web site</A> for documentation on
the <TT>snf_engine.xml</TT> configuration file.<BR>

<LI>Copy <TT><BR>
&nbsp;&nbsp;identity.xml.sample</TT><BR> to <TT><BR>
&nbsp;&nbsp;identity.xml</TT><BR> and edit to include the
license ID and authentication attributes of
the <TT>&lt;identity&gt; element</TT>.<BR>

<LI>Copy <TT><BR>
&nbsp;&nbsp;getRulebase.sample</TT><BR> to <TT><BR>
&nbsp;&nbsp;getRulebase</TT><BR> and edit to include the
license ID and authentication:

<UL>
<LI>Change the line <TT><BR>
&nbsp;&nbsp;AUTHENTICATION=authenticationxx</TT><BR>
to <TT><BR>
&nbsp;&nbsp;AUTHENTICATION=YOUR_AUTHENTICATION</TT><BR>
where <TT>YOUR_AUTHENTICATION</TT> is authentication code
obtained from ARM Research Labs.</LI>

<LI>Change the line <TT><BR>
&nbsp;&nbsp;LICENSE_ID=licenseid</TT><BR> to <TT><BR>
&nbsp;&nbsp;LICENSE_ID=YOUR_LICENSE_ID</TT><BR>
where <TT>YOUR_LICENSE_ID</TT> is license ID obtained from
ARM Research Labs.</LI>

</UL>

<LI>Make <TT>getRulebase</TT> executable:<TT><BR>
&nbsp;&nbsp;chmod 755 getRulebase</TT><BR>

<LI>Copy <TT><BR>
&nbsp;&nbsp;GBUdbIgnoreList.txt.sample</TT><BR> to <TT><BR>
&nbsp;&nbsp;GBUdbIgnoreList.txt</TT><BR> and customize as
needed. Please see the
<A href="http://www.armresearch.com">ARM Research Labs web
site</A> for documentation on the <TT>GBUdbIgnoreList.txt</TT>
file.<BR>

<LI>Download the Sniffer database:
<UL>
<LI>Create the file <TT>UpdateReady.txt</TT> in the plugin directory:<TT><BR>
&nbsp;&nbsp;touch UpdateReady.txt</TT><BR>
</LI>
<LI>Run the <TT>getRulebase</TT> script in the plugin
directory:<TT><BR>
&nbsp;&nbsp;./getRulebase</TT><BR>
This downloads the Sniffer database to the plugin directory.
</UL>

The <B><TT>CGPSNF</TT></B> program automatically updates the
Sniffer database as needed.

<LI>Proceed with <A HREF="#Test">Testing the Sniffer Plugin</A>.
</UL>



<H3><HR><A name=Test></A>Testing the Sniffer Plugin.</H3>
<P>On Windows System:
<!--
<UL>
<LI>Launch the <TT>CGPSNF.exe</TT> application by typing:<TT><BR>
&nbsp;&nbsp;CGPSNF\CGPSNF.exe CGPSNF\snf_engine.xml</TT><BR>
It will report the Plugin version number and build date.<BR>

<LI>Type:<TT><BR>
&nbsp;&nbsp;1 FILE CGPSNF\junkmsg.msg</TT><BR>
The plugin should report that the file is spam.
<LI>Quit <TT>CGPSNF.exe</TT> by typing Ctrl-Z.
</UL>
-->

<P>On a Unix System:
<UL>
<LI> Change to the module directory:<TT><BR>
&nbsp;&nbsp;cd /var/CommuniGate/CGPSNF</TT><BR>

<LI>Launch the <TT>CGPSNF</TT> application by typing:<TT><BR>
&nbsp;&nbsp;./CGPSNF snf_engine.xml</TT><BR>
It will report the Plugin version number and build date.<BR>

<LI>Type:<TT><BR>
&nbsp;&nbsp;1 FILE junkmsg.txt</TT><BR>
the plugin should report that the file is spam.

<LI>Quit <TT>CGPSNF</TT> by typing Ctrl-D.
</UL>

<H3><HR><A NAME="Options"></A>Command Line Options</H3>
<DL><DD>
The Sniffer Plugin supports the following command-line option (parameters):<DL>
<P><DT><TT>snf_engine.xml</TT>
<DD>This option tells the Plugin to read the <TT>snf_engine.xml</TT>
configuration file.

</DL>
</DL>


<H3><HR><A name=Integrate></A>Integrating the Sniffer Plugin with CommuniGate Pro.</H3>

Please check the <A
HREF="http://www.communigate.com/CommuniGatePro/VirusScan.html#Launch">External
Filters</A> section of the CommuniGate Pro manual.

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

<h3><hr><a name=Config></a>Configuring the Sniffer Plugin.</h3>

<p>Go to the CGPSNF module directory:<br/>
<blockquote>
On a typical Linux or Linux-like system
<tt>/var/CommuniGate/CGPSNF</tt><br/> On a typical Windows system
<tt>C:\CommuniGatePro\CGPSNF</tt><br/>
<br/>
<i>Note: If these are not correct for your system you will need to
customize your snf_engine.xml and getRulebase script accordingly. Be sure
you visit the <a
href="http://www.armresearch.com/support/articles/software/snfServer/config/node/paths/">paths</a> and <a href="http://www.armresearch.com/support/articles/software/snfServer/config/node/network/update-script.jsp">update-script</a> section of snf_engine.xml as well
as
the SET SNIFFER_PATH= line in your getRulebase script. </i> </blockquote>
</p>
<ul>

<li>Have your Message Sniffer <i>LicenseID</i> (8 characters) and
<i>AuthenticationString</i> (16 characters) ready. You should have
received these in your sign-up email or in one of your update
notification email's from ARM Research Labs.
</li>

<br/>
<li>Copy the sample configuration files.</li>
<ul>
<li>Copy <tt>snf_engine.xml.sample</tt> to <tt>snf_engine.xml</tt>
and <a
href="http://www.armresearch.com/support/articles/software/snfServer/config/snfEngine.jsp">
Customize as needed.
</a>
<blockquote><i>Note: If you modify the location of your rulebase
you will also need to modify your getRulebase script accordingly!
This is supported, however it is usually best to leave the location
of the rulebase (.snf) files in the CGPSNF directory.</i></blockquote>
</li>

<li>Copy <tt>identity.xml.sample</tt> to <tt>identity.xml</tt> </li>
<li>Edit <tt>identity.xml</tt> to <a
href="http://www.armresearch.com/support/articles/software/snfServer/config/identity.jsp">Configure your <i>LicenseID</i> and
<i>AuthenticationString</i></a></li>
<li>Copy
<tt>GBUdbIgnoreList.txt.sample</tt> to <tt>GBUdbIgnoreList.txt</tt>
and <a
href="http://www.armresearch.com/support/articles/software/snfServer/config/gbudbIgnoreList.jsp">Customize as needed.</a></li>
</ul>

<br/>
<li>Configure your automated updates script.</li>
<ul>
<br/>
<li>On Windows Systems...</li>

<ul>
<li>Copy <tt>getRulebase.cmd.sample</tt> to
<tt>getRulebase.cmd</tt></li>
<li>Configure the script with your SNF license ID and
Authentication string.</li>
<ul>
<li>Change the line <tt>LICENSE_ID=licenseid</tt> to
<tt>LICENSE_ID=</tt><i>your_LicenseID</i></li>
<li>Change the line
<tt>AUTHENTICATION=authenticationxx</tt> to
<tt>AUTHENTICATION=</tt><i>your_AuthenticationString</i></li>
</ul>

</ul>

<br/>
<li>On Linux Sysetms...</li>


<ul>
<li>Copy <tt>getRulebase.sample</tt> to
<tt>getRulebase</tt></li>
<li>Configure the script with your SNF license ID and
Authentication string.</li>
<ul>
<li>Change the line <tt>LICENSE_ID=licenseid</tt> to
<tt>LICENSE_ID=</tt><i>your_LicenseID</i></li>
<li>Change the line
<tt>AUTHENTICATION=authenticationxx</tt> to
<tt>AUTHENTICATION=</tt><i>your_AuthenticationString</i></li>
</ul>
<li>Make <tt>getRulebase</tt> executable:<br/>
&nbsp;&nbsp;<tt>chmod 755 getRulebase</tt></li>

</ul>

</ul>

<br/>
<li>Download the current Message Sniffer rulebase:
<ul>
<br/>
<li>On Windows systems...</li>
<ul>
<li>Create an <tt>UpdateReady.txt</tt> file:<tt><br>
&nbsp;&nbsp;echo . > UpdateReady.txt</tt><br>
</li>
<li>Run the <tt>getRulebase</tt> script:<tt><br>
&nbsp;&nbsp;getRulebase</tt><br>
<li>Check for a new rulebase (.snf) file<br/>
&nbsp;&nbsp;<tt>dir *.snf</tt></li>
</ul>
<br/>
<li>On Linux systems...</li>
<ul>
<li>Create an <tt>UpdateReady.txt</tt> file:<tt><br>
&nbsp;&nbsp;touch UpdateReady.txt</tt><br>
</li>
<li>Run the <tt>getRulebase</tt> script:<tt><br>
&nbsp;&nbsp;./getRulebase</tt><br>
<li>Check for a new rulebase (.snf) file<br>
&nbsp;&nbsp;<tt>ls *.snf</tt><br>
</ul>
</ul>

<blockquote><i>Note: The <B><tt>CGPSNF</tt></B> program will
automatically run the getRulebase
script as needed. However there must be a valid rulebase file present
before the CGPSNF program will run. This step also helps you verify that
the getRulebase script is configured correctly. If it is you will see a
new .snf file after running the script</i></blockquote>

<li>Proceed with <a HREF="#Test">Testing the Sniffer Plugin.</a></li>
</ul>

<h3><hr><a name=Test></a>Testing the Sniffer Plugin.</h3>
<p>On Windows System:</p>

<ul>
<li> Change to the module directory:<tt><br>
&nbsp;&nbsp;cd C:\CommuniGatePro\CGPSNF</tt><br>

<li>Launch the <tt>CGPSNF.exe</tt> application by typing:<tt><br>
&nbsp;&nbsp;CGPSNF</tt><br>
It will report the Plugin version number and build date.<br>

<li>Type: <br>
&nbsp;&nbsp;<tt>1 FILE junkmsg.txt</tt><br> The plugin should
report that the file is spam.


<li>Close the progrm by typing<br>
&nbsp;&nbsp;<tt>2 QUIT</tt>
</ul>

<p>On a Unix System:</p>
<ul>
<li> Change to the module directory:<tt><br>
&nbsp;&nbsp;cd /var/CommuniGate/CGPSNF</tt><br>

<li>Launch the <tt>CGPSNF</tt> application by typing:<tt><br>
&nbsp;&nbsp;./CGPSNF</tt><br>
It will report the Plugin version number and build date.<br>

<li>Type:<br>
&nbsp;&nbsp;<tt>1 FILE junkmsg.txt</tt><br>
the plugin should report that the file is spam.

<li>Close the program by typing<br>
&nbsp;&nbsp;<tt>2 QUIT</tt>

</ul>

<h3><hr><a name="Options"></a>Command Line Options</h3>
<dl>
<dd>
The Sniffer Plugin supports the following command-line option
(parameters):

<dl>
<p><dt><tt>path_to_config_file</tt></dt></p>

<dd>This option tells the Plugin to read the configuration from
<tt>path_to_config_file</tt>.
</dd>

</dl>

</dl>


<h3><hr><a name=Integrate></a>Integrating the Sniffer Plugin with CommuniGate Pro.</h3>

Please check
the <a HREF="http://www.communigate.com/CommuniGatePro/VirusScan.html#Launch">External
Filters</a> section of the CommuniGate Pro manual.

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


<center class="WebAdmin"><form action="Null.html">
<TABLE class="settingsBox" cellpadding="3" width="90%">
<table class="settingsBox" cellpadding="3" width="90%">
<caption>Content Filtering</caption>

<TR><TD BGCOLOR="#EEEEEE">
<TABLE class="settingsBox" WIDTH="100%" BORDER="0" CELLSPACING=1 CELLPADDING=0>
<TR>
<tr><td BGCOLOR="#EEEEEE">
<table class="settingsBox" WIDTH="100%" BORDER="0" CELLSPACING=1 CELLPADDING=0>
<tr>
<td align="right"><select name="U3"><option value="0">Disabled</option><option value="1" selected="selected">Enabled</option></select></td>
<td><input name="N3" value="ARM Sniffer" size="15" maxlength="200" type="text" /></td>
<TD colspan=2 ALIGN=center></TD>
</TR><TR>
<td colspan=2 align=center></td>
</tr><tr>
<td align="right" width="25%">Log Level:</td><td><select name="L3"><option value="0">Crashes Only</option><option value="1">Failures</option><option value="2">Major &amp; Failures</option><option value="3">Problems</option><option value="4" selected="selected">Low Level</option><option value="5">All Info</option></select></td>
<td align="right" width="25%">Program Path:</td><td><input name="P3"
value="CGPSNF/CGPSNF /var/CommuniGate/CGPSNF/snf_engine.xml" size="30" maxlength="255" type="text" /></td>
value="CGPSNF/CGPSNF" size="30" maxlength="255" type="text" /></td>

</TR><TR>
<TD ALIGN=RIGHT>Time-out:</TD><TD><SELECT NAME="T0"><OPTION VALUE=0>disabled<OPTION VALUE="15">15 seconds<OPTION VALUE="30">30 seconds<OPTION VALUE="60">minute<OPTION VALUE="120">2 minutes<OPTION VALUE="180">3 minutes<OPTION VALUE="300" SELECTED>5 minutes<OPTION VALUE="600">10 minutes<OPTION VALUE="900">15 minutes<OPTION VALUE="1800">30 minutes<OPTION VALUE="3600">hour</SELECT></TD>
<TD ALIGN=RIGHT>Auto-Restart:</TD><TD><SELECT NAME="A0"><OPTION VALUE=0>disabled<OPTION VALUE="5">5 seconds<OPTION VALUE="7">7 seconds<OPTION VALUE="10">10 seconds<OPTION VALUE="15">15 seconds<OPTION VALUE="30">30 seconds<OPTION VALUE="60" SELECTED>minute<OPTION VALUE="120">2 minutes<OPTION VALUE="180">3 minutes<OPTION VALUE="300">5 minutes<OPTION VALUE="600">10 minutes<OPTION VALUE="900">15 minutes<OPTION VALUE="1800">30 minutes<OPTION VALUE="3600">hour<OPTION VALUE="7200">2 hours<OPTION VALUE="10800">3 hours<OPTION VALUE="21600">6 hours</SELECT></TD>
</TR>
</TABLE></TD></TR>
</TABLE></FORM></center>
</tr><tr>
<td align=RIGHT>Time-out:</td><td><select name="T0"><option VALUE=0>disabled<option VALUE="15">15 seconds<option VALUE="30">30 seconds<option VALUE="60">minute<option VALUE="120">2 minutes<option VALUE="180">3 minutes<option VALUE="300" SELECTED>5 minutes<option VALUE="600">10 minutes<option VALUE="900">15 minutes<option VALUE="1800">30 minutes<option VALUE="3600">hour</select></td>
<td align=RIGHT>Auto-Restart:</td><td><select name="A0"><option VALUE=0>disabled<option VALUE="5">5 seconds<option VALUE="7">7 seconds<option VALUE="10">10 seconds<option VALUE="15">15 seconds<option VALUE="30">30 seconds<option VALUE="60" SELECTED>minute<option VALUE="120">2 minutes<option VALUE="180">3 minutes<option VALUE="300">5 minutes<option VALUE="600">10 minutes<option VALUE="900">15 minutes<option VALUE="1800">30 minutes<option VALUE="3600">hour<option VALUE="7200">2 hours<option VALUE="10800">3 hours<option VALUE="21600">6 hours</select></td>
</tr>
</table></td></tr>
</table></FORM></center>



<B>Note:</B> For Windows system the Program Path shold be
<TT>CGPSNF\CGPSNF.exe CGPSNF\snf_engine.xml</TT><BR>
<tt>CGPSNF\CGPSNF.exe</tt><br>
<B>Note:</B> On some versions of FreeBSD system you may need to
specify the full path to the program,
i.e. <tt>/var/CommuniGate/CGPSNF/CGPSNF /var/CommuniGate/CGPSNF/snf_engine.xml</tt>
i.e. <tt>/var/CommuniGate/CGPSNF/CGPSNF</tt>

<P>The recommended Scanning Rule is as follows:</P>
<p>The recommended Scanning Rule is as follows:</p>

<center class="WebAdmin"><form action="Null.html">
<TABLE class="settingsBox" cellpadding="3" width="90%">
<table class="settingsBox" cellpadding="3" width="90%">
<tr align="left">
<th>Data</th>
<th>Operation</th>
<th>Parameter</th>
</tr>
<TR>
<TD>
<SELECT NAME="c2"><OPTION VALUE="0" SELECTED>---<OPTION VALUE="12">Message Size</SELECT>
</TD><TD>
<SELECT NAME="o2"><OPTION VALUE="0" SELECTED>is<OPTION VALUE="4">greater than</SELECT>
</TD><TD>
<INPUT TYPE="text" NAME="p2" VALUE="" SIZE="20" MAXLENGTH="1024">
</TD>
</TR>
<tr>
<td>
<select name="c2"><option VALUE="0" selected>---<option VALUE="12">Message Size</select>
</td><td>
<select name="o2"><option VALUE="0" selected>is<option VALUE="4">greater than</select>
</td><td>
<INPUT TYPE="text" name="p2" VALUE="" SIZE="20" MAXLENGTH="1024">
</td>
</tr>

<tr align="left">
<th>Action</th>
<th colspan="2">Parameter</th>
</tr>
<TR VALIGN=TOP>
<TD><SELECT NAME="a0"><OPTION VALUE="0">---<OPTION VALUE="6">Stop Processing<OPTION VALUE="17" SELECTED>ExternalFilter</SELECT>
</TD><TD><TEXTAREA NAME="r0" ROWS="4" COLS="40">ARM Sniffer</TEXTAREA>
</TD>
</TR>
<TR VALIGN=TOP>
<TD><SELECT NAME="a1"><OPTION VALUE="0" SELECTED>---<OPTION VALUE="7">Stop Processing</SELECT></TD>
<TD colspan="2"><TEXTAREA NAME="r1" ROWS="4" COLS="40"></TEXTAREA></TD>
</TR>

</TABLE></FORM></center>

<hr/><div align="right" class="guideCopyright">CommuniGate&reg; Pro Guide. Copyright &copy; 1998-2009, Stalker Software, Inc.</div>

</BODY>
</HTML>
<tr valign=TOP>
<td><select name="a0"><option VALUE="0">---<option VALUE="6">Stop Processing<option VALUE="17" selected>ExternalFilter</select>
</td><td><textarea name="r0" rows="4" cols="40">ARM Sniffer</textarea>
</td>
</tr>
<tr valign=top>
<td><select name="a1"><option value="0" selected>---<option value="7">Stop Processing</select></td>
<td colspan="2"><textarea name="r1" rows="4" cols="40"></textarea></td>
</tr>
</table></form></center>
<hr/>
</body>
</html>

Write Preview
Loading…
Cancel
Save