Symptoms
The Dovecot local template is removed and a notification with the subject "Local template detected during dovecot configuration update." is sent after updating to v94 of the cPanel software.
Description
In our version 94 release of the cPanel software, we upgraded Dovecot to version 2.3.11.3. Dovecot now stores SSL-related settings in the /etc/dovecot/ssl.conf file. To accommodate this change, the default template was updated to include this new section and configuration file.
As a result, pre-existing templates may be removed due to compatibility failures. Since the original custom template is no longer compatible, this is moved to a backup location matching the following format. Where unique string represents the characters generated to ensure the backup has a unique name.
/var/cpanel/templates/dovecot2.3/main.local.broken.$unique_string
The notification is intended to bring this to your attention, but this information is also outlined in our release notes below.
94-release-notes: Dovecot-upgraded-to-2-3-11-3
Workaround
Any custom templates generated before this update will need to be recreated or updated to include these changes. This can be done by either including the new SSL section in your template or applying your desired changes to the new default template that was created during the update.
You can view these changes by reviewing each file to compare the changes. A helpful command for this would be the diff utility as seen in the below example. In this example, you would need to change the main.local.broken entry to match the actual backup file name on your server.
cd /var/cpanel/templates/dovecot2.3/ ; diff -u main.default main.local.broken.$unique_string