JIRA 7.7.x platform upgrade notes

Here are some important notes on upgrading to JIRA platform 7.7. For details of the new features and improvements in this release, see the JIRA platform 7.7 release notes

Upgrade notes

JIRA administrators

Fix: Duplicated job IDs

In this release, we’ve delivered a fix to solve the problem with duplicated job IDs. You can read more about the related bug here:  JRASERVER-64325 - Getting issue details... STATUS

How does the fix work?

When finalizing the upgrade, an upgrade task removes the duplicates from the database (clusteredjob table), and then recreates the whole clusteredjob_jobid_idx index, also adding a UNIQUE keyword to it. This removes the duplicates and prevents them from being created again.

Known issue

The fix will work for most environments, but we did encounter an issue on one of our test machines. The problem appears when a new duplicate is created after we remove the duplicates, but before we recreate the index. In other wordsbefore we block the duplicates from being created. Such a duplicate would stop the index from being recreated.

Solution

If the index is not recreated, it won’t stop the upgrade or affect your work in a significant way (might degrade performance). We recommend, however, that you apply the following solution to recreate the index.

  • Check that the clusteredjob_jobid_idx index exists in your database.
    (tick) If it's there, you're good to go. The index was properly recreated.
    (error) If it's not there, restart your JIRA instance (Server), or one of the nodes (Data Center). After the restart, the index will be recreated.

Plugin developers

Asynchronous Module Definition

The JIRA development team has started converting the JIRA code to AMD (Asynchronous Module Definition) to be able to use modules and their dependencies, and to improve the code quality, and all our lives, in general. We’ve converted only some parts of the code, and no actions are required from you. This is just a heads up about our plans—eventually, we want to completely switch to AMD, in which case we’ll drop support for global variables.

We will be informing you about the progress in this area with each release. Despite the recent code changes, we’ve kept the backward compatibility, so you can develop your plugins the way you used to.

If you encounter a JIRA page that still uses global variables (for objects that are provided as AMD modules), you’ll see a warning in the developer console saying that a global variable is deprecated and you should use an AMD module instead. You can either use the module, or stick to the global variable for now.

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:

  1. Before you upgrade, we strongly recommend that you back up your installation directory, home directory, and database.
  2. Read the release notes and upgrade notes for all releases between your version and the latest version.
  3. Download the latest version of JIRA.
  4. 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 before upgrading to later versions.
Last modified on Jan 4, 2018

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.