Migration Guide Jira 9.x to Jira 10.x

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.

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 Preparing for the upgrade | Administering Jira applications Data Center 10.4 | Atlassian Documentation.

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.

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.

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 How to manually upgrade to Jira 10 as the Installer method is now deprecated | Jira | Atlassian Documentation.