debian/README.Debian

   1 --------------------------------------------------------------
   2   Integrating spamass-milter into your sendmail installation
   3 --------------------------------------------------------------
   4
   5 You will need to edit /etc/mail/sendmail.mc and add an
   6 INPUT_MAIL_FILTER line that connects to the spamass-milter socket.
   7
   8 By default the spamass-milter socket is
   9 /var/run/sendmail/spamass.sock; so your INPUT_MAIL_FILTER should look
  10 something like:
  11
  12  # spamassassin settings
  13  INPUT_MAIL_FILTER(`spamassassin',
  14          `S=local:/var/run/spamass/spamass.sock, F=,
  15          T=S:4m;R:4m;E:10m')dnl
  16
  17 Briefly, the F=, tells sendmail to just pass the connection through if
  18 the milter fails. This is most likely the setting you want. If you
  19 want to temporarily fail a connection, you can set F=T. You almost
  20 definitely don't want to reject connections, but if necessary, you can
  21 do that by setting F=R.
  22
  23 You may also need to adjust these timeout settings, as spamd can be
  24 sluggish on a slow machine. S is the timeout for sending information
  25 from the MTA to a filter. R is the timeout for reading a reply from
  26 the filter. E is the overall timeout between sending end-of-message to
  27 filter and waiting for the final acknowledgment.
  28
  29 The settings above seem to work well on a Celeron 466 that receives
  30 around 1000 emails an hour. You may wish to adjust them according to
  31 your needs.
  32
  33 See http://www.sendmail.com/partner/resources/development/milter_api/installation.html
  34 and http://www.sendmail.org/m4/adding_mailfilters.html#INPUT_MAIL_FILTER
  35 for more information on milters.
  36
  37 --------------------------------------------------------------
  38   Integrating spamass-milter into your postfix installation
  39 --------------------------------------------------------------
  40
  41 You need to edit /etc/postfix/main.cf and configure smptpd_milters so
  42 that postfix connects to the spamass-milter socket. Something like:
  43
  44   # spamass-milter configuration
  45   smtpd_milters = unix:/var/spool/postfix/spamass/spamass.sock
  46
  47 should work. See http://www.postfix.org/MILTER_README.html or
  48 /usr/share/doc/postfix/MILTER_README.gz (in postfix-doc) for
  49 information on how to set tempfail and the various timeouts that the
  50 sendmail configuration above uses.
  51
  52 You'll also want to change /etc/default/spamass-milter to use the
  53 SOCKET above, and also enable RUNAS so that it runs as the same user
  54 that will be connecting to the socket.
  55
  56 -------------------------------------------------------------
  57   Adjusting how spamass-milter is started
  58 -------------------------------------------------------------
  59
  60 You can adjust how spamass-milter starts, and the options it calls
  61 spamc with by adjusting /etc/default/spamass-milter. OPTIONS is passed
  62 directly to spamass-milter by /etc/init.d/spamass-milter.
  63
  64 -------------------------------------------------------------
  65 Debugging spamass-milter
  66 -------------------------------------------------------------
  67
  68 As spamass-milter is still undergoing development, you may see bugs
  69 from time to time.
  70
  71 If spamass-milter is segfaulting (SEGV or SIG 11) please build a
  72 debugging version of the spamass-milter package and install it:
  73
  74 mkdir temp;
  75 cd temp;
  76 apt-get source spamass-milter;
  77 apt-get build-dep spamass-milter;
  78 cd spamass-milter-*;
  79 DEB_BUILD_OPTIONS='nostrip' CXXFLAGS='-O0 -g' fakeroot debian/rules clean binary;
  80 dpkg -i spamass-milter*.deb;
  81
  82 Then turn on coredumps (ulimit -c unlimited), and start spamass-milter
  83 as usual (/etc/init.d/spamass-milter start).
  84
  85 When spamass-milter cores, run gdb on the core, ala:
  86 gdb /usr/sbin/spamass-milter /foo/corefile.pid
  87 thread apply all where
  88 bt
  89 q
  90
  91 and send the results along with your bug report using reportbug.
  92
  93  -- Don Armstrong <don@debian.org>, Tue,  2 Jan 2007 06:40:24 -0800