$Id: UPGRADING,v 1.2 2003/02/25 23:05:42 rlaager Exp $

****! IMPORTANT !****

The database format has been totally changed since 0.9.6.

In PKS versions <= 0.9.6, the database backend was Berkeley db2. The code
was shipped with PKS. When the server was compiled, the database code was
statically linked into the executable.

Now, the database backend is Berkeley db4. The code is no longer shipped
with PKS. When the server is compiled, the database code is linked as the
linker sees fit. Typically, this means it is dynamically linked.

This change was made for several reasons. First, db2 is very old, and is
being removed from many systems. By moving to using a system-wide db4, we
can be freed from worrying about security flaws or bugs in our database
back-end. With dynamic linking (the default on most systems), upgrading the
system-wide db4 library to fix a bug will affect all programs using it,
including PKS.

To upgrade from a version of PKS that used the db2 backend, you must follow
this procedure:

1. Stop the pks daemon. Make sure no updates to the database will be made.
2. Dump the database using the old version of PKS.
3. Install the new version of PKS.
4. Import the old database.
5. Start the new pks daemon.

There are NO compatibility options for using an older database.

*********************