Web Resource Breaking Change for Jira 10
Starting with Jira 10.0, you will no longer be able to configure a custom web resource directory for storing your resource files (such as custom JavaScript or css files). All web resources should now be kept in web-resources/com.onresolve.jira.groovy.groovyrunner.
This path is located in the Jira Shared home directory if you have a shared home directory configured (such as when using clustered configuration). Otherwise it will be in the default home directory. For more information on shared home directory configuration please refer to Atlassian documentation.
If you were previously using custom directories for the value of the JVM property named plugin.resource.directories
, you will have to move your custom resource files to the new web-resources/com.onresolve.
directory.jira
.groovy.groovyrunner
Move your scripts
When you upgrade to Jira 10.x and log into ScriptRunner you will receive an action notification if you have any resources in the wrong location:
When you select Show files to migrate you are shown a list of all files that must be migrated to the new directory:
You can migrate each file as follows:
- Locate the file(s) in the current directory/directories that you have configured for the
plugin.resource.directories
property. - Copy the file(s) to the new web resource directory (
web-resources/com.onresolve.jira.groovy.groovyrunner
). - Verify that the file(s) have been copied to the new directory.
- Delete the original file(s) from the old directory.
- Once all files have been migrated you can remove the
plugin.resource.directories
entry from your JVM_REQUIRED_ARGS or CATALINA_OPTS values.