JIRA 4.4.4 Upgrade Notes
Upgrading from JIRA 4.4.x to 4.4.4
Please follow the instructions in the general upgrading JIRA documentation.
Notes for plugin developers with custom mail handlers
JIRA 4.4.4 includes a dependency on atlassian-mail
version 1.25
which is not 100% backward compatible with atlassian-mail 1.24
included in previous releases of JIRA.
JIRA 4.4.4 also ships with javamail 1.4.4
, which we cannot guarantee is 100% compatible with javamail 1.4.1
(shipped with previous releases of JIRA).
Hence, there are two significant points to note as a result of these changes:
- The
com.atlassian.mail.server.MailServer.getSession()
method returns objects of thejavax.mail.Session
class rather thanalt.javax.mail.Session
- The classes from
mockobjects-j1.3-j2ee1.3.jar
are no longer exported (i.e. made available) to Atlassian version 2 plugins. Thisjar
is no longer distributed with JIRA.
Potential Impact and Solution
We believe that very few (if any) 3rd party plugins will be affected by the two changes mentioned above and that such plugins will be broken as a result of these changes.
- If your plugin uses the
com.atlassian.mail.server.MailServer.getSession()
method, doing either of the following should be sufficient to get it working with JIRA 4.4.4:- Recompile your plugin against 4.4.4
- Use a higher level class like
MailQueueItem
.
- If your plugin depends on
mockobjects-j1.3-j2ee1.3.jar
(which is highly unlikely and could be considered questionable), we encourage you to either:- Remove this dependency or
- If it is not possible to remove this dependency, bundle this
jar
with the plugin.
According to the changelog for javamail
(http://www.oracle.com/technetwork/java/javaee/changes-220864.txt), we believe that these changes should not negatively impact current plugins. On the contrary, many bug fixes and compatibility improvements in this new version of javamail
should make existing JIRA mail handlers more robust.
Rationale
JIRA 4.4.4 comes with substantial mail logging improvements and capabilities, which should be valuable to customers and support personnel troubleshooting problems related to incoming and outgoing mail.
Part of this feature work required the need to upgrade both the atlassian-mail
and javamail
libraries to the versions mentioned above. The anticipated small negative impact resulting from these upgraded libraries led us to believe that there was little or no business justification for supporting their older versions.
Upgrading from JIRA 4.3.x and earlier
In addition to the above, please read the JIRA 4.4 Upgrade Notes and as well as the Important Version-Specific Upgrade Notes for the versions of JIRA you are skipping.