Release Notes page is Blank in Project Summary
Symptoms
When clicking on Release Notes in the Project Summary, JIRA should display a list of issues solved by the Release. Instead, the area where this should appear is blank.
The following appears in the atlassian-jira.log
:
2013-05-02 15:59:51,104 http-bio-443-exec-1 ERROR xxxxxx 959x66x1 1s9q0wn 172.16.101.39 /secure/ReleaseNote.jspa [jira.project.util.ReleaseNoteManager] Exception occurred while attempting to get velocity body for release note template.
org.apache.velocity.exception.VelocityException: Could not find template 'templates/jira/project/releasenotes/releasenotes-with-releasecomment-text.vm' ensure it is in the classpath.
at com.atlassian.velocity.DefaultVelocityManager.getEncodedBody(DefaultVelocityManager.java:76)
at com.atlassian.jira.template.velocity.DefaultVelocityTemplatingEngine$DefaultRenderRequest.asHtml(DefaultVelocityTemplatingEngine.java:104)
at com.atlassian.jira.project.util.ReleaseNoteManager.getReleaseNote(ReleaseNoteManager.java:151)
at com.atlassian.jira.web.action.browser.ReleaseNote.getReleaseNote(ReleaseNote.java:97)
...
Cause
This happens because JIRA is trying to find a custom release notes template, but the template is not in the template's folder, which may happen if the template was deleted or was not migrated after an upgrade. The most usual error points to releasenotes-with-releasecomment-text.vm
due to 'Creating a Custom Release Notes Template Containing Release Comments'.
Resolution
Create the Release Note JIRA is trying to find as per our 'Creating Release Notes' docs. If using the mentioned release notes, it's possible to use the one on 'Creating a Custom Release Notes Template Containing Release Comments'. Alternatively, remove the references of the custom release note as per the same Creating Release Notes doc.