Jira Software 8.16.x upgrade notes
Here are some important notes on upgrading to Jira Software 8.16.
Upgrade notes
Known issue: Custom fields can't be deleted on a single node Data Center instance
You won't be able to delete any custom fields if your Data Center instance is running on a single node. We've confirmed this bug and will release a fix for it in the next bugfix release. You can read more about it and available workarounds here.
Changes to the web.xml file
As mentioned in the Jira 8.15 upgrade notes, we've made changes to the web.xml file while working on improvements for image attachments. These changes affect paths to servlets responsible for attachments, and it's important that you use the new web.xml file (by copying your modifications to it) after upgrading. Otherwise, Jira will look for old servers and attachments won't be displayed. Read more about a related issue
Avoid data pipeline exports when upgrading Jira
You should not attempt to export data using the data pipeline API while performing a zero downtime upgrade.
If you have been using the data pipeline, we recommend you make a GET request to the following endpoint to confirm that an export is not in progress before upgrading to Jira 8.16.
http://<base-url>/rest/datapipeline/latest/exportIf the status it returns is "status": "STARTED" you should either wait for the export to complete, or make a DELETE request to cancel the export.
Changes to data pipeline REST responses
We’ve made some minor changes to the responses returned when you make a request to the data pipeline API. We now include a config section with details of the request, such as the fromDate. See Data pipeline for example responses.
Known vulnerability in the BKS-V1 keystore format
If you’re running Jira over SSL, we’d like to bring your attention to a security vulnerability of the BKS-V1 keystore format, provided by the BouncyCastle library. We strongly recommend that you don’t use it in your Jira instance. Learn more
End of support announcements
- Advance notice: We're deprecating PostgreSQL 9.6, and plan to remove it in Jira 8.19.
For the list of supported platforms, see Supported platforms.
App developers
See Preparing for Jira 8.16 for any important changes regarding apps.
Upgrade procedure
Upgrading from a Jira version 8.x.x?
- 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.