summaryrefslogtreecommitdiff
path: root/mail/dspam/files/UPDATING
blob: 57b7dc48b3d4288335a04cbaae60d64312cf785f (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
# $FreeBSD$
#
# for each PKGNAME or user option change an entry should be added in this file
# each entry 

This file documents some of the problems you may encounter when
upgrading dspam port.  I will try my best to minimize these disruptions,
but sometimes they are unavoidable.

You should get into the habit of checking this file for changes each
time before attempting any port upgrade.

This file concetrate on the FreeBSD / port specific changes and one should read
also the UPGRADING enclosed in the dspam distribution. You can see it by doing
in the port directory:
make extract;  more `find . -type f -maxdepth 2 -name UPGRADING`

###########################################################################
# dspam-3.4.6.20050512.1145
#

BUGFIX: fixed signature embedding on malformatted boundary bug


###########################################################################
# dspam-3.4.6
#

- BUG FIX: "obscure" [1] bug causing dspam to crash under certain conditions
when the loose signature was provided without the appropriate delimiter
- BUG FIX: fix sqlite3 dependency check [2]
- BUG FIX: don't strip binary if we want GDB suport
- BUG FIX: DOMAIN_SCALE and LARGE_SCALE are incompatible so catch this
before ./cofigure fails [3]

[1] "Obscure" = it took me about 4 hours and a 500 queue processed one by
one by hand to catch and reproduce the problem after 7 days of mail 
processing w/o error
[2] Pointed out by vanilla@
[3] Pointed out by Arvinn L�kkebakken <arvinn@whitebird.no> for mail/dspam


###########################################################################
# dspam-3.4.5
#

A lot of things have changed and your existing dspam.conf won't probably
work anymore. Please compare it with the dspam.conf.sample located in the
same etc/ directory.

Most notable addition is the SMTP delivery which together with "standard"
inbound LMTP make a very nice content and light (e.g. it's the fastest setup
I've had so far) filter.

Database structure is roughly the same but you may wish to check your
existing database structure with the *.sql corresponding to you database
driver from EXAMPLESDIR (Mysql 4.1.x is now default as it's _much_ faster).
Please read carefully distributed docs like README and UPGRADING.

#############################################################################
# dspam-3.2.8
#

- BUGFIX: fixed TOE autowhitelist


#############################################################################
# dspam-3.2.7
#

- BUGFIX: Signature not written to some email, making them untrainable


#############################################################################
# dspam-3.2.6.20050128.1500
#

- disable ORACLE DB back-end; it's unmaintained and hasn't work on FreeBSD
- (added post-factum) Fix mysql/neural-combination
- (added post-factum) change POSTGRESQL* to POSTGRESQL because of "Split the 
postgresql ports into a server and a client part"


#############################################################################
# dspam-3.2.6
#

- In v3.2.6, the default level of statistical sedation has been changed from
5 to 0 (off). This feature is normally overridden by dspam.conf, but if you
have removed the feature from the default configuration, this may change
DSPAM's behavior. To ensure that nothing changes in your filter's behavior,
make sure the following line is in your dspam.conf:
Feature tb=5

- fix for statisticalSedation ignore


#############################################################################
# dspam-3.2.4
#

- drop WITH_WHITELIST, is not supported by ./configure but by dspam.conf

[20041203.0800] jonz: performance fixes for pgsql_drv
minor performance fixed for pgsql_drv that may have a big effect on some
implementations. you should also consider creating the (unnecessary) index
below to precent the pgsql query builder from getting confused:
CREATE INDEX id_token_data_04 ON dspam_token_data(uid);


#############################################################################
# dspam-3.2.3.20041229.1945
#

- drop QUARANTINE_AGENT as is not supported by ./configure anymore and
set in dspam.conf UntrustedDeliveryAgent and QuarantineAgent to default to
TrustedDeliveryAgent, but leave them commented out
(ports/75548 by Julien Gabel)
- change default DSPAM_HOME_MODE to 0770
(ports/75549 by Julien Gabel <jpeg@thilelli.net>)
- DSPAM_HOME_{OWNER,GROUP} default to DSPAM_{OWNER,GROUP}


#############################################################################
# dspam-3.2.3.20041218.2100_1
#

- fix installation of SQLite docs and implicitly package 
(reported by: pointyhat via kris@)

#############################################################################
# dspam-3.2.3.20041218.2100 (this is really 3.2.3 release)
#

- change of name: SQLITE --> SQLITE2, as the -devel port already have sqlite3
support
- fix deinstall to delete dspam.conf if it hasn't been cutomized, as 
requested by kris@ with "Ports Janitor" hat :)
- correct long-standing copy/paste bug DSPAM_{GROUPD,MODE} where set to
DSPAM_HOME_{GROUP,MODE} 

#############################################################################
# dspam-3.2.3.20041203.1245_1 (entry added post-factum, it was an automated 
#                            update approved by me but not under my control )
#

- chase dependecy for sqlite

#############################################################################
# dspam-3.2.3.20041203.1245
#

- now we support also MYSQL50 and we handle MYSQL cases right based on a 
patch sent by Gea-Suan Lin <gslin@netnews.NCTU.edu.tw>
- add support for exim as suggested by 
Shahbaz Javeed <sjaveed@adderpit.com>; we try to build exim with the same
database back-end if possible (still work to do to automate pg 7.3 case)
- fix PREF_EXT and BDB4 cases as well in our Makefile (actually is 4.1 and 
I'm thinking about dropping support for it since SQLite works a lot better if
you don't want a full sql server; feedback welcome)
- also small vendor bug-fixes (pgp signed mails, pgsql driver)

#############################################################################
#  dspam-3.2.3
#

- important fixes from 3.2.2:
 BUGFIX: DSPAM misreads boundary delimiter in signed Apple Mail messages
 BUGFIX: Signature is not written to multipart blocks with no content type
 BUGFIX: dspam_dump for a particular token fails with MySQL 4.1
 BUGFIX: Bayesian Noise Reduction is never instantiated

#############################################################################
#  dspam-3.2.2.20041117.1515:
#

- dspam configuration is now done via dspam.conf

- please remove any OPTION

- the following OPTIONS should be set now in dspam.conf
OPTION                  .conf name                      def. value
-------------------------------------------------------------------------------
DSPAM_HOME              Home                            /var/dspam
WITH_*_LDA              TrustedDeliveryAgent            mail.local
                        UntrustedDeliveryAgent          /usr/libexec/mail.local d %u
QUARANTINE_AGENT        QuarantineAgent                 #

WITH_SPAM_SUBJ          Preference "spamAction=tag"     #
                        Preference "spamSubject=SPAM"   #
USER_LOGGING            UserLog                         on
SYSTEM_LOGGING          SystemLog                       on
WEBMAIL                 TrainPristine                   off
WITH_OPT_IN             Opt                             out
SAT                     TrackSources spam ham           #
PARSE_TO_HEADERS        ParseToHeaders                  on
BROKEN_MTA              Broken lineStripping            #
BROKEN_ERR_CODES        Broken returnCodes              #
SIGNATURE_HEADERS       Preference "signatureLocation=  message" # headers

- the following OPTIONS should does not exist anymore:
SIGNATURE_ATACH WITH_HOMEDIR_DOT

- the following OPTIONS have their name changed to follow vedor names
TRAD_BAYES              GRAHAM_BAYES
ALT_BAYES               BURTON_BAYES
WITH_SIGNATURE_LIFE     SIGNATURE_LIFE

- new OPTIONS
OPTION                       port default
----------------------------------------------
LOG_DIR                         /var/log/dspam
WITH_USER_HOMEDIR             
DSPAM_HOME_OWNER
DSPAM_HOME_GROUP
DSPAM_HOME_MODE
DSPAM_MODE
DSPAM_OWNER
DSPAM_GROUP

To upgrade you should:

0. Read docs enclosed with teh dpsam distribution, beginnig with UPGRADING and
README

1. Adjust your OPTIONs
( make rmconfig config in dspam port dir, command line, pkg_tools.conf )

2. make VARs.......
in dspam port dir with appropiate OPTIONS and VARs (see changes above)

3. stop you MTA or deactivate dspam from it

5. make VARs........ install

4.a) If using MySQL 4.0.xx or PostgreSQL:
- back-up the database
- use the appropiate migration scripts from files dir of dspam port dir
( for MySQL you should use 2x_to_3x_db.sql then 310_to_320.my.sql)
(if using MySQL 4.1.x or 3.xx you're on your own for now; the same for 
PostgreSQL, but take a look in the UPDATING and 310_to_320.pg.sql)

5. Back-up and them move the files from the old DSPAM_HOME 
(defaulted: /usr/loca/etc/dspam) to the new DSPAM_HOME (default /var/db/dspam) 
or where ever you defined DSPAM_HOME in 2 above.

6. Adjust you new dspam.conf according with your setup OPTIONS and VARs defined
on make / mak install step.

7. Remove the old setup files (you have them in the back-up, right ?)

8. Enable dspam in the MTA setup, but only locally or something and start testing.

If something ain't working is one of:
- permissions problems (hint: with what UID 
is dspam called from your MTA vs. DSPAM_HOME and DSPAM_LOG_DIR)
- something wrong in dspam.conf (hint: you didn't remove old config files 
and they are still used ?)