Upgrading the MAPI property database in Kerio Connect 9.1

NOTE

New in Kerio Connect 9.1!

Kerio Connect 9.1 includes a new type of database for storing MAPI properties. The property database upgrades automatically once you upgrade to Kerio Connect 9.1. The upgrade may take several minutes, depending on the size of your message store.

Kerio Connect retains the old database files in case you want to downgrade Kerio Connect. In that case, however, any changes since the upgrade are lost.

Monitoring the upgrade

The database starts upgrading immediately after the server upgrade.

To monitor the progress of the upgrade, open this URLUniform Resource Locator is the address of a web page on the world wide web. in your browser: http://<domain_name>:4040

NOTE

If you enable Message Folder Operations in the debug log before the upgrade, Kerio Connect displays the result of the upgrade in the debug log for each upgraded database file.

Enabling and disabling the upgrade

Kerio Connect upgrades the database type immediately after you upgrade to Kerio Connect 9.1. The upgrade is enabled by default.

To disable the upgrade in the Kerio Connect configuration file:

  1. Stop Kerio Connect.
  2. Open the mailserver.cfg file.
  3. Set the EnableMetadataUpgrade variable to 0 (zero).

NOTE

If the variable is not available in the configuration file, add the following to the MessageStore table:

<variable name="EnableMetadataUpgrade">0</variable>

  1. Save the configuration file.
  2. Start Kerio Connect.
  3. If you have Kerio Connect 9.0 or an earlier version, run the upgrade to Kerio Connect 9.1.

NOTE

To enable the upgrade again, set the EnableMetadataUpgrade variable to 1.

Using the old database type after upgrading

  1. Stop Kerio Connect.
  2. Open the mailserver.cfg file.
  3. Set the EnableMetadataUpgrade variable to 0 (zero).
  4. Set the MetadataVersion variable to 0 (zero).
  5. Save the file.
  6. Start Kerio Connect.

Re-enabling the new database type

To start using the new database type again after downgrading to the original type:

  1. Stop Kerio Connect.
  2. Delete all metadata.dbo and metadata.dbb files in the Kerio Connect installation folder.
  3. Open the mailserver.cfg file.
  4. Set the EnableMetadataUpgrade variable to 1.
  5. Save the file.
  6. Start Kerio Connect.

Troubleshooting

If any problems occur, consult the Kerio Connect logs.

You can also run the upgrade again:

  1. Stop Kerio Connect.
  2. Set the MetadataVersion variable in the configuration file to 0 (zero).
  3. Set the EnableMetadataUpgrade variable to 1.
  4. Delete all metadata.dbb and metadata.dbo files in each folder.
  5. Restart Kerio Connect.