PMDF Installation Guide
Windows Edition

The following is a list of tasks which must be completed following an upgrade from V6.4 or earlier of PMDF. Sites upgrading from PMDF V6.5 or later should skip this section.

As of PMDF V6.5, the format of PMDF databases has changed from Berkeley DB (SleepyCat) to PBL. All databases must be rebuilt or converted in order for PMDF V6.5 or later to be able to read them. PMDF V6.5 or later cannot read any databases in V6.4 or earlier formats.

Note that PMDF's PBL databases consist of two files: database.pbl which contains the data, and database.idx which contains the index.

1. As listed in Section 1.5, you should run the utility c:\pmdf\bin\upgrade_all_dbs. This utility will:
   1. Rebuild the popstore/MessageStore user database, with the command:

      pmdf msgstore x-build-user-db

   2. Find and convert all other databases in the c:\pmdf tree, with the command:

      pmdf convertdb <old-database> <new-database>

      Note that the defragment database c:\pmdf\table\defragment_cache.* is excluded from this process. It does not need to be converted as the defragment channel will rebuild the database from the messages in the c:\pmdf\queue\defragment directory the first time it runs.

   3. Delete the now unused Berkeley DB (SleepyCat) environment files, with the commands:

      del c:\pmdf\tmp\__db.* del c:\pmdf\table\__db.*

2. You must rebuild or convert all remaining databases.
   All databases that are not converted by c:\pmdf\bin\upgrade_all_dbs should be rebuilt or converted by hand.
   1. All databases for which you have sources (including those sources you created before the upgrade using the pmdf dumpdb command) can be rebuilt using the pmdf crdb command.
   2. Databases created by utilities such as pmdf profile or pmdf password, and the databases created by MessageStore/popstore such as the forward database and the group names database must either be converted using pmdf convertdb or recreated by running the corresponding utility and adding each entry back in by hand.