Dovecot customised config main.local overwritten by update

km9

Active Member
Apr 5, 2017
33
7
8
Asia
cPanel Access Level
Root Administrator
I read in Configure Dovecot - Documentation - cPanel Documentation and Dovecot Custom Configuration. that I should be able to make permanent changes to the dovecot configuration by creating and modifying a 'main.local' file.

Last week, after the update to 64.0 (build 15) I noticed some unexpected behaviour, and found this in the logs:
Code:
[2017-04-19 22:19:38 +0700] This system’s custom Dovecot configuration appears to be older than the cPanel-supplied configuration. The system will rename the custom configuration to “/var/cpanel/templates/dovecot2.2/main.default.outdated.2017-04-19T15:19:38Z.2924591
2” and install a default configuration.
[2017-04-19 22:19:39 +0700] The local template file '/var/cpanel/templates/dovecot2.2/main.local' is invalid. The system will rename
it to /var/cpanel/templates/dovecot2.2/main.local.broken.1492615178.uq4E4yAAP6aXjr9R.
[2017-04-19 22:19:39 +0700] This system’s custom Dovecot configuration appears to be older than the cPanel-supplied configuration. The system will rename the custom configuration to “/var/cpanel/templates/dovecotSNI/main.default.outdated.2017-04-19T15:19:39Z.8056296
7” and install a default configuration.
And I arrived at work to find the configuration file reset to default and all my customisation bypassed. Should I be prepared for this to happen on every update in the future?
 
Last edited by a moderator:

cPanelMichael

Administrator
Staff member
Apr 11, 2011
47,884
2,250
463
Hello,

We made some updates to the Dovecot configuration in cPanel 64 that affects template customization. Here's the relevant section from the cPanel 64 Release Notes regarding this change:

Dovecot configuration
In cPanel & WHM version 64, we made updates to the Dovecot configuration.
Warnings:
  • We strongly recommend that you back up any .local template customizations before you upgrade.
  • If you use the /var/cpanel/templates/dovecot2.2/main.local file to override the default Dovecot configuration template, you must merge the changes in the /usr/local/cpanel/src/templates/dovecot2.2/main.default file when you upgrade to cPanel & WHM version 64; otherwise you will lose your customizations.
  • Not all prior customizations will be compatible with version 64. For more information, read our Configure Dovecot documentation.
Thank you.
 

km9

Active Member
Apr 5, 2017
33
7
8
Asia
cPanel Access Level
Root Administrator
Hello,

We made some updates to the Dovecot configuration in cPanel 64 that affects template customization. Here's the relevant section from the cPanel 64 Release Notes regarding this change:

Thank you.
Thanks Michael, That would have been great if I'd seen that before the update! I'm relatively new to cPanel, I guess the savvy users have switched somewhere to only update on demand, not automatically.

Thanks for the edit too, I couldn't see the syntax for code anywhere. (I've found it now)
 

cPanelMichael

Administrator
Staff member
Apr 11, 2011
47,884
2,250
463