HISSQLITE-CONVERT(8)

NAME
hissqlite-convert - Convert an INN history database to the hissqlite method

SYNOPSIS
hissqlite-convert [-m srcmethod] srcpath dstpath

DESCRIPTION
hissqlite-convert performs a faithful, one-time migration of an existing INN history database into a new hissqlite (SQLite) database. It reads every entry from the source history through the standard history interface and bulk-loads it into a freshly created hissqlite database.

The conversion is keyed by hash: the history records only the MD5 of each Message-ID, not the Message-ID itself, so the original Message-IDs cannot be recovered. Unlike a from-spool rebuild with makehistory, this preserves both the exact arrival, posting, and expiration timestamps and the remembered (token-less) entries, which a rebuild cannot reconstruct.

The new database is built in a temporary file and atomically renamed into place only on full success, so an interrupted or failed run never leaves a usable-but-incomplete destination. hissqlite-convert refuses to run if the destination already exists.

innd must not be writing the source history while it is being converted. After a successful conversion, set hismethod to "hissqlite" in inn.conf and restart INN; see hissqlite(5). You may also want to audit the new database with hissqlite-util to ensure everything went fine.

OPTIONS

-m srcmethod
    The history method of the source database. The default is "hisv6".

ARGUMENTS

srcpath
    The path to the source history. For "hisv6", it is pathhistory/history without any extension, as given by the pathhistory parameter in inn.conf.

dstpath
    The path of the hissqlite database to create. A .sqlite suffix is appended, so dstpath should match pathhistory/history (the resulting file is history.sqlite in pathhistory).

EXAMPLES
Convert the default "hisv6" history into a hissqlite database alongside it:

    hissqlite-convert /news/db/history /news/db/history

This creates /news/db/history.sqlite.

HISTORY
Written by Kevin Bowling for InterNetNews.

SEE ALSO
hissqlite(5), hissqlite-util(8), history(5), inn.conf(5), makehistory(8).