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.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 ) - DSPAM_HOME_{OWNER,GROUP} default to DSPAM_{OWNER,GROUP} - fix make describe by USE_MYSQL ############################################################################# # 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 - add support for exim as suggested by Shahbaz Javeed ; 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 ?)