Managing zero downtime upgrades
Zero downtime upgrade (ZDU) allows you to upgrade your JIRA Data Center with no downtime for your users. Your instance will remain available throughout the upgrade process.
About Zero downtime
Zero downtime upgrade (ZDU) is a special method available for JIRA Data Center. It introduces the upgrade mode that allows your nodes to work on different JIRA versions while you upgrade them one by one. During the upgrade, JIRA remains fully functional and open to your users.
ZDU is available for both JIRA Software Data Center and JIRA Service Desk Data Center. JIRA Software 7.3 or JIRA Service Desk 3.6 are the minimum versions you need to be able to use this upgrade process. If you're running a JIRA installation with both JIRA Software and JIRA Service Desk, don't worry, we got you covered!
As the zero downtime upgrade process can be quite lengthy (depending on how many nodes you have), we've also got a handy checklist you can use to make sure you've done everything you need to. We still recommend you go through all the steps on this page, the checklist is just a handy tool to help keep track of what you're doing.
Technical overview
For more information on what happens with your cluster in terms of upgrade, see ZDU technical overview.
FAQs
If you still have doubts, have a look at our Zero downtime upgrade FAQs.
Before you begin
Before you start your zero downtime upgrade, there's a few things you'll do:
Ensure you have the installer for your intended version. | |
Ensure you know about your intended version. | |
Ensure you're on a supported platform. | |
Ensure you check your add-ons. | |
Back up your database. | |
Ensure your Support Healthcheck, Instance Health, and Support Tools plugins are enabled, and up to date with the latest versions. |
Prestaging and testing your new version
We strongly recommend performing your upgrade in a test environment that best reflects your production environment first. Don't upgrade your production instance until you are satisfied that your test environment upgrade has been successful and is functioning correctly. This includes checking your add-ons and customizations. If you have any problems with your test environment upgrade which you can't resolve, create an issue at our support site so that we can assist you.
1. Put JIRA into upgrade mode
Putting JIRA into upgrade mode allows the nodes in your cluster to run on different versions of JIRA Software until you finalize or cancel your upgrade. To put JIRA into upgrade mode, all your nodes need to be running on the same versions.
- Navigate to > Applications > JIRA upgrades.
- Click Put JIRA into upgrade mode. This will only be available if your nodes are all on the same version.
When you first put JIRA into upgrade mode, you have the option to cancel the upgrade, which will take JIRA out of upgrade mode. This is available until you start upgrading your nodes. Once you've upgraded your nodes to the same version, you can finalize the upgrade. To cancel the upgrade, you'd need to roll each node back to it's original version.
2. Upgrade your nodes
Once your JIRA instance is in upgrade mode, you can upgrade each node individually. Upgrading a node will involve stopping JIRA, upgrading the installation, and then starting JIRA. Stopping JIRA will remove the node from your cluster, making it unavailable, and any users logged in to that node will lose their current session, before being routed to another node. As the administrator, it's up to you to decide which nodes to upgrade and in which order. You always need to have at least one node online and connected to your cluster to achieve zero downtime. There's some useful information on monitoring a JIRA Data Center node here, and depending on your setup, you may be able to 'drain' your nodes to minimise impact.
The JIRA Software installer automatically performs most of the upgrade tasks for you. However, if you have made customizations to your JIRA installation, you will need to migrate the customized files manually to the upgraded installation. This step takes place during the upgrade of your node.
You're now ready to upgrade your nodes. Make sure you can access the installer before you start, and select the node you need to upgrade:
When you've upgraded your first node, check that it's available on your cluster, and that users are able to log in and use the node. Once you've done this, repeat the process for each node.
Once you've upgraded all your nodes to the latest version, you can finalize your upgrade on the JIRA upgrades page (> Applications > JIRA upgrades). If you haven't upgraded all the nodes, the Finalize upgrade button won't be available, and you'll need to check which node/s still require upgrading. You can finalize your update when all nodes are upgraded.
3. Finalize your upgrade
Finalizing an upgrade will allow any required upgrade tasks to run on your instance, and take JIRA out of upgrade mode. Once the required tasks have completed, you're installation is upgraded.
- Navigate to > Applications > JIRA upgrades.
- Click Finalize upgrade. This will only be available if all your nodes are all on the same, new version.
Congratulations! You've upgraded your instance and achieved zero downtime!