Jira displays a "cipherType is not a field of MailServer" error after an upgrade

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

Symptoms

When starting up Jira after an upgrade, an Internal Server Error is displayed at the User Interface with the following stack trace:

1 2 3 4 5 6 7 8 9 java.lang.IllegalArgumentException: [GenericEntity.get] "cipherType" is not a field of MailServer at com.atlassian.cache.ehcache.DelegatingCachedReference.get(DelegatingCachedReference.java:77) [atlassian-cache-ehcache-4.0.2.jar:?] at com.atlassian.jira.cluster.cache.ehcache.BlockingParallelCacheReplicator.runDeferred(BlockingParallelCacheReplicator.java:172) [classes/:?] at com.atlassian.jira.cache.DeferredReplicationCachedReference.get(DeferredReplicationCachedReference.java:28) [classes/:?] at com.atlassian.mail.server.managers.OFBizMailServerManager$CacheHolder.getAll(OFBizMailServerManager.java:473) [classes/:?] at com.atlassian.mail.server.managers.OFBizMailServerManager.getAllServers(OFBizMailServerManager.java:128) [classes/:?] at com.atlassian.mail.server.managers.OFBizMailServerManager.getMailServersByType(OFBizMailServerManager.java:233) [classes/:?] at com.atlassian.mail.server.managers.OFBizMailServerManager.getSmtpMailServers(OFBizMailServerManager.java:136) [classes/:?] at com.atlassian.mail.server.managers.OFBizMailServerManager.getDefaultSMTPMailServer(OFBizMailServerManager.java:207) [classes/:?]

Diagnosis

  • Jira was upgraded to 8.12 or a newer version

  • The "cipher_type" column can't be found at the "mailserver" database table:

1 select * from mailserver;
  • The following line does not exist at the $JIRA_INSTALL/atlassian-jira/WEB-INF/classes/entitydefs/entitymodel.xml file:

1 <field name="cipherType" col-name="cipher_type" type="long-varchar"/>

Cause

A modified entitymodel.xml file is being used and does not contain the definition for the "cipher_type" column at the "mailserver" table, which is required for Jira 8.12+ installations.

Solution

Resolution

  1. Back up your modified entitymodel.xml file

  2. Download a .zip or .tar.gz installer for your Jira version

  3. Extract the downloaded file, then copy the ~/atlassian-jira/WEB-INF/classes/entitydefs/entitymodel.xml file from it and place the file at the same folder for your existing Jira installation. For a clustered environment, replace this file on all nodes.

  4. Restart Jira to apply the changes. For a clustered environment, restart all nodes.

Updated on April 11, 2025

Still need help?

The Atlassian Community is here for you.