/
Migration Guide Jira 9.x to Jira 10.x

Migration Guide Jira 9.x to Jira 10.x

Owned by Nabil OUKACI
mars 02, 2025
3 min read

Introduction

Migrating from Jira 9.x to Jira 10.x is a significant step that requires careful preparation to ensure a smooth transition. This document will guide you through the essential migration steps, with a strong focus on managing our plugins, which must be disabled or uninstalled before proceeding with the upgrade.

This procedure concerns Kepler Plugins.

To ensure migration compatibility, it is recommended to first perform this action on a STAGING or UAT environment.

1. Mandatory Prerequisites

Before starting the migration, ensure you have completed the following steps:

  • Review upgrade notes: Check the official release notes to identify any changes that might affect your Jira instance.

  • Run a health check: Use Jira’s health check tool to detect and resolve potential issues before upgrading.

  • Check app compatibility: Ensure that all the applications and plugins you use are compatible with Jira 10.x.

  • Back up your Jira instance: Perform a full backup of your database, Jira Home directory, and Jira installation directory.

You will find more details about Mandatory Prerequisites here https://confluence.atlassian.com/adminjiraserver/preparing-for-the-upgrade-966063325.html.

2. Managing Plugins Before Migration

Our Kepler plugins must be disabled or uninstalled before migration to avoid critical errors that could block the upgrade process.

Steps to Disable or Uninstall Our Plugins:

  1. Navigate to Jira Administration > Manage Apps.

  2. Locate our plugins in the installed applications list.

  3. Click Disable or Uninstall for each plugin, alternatively you can delete the plugin from YourBaseDirectory\Atlassian\Application Data\Jira 9.12.1\plugins\installed-plugins.

  4. Verify that none of our plugins remain active before proceeding with the migration.

When deactivating/installing the plugin, data will not be deleted from your instance.

Important: If the plugins remain enabled, Jira may fail to migrate correctly, leading to blocking errors.

3. Jira 10.x Migration Process

3.1 Create a Backup

  1. Log in to Jira.

  2. Go to System → Backup System.

  3. Enter a name for the backup file.

  4. Click Backup.

  5. Log out of Jira.

3.2 Stop Jira

you can stop stop the Jira server by running:
bin/stop-jira.bat

If you have a clustered instance, stop each node one by one.

On Windows:

  1. Press the Windows key and type "Services".

  2. Find Atlassian Jira Service, right-click, and select Stop.

  3. Ensure that the "Apache Commons Daemon Service Runner" process is no longer running in Windows Task Manager. If necessary, terminate it manually.

3.3 Install Java 17

Jira 10 requires Java 17. If not installed:

  1. Download Java 17 from this link.

  2. Install Java 17 and set the JAVA_HOME environment variable.

3.4 Install Jira 10

  1. Extract Jira 10 files into a new installation directory (different from the old one).

  2. Configure Jira 10 to point to your existing Jira Home directory.

  3. Copy the connectors configured in the server.xml file from your old installation to the new one.

  4. Note all custom JVM settings from the old Jira service and apply them in the new installation.

3.5 Reinstall Jira Windows Service

  1. Remove the old Jira service using:

    cd JIRA_NEW_INSTALL\bin service.bat remove <JIRA_SERVICE_NAME>

  2. Install the new Jira service:

    cd JIRA_NEW_INSTALL\bin service.bat install <JIRA_SERVICE_NAME>

3.6 Finalize the Migration

  1. Follow the final steps outlined in the Atlassian guides to install the database driver and complete the migration.

  2. Restart Jira and verify its functionality.

4. Reactivating or Reinstalling Plugins

Once the migration is complete and Jira 10 is fully operational, you can reactivate or reinstall our plugins:

  1. Navigate to Jira Administration > Manage Apps.

  2. Search for our plugins and click Enable or Install.

  3. Test Jira and the plugins to ensure everything works correctly.

When deactivating/installing the plugin, data will not be deleted from your instance.

Conclusion

Following these steps ensures a seamless migration to Jira 10.x without service disruptions. Remember that disabling our plugins beforehand is crucial to avoid migration issues. If you need assistance, contact our support team.

Happy migration!

 

Source: Jira official migration documentation https://confluence.atlassian.com/jirakb/how-to-manually-upgrade-to-jira-10-as-the-installer-method-is-now-deprecated-1442158884.html.

Related content