Jira Service Management 5.16.x upgrade notes
Here are some important notes on upgrading to Jira Service Management 5.16.x. For details on the new features and improvements in this release, see the Jira Service Management 5.16.x release notes.
Upgrade notes
Script directory for Groovy scripts
Due to the changes to Groovy scripting in Assets, during the upgrade, Jira Service Management will create a new directory (<JIRA_SHARED_HOME>/plugins/assets/groovy_scripts) in the shared home. If you notice any errors related to directory creation in the logs, create the above script directory and make sure that this directory can be read by the user running Jira. The upgrade tasks also adds any file paths used previously in Assets post functions (which are used by Jira workflows) to the allowlist.
Assets automation causes a silent failure
We’ve identified an issue where Assets automation rules might not trigger after upgrading to Jira Service Management versions from 5.12 up to 5.17. When a local method is called within a Groovy script with a hyphen, Groovy generates an invalid class name, causing a silent failure and affecting the automation processes.
To resolve this issue, rename your script files to not include hyphens. You can use camelCase or underscores _ instead. For example, if your script is named some-test-script.groovy, rename it to someTestScript.groovy or some_test_script.groovy. For more information, go to the following Jira issue:
JSDSERVER-15647 - Getting issue details... STATUS
We’ve addressed this issue in Jira Service Management 10.0 and later by upgrading groovy-all from 2.4.15 to 4.x. More about upgrading to Groovy 4
End of support announcements
There are no changes to supported platforms in this release.
For the list of supported platforms, check Supported platforms.
For previous announcements, see End of support announcements.
App developers
Check out the Jira Data Center changelog for any important changes regarding apps.
Upgrade procedure
To help you upgrade to the latest and greatest:
- See Upgrading Jira applications for complete upgrade procedures, including all available upgrade methods and pre-upgrade steps.
- For a more tailored upgrade, go to Jira administration > Applications > Plan your upgrade. We’ll recommend a version to upgrade to, run pre-upgrade checks, and provide you with a custom upgrade guide with step-by-step instructions.