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                        10/22/2012                    BOGOUPGRADE(1)