<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>bogoupgrade</title><meta name="generator" content="DocBook XSL Stylesheets V1.70.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="bogoupgrade.1"></a><div class="titlepage"></div><div class="refnamediv"><a name="name"></a><h2>Name</h2><p>bogoupgrade — upgrades <span class="application">bogofilter</span> database to current version</p></div><div class="refsynopsisdiv"><a name="synopsis"></a><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">bogoupgrade</code> [-h] -d <em class="replaceable"><code>directory</code></em> [-i <em class="replaceable"><code>input file</code></em>] [-o <em class="replaceable"><code>output file</code></em>] [-b <em class="replaceable"><code>path to bogoutil</code></em>]</p></div></div><div class="refsect1" lang="en"><a name="description"></a><h2>DESCRIPTION</h2><p><span><strong class="command">bogoupgrade</strong></span> is a command to upgrade <span class="application">bogofilter</span>'s databases from an old format to the current format. Since the format of the database changes once in a while, the utility is designed to make the upgrade easy.</p></div><div class="refsect1" lang="en"><a name="options"></a><h2>OPTIONS</h2><p>The <code class="option">-h</code> option prints the help message and exits.</p><p>The <code class="option">-d</code> specifies the directory with the wordlists for converting. This option is used when converting from multiple, separate wordlists (spamlist.db and goodlist.db - containing spam and ham tokens, respectively) to a combined wordlist (wordlist.db) which contains both spam and ham tokens.</p><p>The <code class="option">-i</code> specifies the input file to be converted. It should be a text file containing message counts, and possibly data. If there is no data in the text file, there should be a Berkeley DB file in the same directory as the text file which contains the data.</p><p>The <code class="option">-o</code> specifies the output Berkeley DB file.</p><p>The <code class="option">-b</code> gives the path to the <span><strong class="command">bogoutil</strong></span> command. It defaults to 'bogoutil', in the hopes that your shell will find it.</p></div><div class="refsect1" lang="en"><a name="upgrading"></a><h2>UPGRADING</h2><p>Follow these instructions to upgrade <span class="application">bogofilter</span>'s databases to the latest version.</p><div class="orderedlist"><ol type="1"><li><p>Stop all instances of <span class="application">bogofilter</span>. While the upgrade tools lock the database files, the upgrade may take a long time if you have a busy site. Don't forget to stop cron jobs or daemons that fetch and process mail and could fire off <span class="application">bogofilter</span>.</p></li><li><p>Backup your data. Let's assume that you said:</p><pre class="screen"> <code class="prompt">$</code> <strong class="userinput"><code>mv ~/.bogofilter ~/.bogofilter.safe</code></strong> <code class="prompt">$</code> <strong class="userinput"><code>mkdir ~/.bogofilter</code></strong> </pre></li><li><p>If your <span class="application">bogofilter</span> version is less than 0.7, say:</p><pre class="screen"> <code class="prompt">$</code> <strong class="userinput"><code>bogoupgrade -i ~/.bogofilter.safe/goodlist -o ~/.bogofilter/goodlist.db</code></strong> <code class="prompt">$</code> <strong class="userinput"><code>bogoupgrade -i ~/.bogofilter.safe/badlist -o ~/.bogofilter/spamlist.db</code></strong> </pre><p>If your <span class="application">bogofilter</span> version is 0.7 or greater, say:</p><pre class="screen"> <code class="prompt">$</code> <strong class="userinput"><code>bogoupgrade -i ~/.bogofilter.safe/hamlist.count -o ~/.bogofilter/goodlist.db</code></strong> <code class="prompt">$</code> <strong class="userinput"><code>bogoupgrade -i ~/.bogofilter.safe/spamlist.count -o ~/.bogofilter/spamlist.db</code></strong> </pre></li><li><p>Current versions of <span class="application">bogofilter</span> use a combined wordlist that holds both spam and non-spam tokens. It is named wordlist.db. If you're updating from a version older than 0.14.0 that has separate wordlists (named goodlist.db and spamlist.db), use:</p><pre class="screen"> <code class="prompt">$</code> <strong class="userinput"><code>bogoupgrade -d ~/.bogofilter.safe</code></strong> </pre></li><li><p>Done. Restart any stopped daemons, cron tasks, etc.</p></li></ol></div></div><div class="refsect1" lang="en"><a name="author"></a><h2>AUTHOR</h2><p><span><strong class="command">bogoupgrade</strong></span> was written by Gyepi Sam <code class="email"><<a href="mailto:gyepi@praxis-sw.com">gyepi@praxis-sw.com</a>></code> and David Relson <code class="email"><<a href="mailto:relson@osagesoftware.com">relson@osagesoftware.com</a>></code>.</p><p>For updates, see <a href="http://bogofilter.sourceforge.net/" target="_top">the bogofilter project page</a>.</p></div><div class="refsect1" lang="en"><a name="also"></a><h2>SEE ALSO </h2><p>bogofilter(1), bogolexer(1), bogotune(1), bogoutil(1)</p></div></div></body></html>