Preparing for Jira 10.3
This documentation is intended for Jira developers who want to ensure that their existing apps are compatible with Jira Software Data Center 10.3 and Jira Service Management Data Center 10.3.
Latest version
Here you can find information about the latest EAPs.
Application | Date | Version (Maven) | Downloads |
|---|---|---|---|
Jira Software |
| 10.3.0-m0002 | |
Jira Service Management |
| 10.3.0-m0002 |
Summary of changes
Jira 10.3 is a Long Term Support (LTS) release. This LTS release contains all features introduced since the last LTS release (Jira 9.12) and provides fixes for known issues. You can use the EAP release to test your apps and make sure they run smoothly.
The summary has been divided into sections that group the changes by severity and type:
Breaking changes
Find out what you need to change in your apps or integrations to avoid outages or disruptions. The entries in this section are organized chronologically from newest to oldest.
Jira 10.2: Changes to metrics served by the JMX exporter
JIRA SOFTWARE JIRA SERVICE MANAGEMENT
We no longer expose Connection instance-level metrics through the JMX exporter in Jira while still maintaining other types of tracking, including tracking at the Connections level.
Up until now, we exposed Connection-level metrics together with Connection instance-level metrics. |
We no longer expose Connection instance-level metrics while still maintaining all the information from Connection-level metrics. |
|---|
If you need to restore the previous behavior, you can use the parameter -Ddbcp.registerConnectionMBean=true to override those settings. However, this workaround isn’t recommended as it may bring back already fixed symptoms or cause other unknown problems resulting from the thread races in the underlying library.
For more information about this change, check out Preparing for Jira 10.2.
Jira 10.0 and older
Check out the changelog for breaking changes in Jira 9.13 to Jira 10.0.
Improvements introduced in this release
Jira Software Data Center 10.3 and Jira Service Management Data Center 10.3 also introduce their own set of changes that fix known issues, boost performance, or improve the overall user experience.
Light theme becomes the new default
In Jira 10.3, the light theme takes over as the default, replacing the now deprecated original theme. This means that the default Look and Feel configuration in Jira is aligned with the light theme.
What’s more, the dark theme is officially here, meaning better visuals, less eye strain, and improved readability. The only unsupported area left is the Plans view which we’re working on bringing to you soon.
New features, fixes, and non-breaking changes
Get a glimpse of all the new features, fixes, and non-breaking changes added to each release leading up to Jira 10.3. The list is divided into sections by release. For releases of Jira Software and Jira Service Management from version 9.13/5.13 to 10.0, check out the changelog for more details. For versions 10.1 and newer, we provided a link to the corresponding release's EAP documentation.
Changes to supported platforms
This section contains a run-down of all the changes that have been made to supported platforms since the last Jira LTS release.
End of support
We've removed support for:
- Oracle 12c R2
- Amazon Aurora on PostgreSQL 10
- Amazon Aurora on PostgreSQL 11
.binand.exebinary installers- H2 database engine
- Java 8
- Java 11
We’ve unbundled:
- Java (due to the binary installers removal)
Confirmed support
We’ve confirmed support for:
Azure PostgreSQL Flexible Server for one primary node only
Known issues
Ignore warnings from Atlassian Package Scanner
Atlassian Package Scanner verifies if there are no .jar files providing the same package, potentially with a different version. After you upgrade to Jira Software Data Center 10.3 or Jira Service Management Data Center 10.3, Atlassian Package Scanner will notify you about packages with the same content provided by different .jar files.
This is due to Embedded Crowd still migrating to the new version of the platform and still using password-cipher, while Jira has already moved to atlassian-secrets but still has to provide password-cipher for backwards compatibility. atlassian-secrets embeds password-cipher, which is why Atlassian Package Scanner notices them, but since the content is the same, the following warnings may be safely ignored (note the duplicated lines—those appear because the .jar files are placed both in /lib and atlassian-jira/WEB-INF/lib):
JIRA-Bootstrap WARN [o.twdata.pkgscanner.ExportPackageListBuilder] Package Scanner found duplicates for package 'com.atlassian.db.config.password' with different versions. Files: atlassian-secrets-api-5.0.4.jar and password-cipher-base-1.4.0.jar
JIRA-Bootstrap WARN [o.twdata.pkgscanner.ExportPackageListBuilder] Package Scanner found duplicates for package 'com.atlassian.secrets.tomcat.protocol' with different versions. Files: atlassian-secrets-store-5.0.4.jar and password-cipher-base-1.4.0.jar
JIRA-Bootstrap WARN [o.twdata.pkgscanner.ExportPackageListBuilder] Package Scanner found duplicates for package 'com.atlassian.secrets.tomcat.utils' with different versions. Files: atlassian-secrets-store-5.0.4.jar and password-cipher-base-1.4.0.jar
JIRA-Bootstrap WARN [o.twdata.pkgscanner.ExportPackageListBuilder] Package Scanner found duplicates for package 'com.atlassian.secrets.tomcat.cipher' with different versions. Files: atlassian-secrets-store-5.0.4.jar and password-cipher-base-1.4.0.jar
JIRA-Bootstrap WARN [o.twdata.pkgscanner.ExportPackageListBuilder] Package Scanner found duplicates for package 'com.atlassian.secrets.tomcat.protocol' with different versions. Files: password-cipher-base-1.4.0.jar and atlassian-secrets-store-5.0.4.jar
JIRA-Bootstrap WARN [o.twdata.pkgscanner.ExportPackageListBuilder] Package Scanner found duplicates for package 'com.atlassian.secrets.tomcat.utils' with different versions. Files: password-cipher-base-1.4.0.jar and atlassian-secrets-store-5.0.4.jar
JIRA-Bootstrap WARN [o.twdata.pkgscanner.ExportPackageListBuilder] Package Scanner found duplicates for package 'com.atlassian.db.config.password' with different versions. Files: password-cipher-base-1.4.0.jar and atlassian-secrets-api-5.0.4.jar
JIRA-Bootstrap WARN [o.twdata.pkgscanner.ExportPackageListBuilder] Package Scanner found duplicates for package 'com.atlassian.secrets.tomcat.cipher' with different versions. Files: password-cipher-base-1.4.0.jar and atlassian-secrets-store-5.0.4.jar
JIRA-Bootstrap WARN [o.twdata.pkgscanner.ExportPackageListBuilder] Package Scanner found duplicates for package 'com.atlassian.db.config.password' with different versions. Files: atlassian-secrets-api-5.0.4.jar and password-cipher-base-1.4.0.jar
JIRA-Bootstrap WARN [o.twdata.pkgscanner.ExportPackageListBuilder] Package Scanner found duplicates for package 'com.atlassian.secrets.tomcat.protocol' with different versions. Files: atlassian-secrets-store-5.0.4.jar and password-cipher-base-1.4.0.jar
JIRA-Bootstrap WARN [o.twdata.pkgscanner.ExportPackageListBuilder] Package Scanner found duplicates for package 'com.atlassian.secrets.tomcat.utils' with different versions. Files: atlassian-secrets-store-5.0.4.jar and password-cipher-base-1.4.0.jar
JIRA-Bootstrap WARN [o.twdata.pkgscanner.ExportPackageListBuilder] Package Scanner found duplicates for package 'com.atlassian.secrets.tomcat.cipher' with different versions. Files: atlassian-secrets-store-5.0.4.jar and password-cipher-base-1.4.0.jar
JIRA-Bootstrap WARN [o.twdata.pkgscanner.ExportPackageListBuilder] Package Scanner found duplicates for package 'com.atlassian.db.config.password' with different versions. Files: password-cipher-api-1.4.0.jar and atlassian-secrets-api-5.0.4.jarNote that the full warning comes with the details about the exact location of the scanned files:
2024-10-17 09:31:28,389+0000 JIRA-Bootstrap WARN [o.twdata.pkgscanner.ExportPackageListBuilder] Package Scanner found duplicates for package 'com.atlassian.db.config.password' with different versions. Files: atlassian-secrets-api-5.0.4.jar and password-cipher-base-1.4.0.jar
'/tmp/jira/lib/atlassian-secrets-api-5.0.4.jar'
'/tmp/jira/lib/password-cipher-base-1.4.0.jar'