Problem Definition

Bamboo 6.0.x ships with an additional library (javax.mail-api-1.5.6.jar) that needs to be moved when setting up a JNDI resource for SMTP.

The existing documentation has not yet been updated to make reference to the new library as one that needs to be moved and only talks about javax.mail-X.X.X.jar:

• Configuring Bamboo to send SMTP Email

Failure to do so will result in errors when testing the SMTP configuration such as:

ognl.MethodFailedException: Method "edit" failed for object com.atlassian.bamboo.ww2.actions.admin.mail.ConfigureMailServer@15fc28f8
...
Caused by: java.lang.LinkageError: loader constraint violation: loader (instance of java/net/URLClassLoader) previously initiated loading for a different type with name "javax/mail/Session"
	at java.lang.ClassLoader.defineClass1(Native Method)
...
/-- Encapsulated exception ------------\
java.lang.LinkageError: loader constraint violation: loader (instance of java/net/URLClassLoader) previously initiated loading for a different type with name "javax/mail/Session"
	at java.lang.ClassLoader.defineClass1(Native Method)

Suggested Solution

Update Configuring Bamboo to send SMTP Email to mention that from 6.0 and on javax.mail-api-x.x.x.jar needs be moved in addition to javax.mail-X.X.X.jar.

Include a note about it's inclusion and necessity to move (if using a JNDI mail resource) in the 6.0 upgrade notes on the upgrade guide:

• Bamboo upgrade guide