madscientist
/
PKG-SNF4CGP-NIX
Watch 1
Star 0
Fork 0
Code Issues 0 Pull Requests 0 Releases 0 Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
16 Commits
1 Branch
Tree: 55a0dbe0df
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '55a0dbe0df'
${ noResults }
PKG-SNF4CGP-NIX/SNF4CGP_Developer_Package/Doc/default.html

default.html 14KB
Raw Blame History

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341 
  1. <HTML>

  2. <HEAD>

  3.   <TITLE>CommuniGate Pro: ARM Research Labs Sniffer Antispam Plugin</TITLE>

  4.   <link rel="stylesheet" href="GuideStyle.css" type="text/css" />

  5.   <link rel="stylesheet" href="AdminStyle.css" type="text/css" />

  6. 

  7. </HEAD>

  8. <BODY BGCOLOR=white>

  9. 

  10. <TABLE border=0 cellPadding=0 cellSpacing=0 width="100%">

  11.   

  12. <td><img src="CGPLogo.gif" alt="CommuniGate Pro" /></td>

  13. <tr><td class="tabBodyOuter">

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

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

  16. 		<div class="guideTOC"><ul>

  17. 

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

  19. 

  20. 

  21.   <LI><A href="#Download">Download the Sniffer Plugin</A> 

  22.   <LI><A href="#Install">Installation</A> 

  23.   <UL>

  24.     <LI><A href="#WIN32">Installing on a MS Windows 200x/NT/XP/9x System</A> 

  25.     <LI><A href="#Linux">Installing on a Linux System</A>

  26.     <LI><A href="#FreeBSD">Installing on a FreeBSD or OpenBSD System</A> 

  27.   </UL>

  28.   <LI><A href="#Upgrading">Upgrading to a newer version</A>

  29.   <LI><A href="#Conf">Configuring the Sniffer Plugin</A>

  30.   <LI><A href="#Config">Configuring the Sniffer Plugin</A>

  31.   <LI><A href="#Test">Testing the Sniffer Plugin</A>

  32.   <LI><A href="#Options">Command line options</A>

  33.   <LI><A href="#Integrate">Integrating the Sniffer Plugin with CommuniGate Pro</A>

  34.   <LI><A href="#Update">Updating the spam definitions database</A>

  35. 

  36. </ul></div>

  37. </TD></TR></TABLE>

  38. 

  39. </table>

  40. </TABLE>

  41. 

  42. 

  43. 

  44. <P><B>Note:</B> The ARM Research Labs Sniffer Plugin is available only

  45. for <I>some</I> platforms supported with the CommuniGate Pro server

  46. software. Before you order the Sniffer Plugin License, make sure that

  47. the available versions of the Sniffer Plugin software run on your

  48. CommuniGate Pro Server platform.

  49. 

  50. <P><B>Note:</B> The ARM Research Labs Sniffer Plugin requires

  51. CommuniGatePro version 5.2.3 or later.

  52. 

  53. 

  54. <H2><HR><A NAME="Download"></A>Download the ARM Research Labs Sniffer Plugins</H2>

  55. <DL><DD>

  56.   <P>ARM Research Labs Sniffer antispam plugins are available for certain platforms only.

  57. 

  58.   <TABLE class="guideTable" BORDER=1 CELLSPACING=0 CELLPADDING=1>

  59.     <TR BGCOLOR="#cccccc">

  60.        <TH NOWRAP rowspan=2 width=50%>Operating System</TH>

  61.        <TH NOWRAP rowspan=2>CPU</TH>

  62.        <TH NOWRAP colspan=2>Download</TH>

  63.     </TR>

  64. 

  65.     <TR BGCOLOR="#cccccc">

  66.        <TH NOWRAP>via<BR>http</TH>

  67.        <TH NOWRAP>via<BR>ftp</TH>

  68.     </TR>

  69. 

  70.     <TR>

  71.        <TD ALIGN=CENTER>Microsoft Windows NT/2000/XP<BR>Microsoft Windows 95/98</TD>

  72.        <TD ALIGN=CENTER>x86</TD>

  73.        <TD ALIGN=CENTER><A HREF="http://www.armresearch.com/pub/plugins/CGPSNF-Win32-Intel.zip">

  74. 	   <IMG SRC="DownLoad.gif" BORDER=0 WIDTH=16 HEIGHT=16></A></TD>

  75.        <TD ALIGN=CENTER><A HREF="ftp://ftp.armresearch.com/pub/plugins/CGPSNF-Win32-Intel.zip">

  76. 	   <IMG SRC="DownLoad.gif" BORDER=0 WIDTH=16 HEIGHT=16></A></TD>

  77.     </TR>

  78. 

  79.     <TR>

  80.        <TD ALIGN=CENTER>Linux<BR>Kernel 2.6 (stdc++ library version = 6.0)</TD>

  81.        <TD ALIGN=CENTER>x86</TD>

  82.        <TD ALIGN=CENTER><A HREF="http://www.armresearch.com/pub/plugins/CGPSNF-Linux-Intel.tar.gz">

  83. 	   <IMG SRC="DownLoad.gif" BORDER=0 WIDTH=16 HEIGHT=16></A></TD>

  84.        <TD ALIGN=CENTER><A HREF="ftp://ftp.armresearch.com/pub/plugins/CGPSNF-Linux-Intel.tar.gz">

  85. 	   <IMG SRC="DownLoad.gif" BORDER=0 WIDTH=16 HEIGHT=16></A></TD>

  86.     </TR>

  87. 

  88.     <TR>

  89.        <TD ALIGN=CENTER>FreeBSD 7.x</TD>

  90.        <TD ALIGN=CENTER>x86</TD>

  91.        <TD ALIGN=CENTER><A HREF="http://www.armresearch.com/pub/plugins/CGPSNF-FreeBSD7-Intel.tar.gz">

  92. 	   <IMG SRC="DownLoad.gif" BORDER=0 WIDTH=16 HEIGHT=16></A></TD>

  93.        <TD ALIGN=CENTER><A HREF="ftp://ftp.armresearch.com/pub/plugins/CGPSNF-FreeBSD7-Intel.tar.gz">

  94. 	   <IMG SRC="DownLoad.gif" BORDER=0 WIDTH=16 HEIGHT=16></A></TD>

  95.     </TR>

  96. 

  97.     <TR>

  98.        <TD ALIGN=CENTER>OpenBSD 4.3</TD>

  99.        <TD ALIGN=CENTER>x86</TD>

  100.        <TD ALIGN=CENTER><A HREF="http://www.armresearch.com/pub/plugins/CGPSNF-OpenBSD4.3-Intel.tar.gz">

  101. 	   <IMG SRC="DownLoad.gif" BORDER=0 WIDTH=16 HEIGHT=16></A></TD>

  102.        <TD ALIGN=CENTER><A HREF="ftp://ftp.armresearch.com/pub/plugins/CGPSNF-OpenBSD4.3-Intel.tar.gz">

  103. 	   <IMG SRC="DownLoad.gif" BORDER=0 WIDTH=16 HEIGHT=16></A></TD>

  104.    </TR>

  105. 

  106.   </TABLE>

  107. 

  108. </DL>

  109. 

  110. <P>The current version of the Plugin is 0.1.0.

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

  112. 

  113. 

  114. <H3><HR><A name=Upgrading></A>Upgrading to a newer version.</H3>

  115. <P>When upgrading the Plugin to a newer version, do the following steps:

  116. <UL>

  117.    <LI>Stop the current copy of the plugin application via CommuniGate Pro WebAdmin interface.

  118.    <LI>Install and configure the new version of the Plugin as described above in this document.

  119. </UL>

  120. 

  121. <H3><HR><A name="WIN32"></A>Installing on a MS Windows 200x/NT/XP/9x System.</H3>

  122. <UL>

  123.     <LI>Open the command-line interface window and 

  124. 	change the current directory to the CommuniGate Pro <I>base directory</I>.

  125.     <LI>Use any &quot;unzip&quot;-type tool to unpack the 

  126.      <TT>CGPSNF-Win32-Intel.zip</TT> file. The <TT>CGPSNF</TT> directory will be created inside the <I>base directory</I>. 

  127.     <LI>Proceed with <A HREF="#Config">Configuring the Sniffer Plugin</A>.

  128. </UL>

  129. 

  130. <H3><HR><A name=Linux></A>Installing on a Linux System.</H3>

  131. <UL>

  132.     <LI>Log in as a super-user (root).

  133.     <LI>Change the current directory to the CommuniGate Pro <I>base directory</I>.

  134.     <LI>Unpack the Plugin archive with the <TT>gtar</TT> command (or 

  135.     with the <TT>gunzip</TT> and <TT>tar</TT> commands):<TT><BR>

  136.         &nbsp;&nbsp;gunzip CGPSNF-FreeBSD-Intel.tar.gz<BR>

  137.         &nbsp;&nbsp;tar -xf CGPSNF-FreeBSD-Intel.tar</TT><BR>

  138.         The <TT>CGPSNF</TT> directory will be created inside the <I>base directory</I>. 

  139.     <LI>Proceed with <A HREF="#Config">Configuring the Sniffer Plugin</A>.

  140. </UL>

  141. 

  142. <H3><HR><A name=FreeBSD></A>Installing on a FreeBSD or OpenBSD System.</H3>

  143. <UL>

  144.     <LI>Log in as a super-user (root).

  145.     <LI>Change the current directory to the CommuniGate Pro <I>base directory</I>.

  146.     <LI>Unpack the Plugin archive with the <TT>gtar</TT> command (or 

  147.     with the <TT>gunzip</TT> and <TT>tar</TT> commands):<TT><BR>

  148.         &nbsp;&nbsp;gunzip CGPSNF-FreeBSD-Intel.tar.gz<BR>

  149.         &nbsp;&nbsp;tar -xf CGPSNF-FreeBSD-Intel.tar</TT><BR>

  150.         The <TT>CGPSNF</TT> directory will be created inside the <I>base directory</I>. 

  151.     <LI>Proceed with <A HREF="#Config">Configuring the Sniffer Plugin</A>.

  152. </UL>

  153. 

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

  155. 

  156. <P>In the module directory (<TT>/var/CommuniGate/CGPSNF</TT> on a

  157.   Linux or Linux-like system):

  158. <UL>

  159.     <LI>Copy the configuration file <TT><BR>

  160.       &nbsp;&nbsp;snf_engine.xml.sample</TT><BR> to <TT><BR>

  161.       &nbsp;&nbsp;snf_engine.xml</TT><BR> and customize as

  162.       needed.  Please see the <A href="http://www.armresearch.com">ARM

  163.       Research Labs web site</A> for documentation on

  164.       the <TT>snf_engine.xml</TT> configuration file.<BR>

  165. 

  166.     <LI>Copy <TT><BR>

  167.       &nbsp;&nbsp;identity.xml.sample</TT><BR> to <TT><BR>

  168.       &nbsp;&nbsp;identity.xml</TT><BR> and edit to include the

  169.       license ID and authentication attributes of

  170.       the <TT>&lt;identity&gt; element</TT>.<BR>

  171. 

  172.     <LI>Copy <TT><BR>

  173.       &nbsp;&nbsp;getRulebase.sample</TT><BR> to <TT><BR>

  174.       &nbsp;&nbsp;getRulebase.xml</TT><BR> and edit to include the

  175.       license ID and authentication:

  176. 

  177.       <UL>

  178. 	<LI>Change the line <TT><BR>

  179. 	    &nbsp;&nbsp;AUTHENTICATION=authenticationxx</TT><BR>

  180. 	    to <TT><BR>

  181. 	    &nbsp;&nbsp;AUTHENTICATION=YOUR_AUTHENTICATION</TT><BR>

  182. 	    where <TT>YOUR_AUTHENTICATION</TT> is authentication code

  183. 	    obtained from ARM Research Labs.</LI>

  184. 

  185. 	<LI>Change the line <TT><BR>

  186. 	    &nbsp;&nbsp;LICENSE_ID=licenseid</TT><BR> to <TT><BR>

  187. 	    &nbsp;&nbsp;LICENSE_ID=YOUR_LICENSE_ID</TT><BR>

  188. 	    where <TT>YOUR_LICENSE_ID</TT> is license ID obtained from

  189. 	    ARM Research Labs.</LI>

  190. 

  191.       </UL>

  192. <BR>

  193. 

  194.     <LI>Copy <TT><BR>

  195.       &nbsp;&nbsp;GBUdbIgnoreList.sample</TT><BR> to <TT><BR>

  196.       &nbsp;&nbsp;GBUdbIgnoreList</TT><BR> and customize as

  197.       needed.  Please see the

  198.       <A href="http://www.armresearch.com">ARM Research Labs web

  199.       site</A> for documentation on the <TT>GBUdbIgnoreList</TT>

  200.       file.<BR>

  201. 

  202.     <LI>Download the Sniffer database:

  203.       <UL>

  204. 	<LI>Create the file <TT>UpdateReady.txt</TT> in the plugin directory:<TT><BR>

  205. 	    &nbsp;&nbsp;touch UpdateReady.txt</TT><BR>

  206. 	</LI>

  207. 	<LI>Run the <TT>getRulebase</TT> script in the plugin

  208. 	  directory:<TT><BR>

  209. 	    &nbsp;&nbsp;./getRulebase</TT><BR>

  210. 	  This downloads the Sniffer database to the plugin directory.

  211.       </UL>

  212. 

  213.       The <B><TT>CGPSNF</TT></B> program automatically updates the

  214.       Sniffer database as needed.

  215. 

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

  217. </UL>

  218. 

  219. 

  220. 

  221. <H3><HR><A name=Test></A>Testing the Sniffer Plugin.</H3>

  222. <P>On Windows System:

  223. <!--

  224. <UL>

  225.     <LI>Launch the <TT>CGPSNF.exe</TT> application by typing:<TT><BR>

  226.       &nbsp;&nbsp;CGPSNF\CGPSNF.exe CGPSNF\snf_engine.xml</TT><BR>

  227.       It will report the Plugin version number and build date.<BR>

  228. 

  229.     <LI>Type:<TT><BR>

  230.        &nbsp;&nbsp;1 FILE CGPSNF\junkmsg.msg</TT><BR>

  231.        The plugin should report that the file is spam.

  232.     <LI>Quit <TT>CGPSNF.exe</TT> by typing Ctrl-Z.  

  233. </UL>

  234. -->

  235. 

  236. <P>On a Unix System:

  237.   <UL>

  238.     <LI> Change to the module directory:<TT><BR>

  239. 	&nbsp;&nbsp;cd /var/CommuniGate/CGPSNF</TT><BR>

  240. 

  241.     <LI>Launch the <TT>CGPSNF</TT> application by typing:<TT><BR>

  242.       &nbsp;&nbsp;./CGPSNF snf_engine.xml</TT><BR>

  243.       It will report the Plugin version number and build date.<BR>

  244. 

  245.     <LI>Type:<TT><BR>

  246.        &nbsp;&nbsp;1 FILE junkmsg.txt</TT><BR>

  247.        the plugin should report that the file is spam.

  248. 

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

  250. </UL>

  251. 

  252. <H3><HR><A NAME="Options"></A>Command Line Options</H3>

  253. <DL><DD>

  254.   The Sniffer Plugin supports the following command-line option (parameters):<DL>

  255.   <P><DT><TT>snf_engine.xml</TT>

  256.   <DD>This option tells the Plugin to read the <TT>snf_engine.xml</TT>

  257.     configuration file.

  258. 

  259. </DL>

  260. </DL>

  261. 

  262. 

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

  264. 

  265. Please check the <A

  266. HREF="http://www.communigate.com/CommuniGatePro/VirusScan.html#Launch">External

  267. Filters</A> section of the CommuniGate Pro manual. 

  268. 

  269. <P>Open the General page in the Settings section of the WebAdmin Interface and click the Helpers link.

  270. Create the Helper as follows:

  271. 

  272. 

  273. <center class="WebAdmin"><form action="Null.html">

  274. <TABLE  class="settingsBox" cellpadding="3" width="90%">

  275.   <caption>Content Filtering</caption>

  276. 

  277. <TR><TD BGCOLOR="#EEEEEE">

  278. <TABLE class="settingsBox" WIDTH="100%" BORDER="0" CELLSPACING=1 CELLPADDING=0>

  279.  <TR>

  280.   <td align="right"><select name="U3"><option value="0">Disabled</option><option value="1" selected="selected">Enabled</option></select></td>

  281.   <td><input name="N3" value="ARM Sniffer" size="15" maxlength="200" type="text" /></td>

  282.   <TD colspan=2 ALIGN=center></TD>

  283.  </TR><TR>

  284.   <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>

  285.   <td align="right" width="25%">Program Path:</td><td><input name="P3"

  286.     value="CGPSNF/CGPSNF /var/CommuniGate/CGPSNF/snf_engine.xml" size="30" maxlength="255" type="text" /></td>

  287. 

  288.  </TR><TR>

  289.   <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>

  290.   <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>

  291.  </TR>

  292. </TABLE></TD></TR>

  293. </TABLE></FORM></center>

  294. 

  295. 

  296. 

  297. <B>Note:</B> For Windows system the Program Path shold be

  298. <TT>CGPSNF\CGPSNF.exe CGPSNF\snf_engine.xml</TT><BR>

  299. <B>Note:</B> On some versions of FreeBSD system you may need to

  300. specify the full path to the program,

  301. i.e. <tt>/var/CommuniGate/CGPSNF/CGPSNF /var/CommuniGate/CGPSNF/snf_engine.xml</tt>

  302. 

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

  304. 

  305. <center class="WebAdmin"><form action="Null.html">

  306. <TABLE class="settingsBox" cellpadding="3" width="90%">

  307.         <tr align="left">

  308. 	   <th>Data</th>

  309. 	   <th>Operation</th>

  310. 	   <th>Parameter</th>

  311. 	</tr>

  312. <TR>

  313.  <TD>

  314.   <SELECT NAME="c2"><OPTION VALUE="0" SELECTED>---<OPTION VALUE="12">Message Size</SELECT>

  315.  </TD><TD>

  316.   <SELECT NAME="o2"><OPTION VALUE="0" SELECTED>is<OPTION VALUE="4">greater than</SELECT>

  317.  </TD><TD>

  318.   <INPUT TYPE="text" NAME="p2" VALUE="" SIZE="20" MAXLENGTH="1024">

  319.  </TD>

  320. </TR>

  321. 

  322. <tr align="left">

  323. 	   <th>Action</th>

  324. 	   <th colspan="2">Parameter</th>

  325. 	</tr>

  326. <TR VALIGN=TOP>

  327.  <TD><SELECT NAME="a0"><OPTION VALUE="0">---<OPTION VALUE="6">Stop Processing<OPTION VALUE="17" SELECTED>ExternalFilter</SELECT>

  328.  </TD><TD><TEXTAREA NAME="r0" ROWS="4" COLS="40">ARM Sniffer</TEXTAREA>

  329.  </TD>

  330. </TR>

  331. <TR VALIGN=TOP>

  332.  <TD><SELECT NAME="a1"><OPTION VALUE="0" SELECTED>---<OPTION VALUE="7">Stop Processing</SELECT></TD>

  333.  <TD colspan="2"><TEXTAREA NAME="r1" ROWS="4" COLS="40"></TEXTAREA></TD>

  334. </TR>

  335. 

  336. </TABLE></FORM></center>

  337. 

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

  339. 

  340. </BODY>

  341. </HTML>