JIRA Software 7.9.x upgrade notes
Here are some important notes on upgrading to JIRA Software 7.9. For details of the new features and improvements in this release, see the JIRA Software 7.9.x release notes.
Upgrade notes
JIRA administrators
Upgrade to the DVCS plugin
If your Jira Software Server or Data Center instance is connected to Bitbucket Cloud, it’s through the Jira DVCS connector plugin.
Due to GDPR regulations and the personal data protection they require, we've needed to make some changes to the API's that Bitbucket Cloud has available. These changes happen in two phases. Phase one will be live on Bitbucket Cloud by the 10th of May, 2019, and Phase two will go live on the 1st of September, 2019.
What you need to do as a result is to upgrade your Jira Software instance or upgrade your Jira DVCS connector plugin to the relevant version. For more information, see Jira KB.
Connecting to MySQL using IPv6
You can connect JIRA to your MySQL database using an IPv6 address. To do this, complete the following steps to update the URL pattern in your dbconfig.xml
file.
You don't have to make any changes if you're sticking to the IPv4 address, or if you're using a hostname for your database.
- Go to
<JIRA-install-dir>/bin
, and runconfig.sh
orconfig.bat
. This will open the JIRA configuration tool. - In the Database tab, enter the IPv6 address.
- Click Save.
- Restart JIRA.
Connecting to SQL Server 2016
If you'd like to connect to the new supported database, make sure you read about the prerequisite steps: Connecting to SQL Server 2016.
Asynchronous cache replication in JIRA Data Center
We’ve changed the way cache is replicated in JIRA Data Center, making the replication asynchronous. Previously, we replicated each modification immediately after it occurred (synchronous). Now, we’re adding each modification to a persistent queue and replicating it to other nodes after it’s promoted to the top of the queue. Thanks to that, replication occurs in the background and is independent of any of your further actions in JIRA. Learn more
Plugin developers
See Preparing for JIRA 7.9 for any important changes regarding plugins.
Upgrade procedure
Note: Upgrade to a test environment first. Test your upgrades in your test environment before rolling them into production.
If you're already running a version of JIRA, please follow these instructions to upgrade to the latest version:
- Before you upgrade, we strongly recommend that you back up your installation directory, home directory, and database.
- Read the release notes and upgrade notes for all releases between your version and the latest version.
- Download the latest version of JIRA.
- Follow the instructions in the Upgrade Guide.
Upgrading from earlier versions?
- 7.0, or later
Take a look at the upgrade matrix. It lists known issues you should be aware of when upgrading between multiple versions. - Earlier than 7.0
Consult the Migration hub. The JIRA 7.0 release introduced significant changes. You must first upgrade to JIRA 7.0 (we always recommend the latest bugfix release, in this case 7.0.11) before upgrading to later versions.