How to manually upgrade to Jira 10 as the Installer method is now deprecated
Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.
Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Summary
As per Jira Software 10.0.x upgrade notes, starting from Jira 10.0, the .bin and .exe installers will no longer be available. You can still install Jira using the .zip and .tar.gz distributions.
Due to this, it will only support using the Upgrading Jira Data Center non-clustered (manual) or Upgrading Jira Data Center clustered (manual)articles to install Jira 10+.
Because of this change, Java is no longer bundled with Jira, so in case you don't have a Java 17 ( which is the Java version that Jira 10 supports ) installed in your Linux / Windows sytem, you will need to Install Java manually
The steps are pretty much already outlined at the articles above, and the intention of this article is to be a complementary one, to add some extra clarity for the users who wasn't used to manually upgrade Jira previously, and has only used the Jira installer and Jira Service ( Windows ) to start Jira.
Exceptions
LTS versions (eg: 10.3) will still include the installer. All other versions of 10.x will need to use the manual upgrade method.
Solution
Environment
Jira 10+ Data Center
How to manually upgrade to Jira 10 on Windows
Make sure you have completed the steps in Preparing for the upgrade. These are mandatory pre-requisites, and are essential for a smooth upgrade.
If Clustered: To avoid upgrading each of the nodes separately, you’ll just upgrade one of them, and make it a template. Then, you’ll copy this template to remaining nodes.
Stop Jira. ( If clustered, stop all Nodes - one at the time )
In case you start Jira by the Windows Service > Press Windows Key > Type Services to open the Windows Services > Find for Atlassian Jira service > right click on it > Stop it.
Make sure the Atlassian Jira Service is fullystopped, and also check if a "Apache Commons Daemon Service Runner" ( if started by Service ) process has disappeared from the Windows Task Manager. This is a very important step, as Windows systems may fail to fully stop Jira process. If you still see this process running, kill the process, as we need to make sure Jira is fully stopped for the procedure to work.
Backup your database, Jira Home directory, and also your Jira installation Directory ( in case you need to rollback ).
In case you don't have a Java 17 installed in your Windows sytem, you will need to Install Java manually and you can download Java 17 here: https://download.oracle.com/java/17/archive/jdk-17.0.11_windows-x64_bin.exe, and then set the system environment variables for JAVA_HOME, as example below:
Extract (unzip) Jira 10 files to a directory (this is your new installation directory, and must be different to your existing installation directory).
Point your Jira 10 to your existing Jira home directory. You have couple ways to do this, please choose one method as outined at Setting Jira home directory
Make sure to copy the connectors configured in the JIRA_OLD_INSTALL/conf/server.xml from your old Jira installation to the new Jira 10 one. Make sure you don't just copy over the old files, as the 'native' settings they contain might have changed between the Jira versions.
Make sure to note down all the customJVM settings configured in the Windows Service as outlined in Setting properties and options on startup > section Windows service > Step 5 - Java Tab
You will copy it from the Jira service of your old installation, to the new service one, which you will manually create for Jira 10. You should copy the custom JVM flags inside the Java options, as well as copy the Initial memory pool and Maximum memory pool values, to make sure your Jira 10 will start with the same heap memory allocation as previously.
Re-install Jira Windows service, make sure to remove the old Jira Windows Service used by previous Jira version and install a new one for Jira 10.
You can do so by following the steps at: Running Jira applications as a Windows service
Open the CMD as Administrator > cd JIRA_NEW_INSTALL\bin > run service.bat remove <JIRA SERVICE NAME>
Open the CMD as Administrator > cd JIRA_NEW_INSTALL\bin > run service.bat install <JIRA SERVICE NAME>
From this step, you can follow all the other remaining steps outlined in the articles Upgrading Jira Data Center non-clustered (manual) or Upgrading Jira Data Center clustered (manual), from the section Install the database driver and onwards.
How to manually upgrade to Jira 10 on Linux
Make sure you have completed the steps in Preparing for the upgrade. These are mandatory pre-requisites, and are essential for a smooth upgrade.
If Clustered: To avoid upgrading each of the nodes separately, you’ll just upgrade one of them, and make it a template. Then, you’ll copy this template to remaining nodes.
Stop Jira. ( If clustered, stop all Nodes - one at the time )
Backup your database, Jira Home directory, and also your Jira installation Directory ( in case you need to rollback ).
In case you don't have a Java 17 installed in your Linux sytem, you will need to Install Java manually and you can download Java 17 here: https://download.oracle.com/java/17/archive/jdk-17.0.11_linux-x64_bin.tar.gz, and then set the system environment variables for JAVA_HOME. We have some guidance at Setting JAVA_HOME but it depends on each Linux OS type, so the user profile location could be different.
Extract (unzip) Jira 10 files to a directory (this is your new installation directory, and must be different to your existing installation directory).
Point your Jira 10 to your existing Jira home directory. You have couple ways to do this, please choose one method as outined at Setting Jira home directory
Make sure to copy the connectors configured in the JIRA_OLD_INSTALL/conf/server.xml from your old Jira installation to the new Jira 10 one.
Make sure to copy the custom JVM settings configured in the JIRA_OLD_INSTALL/bin/setenv.sh from your old Jira installation to the new Jira 10 one.
Make sure you don't just copy over the old files, as the 'native' settings they contain might have changed between the Jira versions.
From this step, you can follow all the other remaining steps outlined in the articles Upgrading Jira Data Center non-clustered (manual) or Upgrading Jira Data Center clustered (manual), from the section Install the database driver and onwards.
Was this helpful?