Documentation for JIRA 4.4. Documentation for other versions of JIRA is available too.
This page lists a few things to be aware of when upgrading from previous releases of JIRA to JIRA 3. To perform the actual upgrade, see the upgrade documentation.
In JIRA 3, email notification 'From' addresses now contain the reporter name, eg. "Joe Bloggs (JIRA) <jira@company.com>", where "jira@company.com" is set by the admin as the SMTP mail server From address. If you have this address to already include a name (eg "Tech Support <jira@company.com>", then email notifications will fail with errors like:
2005-01-06 11:30:53,856 ERROR [atlassian.mail.queue.MailQueueImpl] com.atlassian.mail.MailException: Sending failed; nested exception is: javax.mail.internet.AddressException: Missing '<' in string ``"Joe Bloggs (JIRA)" <Tech Support <jira@company.com>>'' at position 62
The fix is to edit WEB-INF/classes/jira-application.properties
, and change the following property value
to false
:
jira.option.include.user.in.mail.from.address = true
JIRA's recommended upgrade process involves deploying an XML backup of your data. Some users will find that the import fails with this error:
This is usually because the database contains control characters that cannot be
represented in Unicode, and hence XML.
The fix is to follow these instructions to remove the invalid characters from the XML before import.