{\rtf1\ansi\ansicpg1252\cocoartf1038\cocoasubrtf110
{\fonttbl\f0\fswiss\fcharset0 Optima-Regular;\f1\fswiss\fcharset0 Helvetica;\f2\fnil\fcharset0 LucidaGrande;
\f3\fswiss\fcharset0 Optima-DemiBold;\f4\fnil\fcharset0 Monaco;}
{\colortbl;\red255\green255\blue255;\red0\green51\blue153;}
\paperw11900\paperh16840\margl1440\margr1440\vieww14480\viewh13640\viewkind1
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural

\f0\b\fs52 \cf0 \
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\qc
\cf0 spamtrainer\
\
Mac OS X 10.6.x, 10.5.x, 10.4.x, 10.3.x\
Spam Training Script\
\
\

\f1 \
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural

\f2\b0\fs22 \cf0 \
\
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural

\f0\fs28 \cf0 \ul \ulc2 	
\f2\b \ulnone   
\f3 1
\f2 . - Introduction\
\
	  
\f3 2
\f2 . - Installation\
\
 	  3. - How to use the script\
\
 	  4. - Caveats\
\
\
\
\
\
\
\
\
\
\
\
\
\
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural

\f0\b0 \cf2 \ul \
	 
\f2\fs22 \cf0 \ulnone \
\
\
\
\
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural

\f0\b\fs32 \cf0 1. - Introduction\
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural

\f2\b0\fs22 \cf0 \
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural

\f4\fs24 \cf0 spamtrainer was written to assist mail services administrators in updating and maintaining their SpamAssassin bayes database.\
\
When run, it will read the designated HAM and SPAM mailboxes, update the SpamAssassin databases and delete mail that has been learned from. \
\
It furthermore has an array of additional functions. Among them the possibility to backup/restore your bayes database, fix the Tiger default installation and many more. See "man spamtrainer" for detailed information.\
\
This script is written for Mac OS X 10.6.x, 10.5.x and 10.4.x, but it will work on Mac OS X 10.3.x with SpamAssassin as well.\
\
\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
\cf0 \
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural

\f0\b\fs32 \cf0 2. - Installation\
\
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural

\f4\b0\fs24 \cf0 1. Double-click on spamtrainer.pkg and follow the on-screen instructions. That's all.\
\
Please note that spamtrainer will check for updates when run interactively. It is recommended that upgrades be accepted.\
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural

\f0\b\fs32 \cf0 \
\
3. - How to use the script\
\
\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural

\f4\b0\fs24 \cf0 You have several options with the first being to run the script manually from the command line. To do so open terminal and issue:\
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural

\fs20 \cf0 /usr/sbin/spamtrainer\
\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural

\fs24 \cf0 Without passing it any additional parameters it will just assume that yours is a standard installation (standard as per Apple's Mail Services Manual) and that a user junkmail and a user notjunkmail exist in the default mailstore/mailpartition. It will not delete/purge any mailboxes.\
\
The script is very flexible and through parameters you can change the partition name, the junkmail (SPAM) and notjunkmail (HAM) mailboxes and the path to sa-learn.\
\
To get additional information you can issue:\
\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural

\fs20 \cf0 man spamtrainer
\fs24  for the online manual\
or:\
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural

\fs20 \cf0 /usr/sbin/spamtrainer -h 
\fs24 for the built-in help\
\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
\cf0 \
Alternatively you can ask spamtrainer to create a startup item that will run the script automatically at a given time. \
\
Just issue\
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural

\fs20 \cf0 /usr/sbin/spamtrainer -i
\fs24 \
\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
\cf0 and spamtrainer will guide you through setting up a startup item with the desired options.\
\
NOTE: Spamtrainer will do its best to check for existing startup items for 'learn_junk_mail' (Apple's default script) and guide you through disabling it. However it is impossible to contemplate all scenarios, especially if you happened to create your own cron jobs other than the default installation. However, in this case you probably know what to do ;-)\
\
\
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural

\f0\b\fs32 \cf0 4. - Caveats
\f4\b0\fs24 \
\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
\cf0 \
As far as 'spamtrainer' is concerned, none. There are however some configuration issues with some of Apple's default amavisd configurations on OS X Server 10.4.x Tiger.\
\
These can be fixed by issuing\
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural

\fs20 \cf0 /usr/sbin/spamtrainer -f
\fs24 \
\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
\cf0 \
If you have already modified your configuration files yourself, this may not work. In that case read on...\
\
The first issue is that amavisd is set to read the .spamassassin database from a different directory than the one updated by SpamAssassin's learn routines. This can be fixed by adding a symbolic link to /var/clamav/.spamassassin.\
\
To do so open terminal and issue:\
\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural

\fs20 \cf0 serveradmin stop mail\
cd /var/amavis\
rm /.spamassassin\
ln -s /private/var/clamav/.spamassassin /private/var/amavis/.spamassassin\
serveradmin start mail
\fs24 \
\
The second issue is with the configuration missing a necessary parameter to cater to virtual mail domains.\
To solve this you need to open /etc/amavisd.conf in a text editor (not Word).\
 \
Look for a line like "
\fs20 @local_domains_maps = ( 1 );
\fs24 ". If you find it and it is uncommented, you're all set.\
\
If not open terminal and issue:\

\fs20 serveradmin stop mail
\fs24 \
edit /etc/amavisd.conf and add "
\fs20 @local_domains_maps = ( 1 );
\fs24 " below either one of these lines: \
"
\fs20 @local_domains_acl = ( ".$mydomain" );
\fs24 "\
"
\fs20 @local_domains_maps = ( [".$mydomain"] );
\fs24 "\
save and issue:\

\fs20 serveradmin start mail
\fs24 \
\
\
If you find any other caveats, let me know.\
\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural

\f2 \cf0 \
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural

\f4 \cf0 That's all folks.\
Hope this helps.\
Have fun,\
Alex\
\
------------------------------\
Doc. Version 1.9.5, 28.9.2009\
Athanasios Alexandrides\
Lugano, Switzerland\
tools -at- topicdesk.com\
------------------------------}