Jira Service Management 5.1.x upgrade notes
Below are some important notes on upgrading to Jira Service Management 5.1.x. For details on the new features and improvements in this release, see:
Upgrade notes
Improved indexing management at Jira start-up
In this release, we’ve made Jira start-up procedure much more resilient. Now, when you’re starting multiple nodes, Jira will ensure that each of them ends up with a healthy index.
For more details about the introduced changes, go to Index management on Jira start-up.
Remove application monitoring early access preview
If you participated in our early access program, you’ll need to make some changes as the monitoring agent is now included with Jira. You must remove the EAP monitoring agent and associated system properties before you upgrade, or Jira may fail to start or encounter problems.
Before you upgrade:
Remove the following system properties. See Setting properties and options on startup to check how to do this for your site.
-javaagent:<jira-install-directory>/atlassian-jira/WEB-INF/lib/insights-monitoring-java-agent-0.1.x.jar -Datlassian.org.osgi.framework.bootdelegation.extra=META-INF.insights,com.atlassian.insights.*,org.aspectj.*,io.prometheus.* -Dorg.aspectj.weaver.loadtime.configuration=META-INF/insights/aop.xml- Remove the
insights-monitoring-java-agent-0.1.x.jarfrom your<install-directory>/atlassian-jira/WEB-INF/libdirectory.
You don’t need to remove the JMX exporter, or the -javaagent:<full-path-to-jmx-exporter-jar>=<port>:<full-path-to-jmx-exporter-config.yml> system property.
After upgrading, follow the steps in Monitor application performance to check that monitoring is turned on. We’ve also updated the Grafana dashboards, so be sure to download the latest version from our repo.
End of support announcements
For the list of supported platforms, see Supported platforms.
App developers
See Preparing for Jira 9.1 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.