Phone Lines icon GFI Support Home

Articles in this section

See more

Upgrading the MAPI Property Database in Kerio Connect 9.1

Author: Vladyslav Velychko Updated

Overview

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. However, if you downgrade, any changes since the upgrade will be lost.

This article describes how to perform several important processes related to the Kerio Connect 9.1 upgrade, namely, monitoring, enabling, and disabling the upgrade; changing between the old and new database types; and troubleshooting.

 

 

Process

This section describes the following processes related to the Kerio Connect 9.1 upgrade:

 

 

Monitoring the Upgrade

The database starts upgrading immediately after the server upgrade.

To monitor the progress of the upgrade, open this URL 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, perform the following steps:

  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>

  4. Save the configuration file.
  5. Start Kerio Connect.
  6. 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

To use the old database type after upgrading, perform the following steps:

    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, follow these steps:

  1. Stop Kerio Connect.
  2. Delete all the metadata.dbo and metdata.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 user's folder.
  5. Start Kerio Connect.

 

Back to top

Related Articles

Transferring the Configurations and Mail Store Directory of Kerio Connect to Another Server or OS

Back to top

Related articles