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/spamass/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  define(`confMILTER_MACROS_CONNECT',`t, b, j, _, {daemon_name}, {if_name}, {if_addr}')dnl
  17  define(`confMILTER_MACROS_HELO',`s, {tls_version}, {cipher}, {cipher_bits}, {cert_subject}, {cert_issuer}')dnl
  18  define(`confMILTER_MACROS_ENVRCPT',`b, i, j, r, v, Z, _')dnl
  19
  20 Briefly, the F=, tells sendmail to just pass the connection through if
  21 the milter fails. This is most likely the setting you want. If you
  22 want to temporarily fail a connection, you can set F=T. You almost
  23 definitely don't want to reject connections, but if necessary, you can
  24 do that by setting F=R.
  25
  26 You may also need to adjust these timeout settings, as spamd can be
  27 sluggish on a slow machine. S is the timeout for sending information
  28 from the MTA to a filter. R is the timeout for reading a reply from
  29 the filter. E is the overall timeout between sending end-of-message to
  30 filter and waiting for the final acknowledgment.
  31
  32 The settings above seem to work well on a Celeron 466 that receives
  33 around 1000 emails an hour. You may wish to adjust them according to
  34 your needs.
  35
  36 See http://www.sendmail.com/partner/resources/development/milter_api/installation.html
  37 and http://www.sendmail.org/m4/adding_mailfilters.html#INPUT_MAIL_FILTER
  38 for more information on milters.
  39
  40 --------------------------------------------------------------
  41   Integrating spamass-milter into your postfix installation
  42 --------------------------------------------------------------
  43
  44 You need to edit /etc/postfix/main.cf and configure smptpd_milters so
  45 that postfix connects to the spamass-milter socket. Something like:
  46
  47   # spamass-milter configuration
  48   smtpd_milters = unix:/var/spool/postfix/spamass/spamass.sock
  49
  50 should work. Note, however, if you're using a chrooted version of
  51 postfix, you'll need the local path to the socket inside of the
  52 chroot. In recent versions of Debian the following should work:
  53
  54   # spamass-milter configuration
  55   smtpd_milters = unix:/spamass/spamass.sock
  56
  57 See http://www.postfix.org/MILTER_README.html or
  58 /usr/share/doc/postfix/MILTER_README.gz (in postfix-doc) for
  59 information on how to set tempfail and the various timeouts that the
  60 sendmail configuration above uses.
  61
  62 The defaults for spamass-milter adjust themselves so that no
  63 configuration in /etc/default/milter should be required. [However, if
  64 you are not doing so, see below.]
  65
  66 -------------------------------------------------------------
  67   Adjusting how spamass-milter is started
  68 -------------------------------------------------------------
  69
  70 You can adjust how spamass-milter starts, and the options it calls
  71 spamc with by adjusting /etc/default/spamass-milter. OPTIONS is passed
  72 directly to spamass-milter by /etc/init.d/spamass-milter. [Refer to
  73 spamass-milter(1) for details.]
  74
  75 Other settings which may be of use:
  76
  77 SOCKET sets the location of the socket; defaults to
  78 /var/run/spamass/spamass.sock unless you are running postfix, where it
  79 is set to /var/spool/postfix/spamass/spamass.sock.
  80
  81 SOCKETOWNER is the owner of the socket, which defaults to root:root or
  82 postfix:postfix if you're running postfix.
  83
  84 SOCKETMODE is the mode of the socket, which defaults to 0600 or 0660
  85 if you're running postfix.
  86
  87 RUNAS controls the user which spamass-milter runs as; defaults to
  88 spamass-milter.
  89
  90 -------------------------------------------------------------
  91 Debugging spamass-milter
  92 -------------------------------------------------------------
  93
  94 As spamass-milter is still undergoing development, you may see bugs
  95 from time to time.
  96
  97 If spamass-milter is segfaulting (SEGV or SIG 11) please build a
  98 debugging version of the spamass-milter package and install it:
  99
 100 mkdir temp;
 101 cd temp;
 102 apt-get source spamass-milter;
 103 apt-get build-dep spamass-milter;
 104 cd spamass-milter-*;
 105 DEB_BUILD_OPTIONS='nostrip' CXXFLAGS='-O0 -g' fakeroot debian/rules clean binary;
 106 dpkg -i spamass-milter*.deb;
 107
 108 Then turn on coredumps (ulimit -c unlimited), and start spamass-milter
 109 as usual (/etc/init.d/spamass-milter start).
 110
 111 When spamass-milter cores, run gdb on the core, ala:
 112 gdb /usr/sbin/spamass-milter /foo/corefile.pid
 113 thread apply all where
 114 bt
 115 q
 116
 117 and send the results along with your bug report using reportbug.
 118
 119  -- Don Armstrong <don@debian.org>, Thu, 21 Aug 2008 16:52:22 -0700