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:
- Stop Kerio Connect.
- Open the mailserver.cfg file.
- Set the
EnableMetadataUpgrade
variable to0
(zero).
NOTE
If the variable is not available in the configuration file, add the following to the MessageStore
table:
<variable name="EnableMetadataUpgrade">0</variable>
- Save the configuration file.
- Start Kerio Connect.
- 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
- Stop Kerio Connect.
- Open the
mailserver.cfg
file. - Set the
EnableMetadataUpgrade
variable to0
(zero). - Set the
MetadataVersion
variable to0
(zero). - Save the file.
- Start Kerio Connect.
Re-enabling the new database type
To start using the new database type again after downgrading to the original type:
- Stop Kerio Connect.
- Delete all
metadata.dbo
andmetadata.dbb
files in the Kerio Connect installation folder. - Open the
mailserver.cfg
file. - Set the
EnableMetadataUpgrade
variable to1
. - Save the file.
- Start Kerio Connect.
Troubleshooting
If any problems occur, consult the Kerio Connect logs.
You can also run the upgrade again:
- Stop Kerio Connect.
- Set the
MetadataVersion
variable in the configuration file to0
(zero). - Set the
EnableMetadataUpgrade
variable to1
. - Delete all
metadata.dbb
andmetadata.dbo
files in each folder. - Restart Kerio Connect.