Jira Service Desk 4.1.x upgrade notes
Here are some important notes on upgrading to Jira Service Desk 4.1.
For details on the new features and improvements in this release, see the Jira Service Desk 4.1 release notes.
As Jira Service Desk runs on the Jira platform, you should also view the Jira platform 8.1 upgrade notes.
Upgrade notes
Here's a summary of changes and important notes from Jira Service Desk 4.1.
Jira might take longer to start after the upgrade for MySQL
For Jira Service Desk 4.1 we've added new columns to MySQL tables. This might result is Jira starting slower just after the upgrade.
Running Jira on Java 11
Java 11 is not officially supported yet, but you can already use it to run Jira. If you choose to do so, use JDK 11.0.2.
End of support announcements
In Jira Service Desk 4.1, we're making the following changes:
- Deprecating 32-bit installers. They will be fully removed in Jira Service Desk 4.2 or 4.3. If you need to stick to 32-bit systems, you can install by using the zip/tar.gz archives.
For more info, see End of support announcements.
App developers
We've made some look and feel changes to the help center and customer portal. This is the first round of improvements aimed at making the customer experience both simple and polished.
In order to do this, we've had to make some changes to the frontend codebase and this may impact third-party apps.
What's the potential impact?
There's two things to be aware of:
- layout changes may impact how your app looks within the customer portal
- the customer portal now loads routes asynchronously, which can impact previously available globals.
What you need to do
In Jira Service Desk 4.1, your app should work as expected, but you'll need to check your dependencies and take the recommended action outlined below. In 4.2, your app might be impacted by these changes if no action is taken.
Steps to take:
- Check that the dependencies your app needs are specified in your web resources. When checking this, consider if these dependencies are necessary, or if they're negatively impacting load-time performance. You can use https://bitbucket.org/atlassianlabs/atlassian-webresource-webpack-plugin to help achieve this.
- Check that your app works 'as expected' within the new layout. When the service desk admin activates the new layout, the <body> element will contain the class custom-portal-layout-flag.
We'll be releasing an Early Access Program to give you time to test your changes before general release.
If you have a question
You can post any questions to this community page and we'll get back to you as soon as we can.
Upgrade procedure
See Upgrading Jira applications for complete upgrade procedures, including all available upgrade methods and pre-upgrade steps that are required for Jira Service Desk 4.1. For a more tailored upgrade, also check our Pre-upgrade planning tool that will recommend a version to upgrade to, run pre-upgrade checks, and provide you with a custom upgrade guide with step-by-step instructions.