1BOGOUPGRADE(1)            Bogofilter Reference Manual           BOGOUPGRADE(1)
2
3
4

NAME

6       bogoupgrade - upgrades bogofilter database to current version
7

SYNOPSIS

9       bogoupgrade [-h] -d directory [-i input file] [-o output file]
10                   [-b path to bogoutil]
11

DESCRIPTION

13       bogoupgrade is a command to upgrade bogofilter´s databases from an old
14       format to the current format. Since the format of the database changes
15       once in a while, the utility is designed to make the upgrade easy.
16

OPTIONS

18       The -h option prints the help message and exits.
19
20       The -d specifies the directory with the wordlists for converting. This
21       option is used when converting from multiple, separate wordlists
22       (spamlist.db and goodlist.db - containing spam and ham tokens,
23       respectively) to a combined wordlist (wordlist.db) which contains both
24       spam and ham tokens.
25
26       The -i specifies the input file to be converted. It should be a text
27       file containing message counts, and possibly data. If there is no data
28       in the text file, there should be a Berkeley DB file in the same
29       directory as the text file which contains the data.
30
31       The -o specifies the output Berkeley DB file.
32
33       The -b gives the path to the bogoutil command. It defaults to
34       ´bogoutil´, in the hopes that your shell will find it.
35

UPGRADING

37       Follow these instructions to upgrade bogofilter´s databases to the
38       latest version.
39
40        1. Stop all instances of bogofilter. While the upgrade tools lock the
41           database files, the upgrade may take a long time if you have a busy
42           site. Don´t forget to stop cron jobs or daemons that fetch and
43           process mail and could fire off bogofilter.
44
45        2. Backup your data. Let´s assume that you said:
46
47               $ mv ~/.bogofilter ~/.bogofilter.safe
48               $ mkdir ~/.bogofilter
49
50        3. If your bogofilter version is less than 0.7, say:
51
52               $ bogoupgrade -i ~/.bogofilter.safe/goodlist -o ~/.bogofilter/goodlist.db
53               $ bogoupgrade -i ~/.bogofilter.safe/badlist -o ~/.bogofilter/spamlist.db
54
55           If your bogofilter version is 0.7 or greater, say:
56
57               $ bogoupgrade -i ~/.bogofilter.safe/hamlist.count -o ~/.bogofilter/goodlist.db
58               $ bogoupgrade -i ~/.bogofilter.safe/spamlist.count -o ~/.bogofilter/spamlist.db
59
60        4. Current versions of bogofilter use a combined wordlist that holds
61           both spam and non-spam tokens. It is named wordlist.db. If you´re
62           updating from a version older than 0.14.0 that has separate
63           wordlists (named goodlist.db and spamlist.db), use:
64
65               $ bogoupgrade -d ~/.bogofilter.safe
66
67        5. Done. Restart any stopped daemons, cron tasks, etc.
68

AUTHOR

70       bogoupgrade was written by Gyepi Sam gyepi@praxis-sw.com and David
71       Relson relson@osagesoftware.com.
72
73       For updates, see the bogofilter project page[1].
74

SEE ALSO

76       bogofilter(1), bogolexer(1), bogotune(1), bogoutil(1)
77

NOTES

79        1. the bogofilter project page
80           http://bogofilter.sourceforge.net/
81
82
83
84Bogofilter                        03/15/2010                    BOGOUPGRADE(1)
Impressum