Trying to configure SMTP with JNDI in Jira Server - no mail-xxx.jar

[Metin Savignano]

As stated here, the jars mail-1.4.1.jar and activation-1.1.1.jar have to be moved from from the <jira-application-dir>/WEB-INF/lib/ subdirectory of the JIRA application installation directory into the the lib/ subdirectory of the JIRA installation directory.

However, the docs seem to be incorrect, as my standard Jira installation doesn't have a mail-1.4.1.jar anywhere. Similarly named files I find are:

• WEB-INF/lib/atlassian-mail-2.8.6.jar
• WEB-INF/lib/javax.mail-1.5.6.jar
• WEB-INF/lib/javax.mail-api-1.5.6.jar

Is one of these to be moved? Or all of them? Or none at all?

Thanks!

[Metin Savignano · Accepted solution]

I have found an old mail-x.x.x.jar online, inspected what's in it, compared the contents with that of the jars I have in my installation, and so was able to make a good assumption, moving these jars instead of the non-existent mail-x.x.x.jar:

• atlassian-jira/WEB-INF/lib/javax.mail-1.5.6.jar
• atlassian-jira/WEB-INF/lib/javax.mail-api-1.5.6.jar

And my assumption seems to be correct, as the SMTP settings worked.

I've sent a request to Atlassian to update the docs, but let's see when this happens.

[Mirek]

Did you download .zip version of your JIRA version and look there for those files? I think that this is where you should be looking for your files.

[Metin Savignano]

Not sure what you mean. The installation instructions clearly speak of the application directories of the installed Jira.

Presumed I would find such a file in the zip, what would I do then?

[Mirek]

Doc says:     

To prevent any conflicts, check your application server's lib/ directory:     

If the application server already contains mail-1.4.1.jar and activation-1.1.1.jar, then just remove mail-1.4.1.jar and activation-1.1.1.jar from the <jira-application-dir>/WEB-INF/lib/ subdirectory of the JIRA application installation directory.      I

f the application server does not contain mail-1.4.1.jar and activation-1.1.1.jar, then move the mail-1.4.1.jar and activation-1.1.1.jar from the <jira-application-dir>/WEB-INF/lib/ subdirectory of the JIRA application installation directory into the the lib/ subdirectory of the JIRA installation directory (for 'recommended' distributions of JIRA) or the lib/ subdirectory of the application server running JIRA. 

So if you do not see the files in the JIRA Install and have a conflict, you should add those files.. If you see them then remove. This is how I understand that piece of documentation.

[Metin Savignano]

No, it's explained in the page: in the standard installation, these files are in atlassian-jira/WEB-INF/lib, and they have to be moved to /lib for JNDI to work because they must be reachable by the server.

Only if you use a custom server that already has these jars in its lib folder, you can (and must) simply remove these jars from atlassian-jira/WEB-INF/lib.