<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>bogoupgrade</title><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry"><a name="bogoupgrade.1"></a><div class="titlepage"></div><div class="refnamediv"><a name="name"></a><h2>Name</h2><p>bogoupgrade &#8212; 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"><a name="description"></a><h2>DESCRIPTION</h2><p><span class="command"><strong>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"><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 class="command"><strong>bogoutil</strong></span>
command. It defaults to 'bogoutil', in the hopes that your shell will find
it.</p></div><div class="refsect1"><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 class="orderedlist" type="1"><li class="listitem"><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 class="listitem"><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 class="listitem"><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 class="listitem"><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 class="listitem"><p>Done. Restart any stopped daemons, cron tasks,
etc.</p></li></ol></div></div><div class="refsect1"><a name="author"></a><h2>AUTHOR</h2><p><span class="command"><strong>bogoupgrade</strong></span> was written by 
Gyepi Sam <code class="email">&lt;<a class="email" href="mailto:gyepi@praxis-sw.com">gyepi@praxis-sw.com</a>&gt;</code> and 
David Relson <code class="email">&lt;<a class="email" href="mailto:relson@osagesoftware.com">relson@osagesoftware.com</a>&gt;</code>.</p><p>For updates, see <a class="ulink" href="http://bogofilter.sourceforge.net/" target="_top">the
bogofilter project page</a>.</p></div><div class="refsect1"><a name="also"></a><h2>SEE ALSO </h2><p>bogofilter(1), bogolexer(1), bogotune(1), bogoutil(1)</p></div></div></body></html>
