Document toolboxDocument toolbox

App upgrade crashes Datacenter Node / Jira Server

Problem

Upgrading / disabling / uninstalling Issue Printer - Print Agile Board Card crashes the whole Datacenter node or Jira Server instance.

Details

Version 2.0.0 introduced a cache to improve template rendering performance. Upon disabling the app, e.g. as part of an upgrade, the Jira Server instance or a single Datacenter node can crash. The crash is caused by shutting down Jira’s internal caches as a result of https://ecosystem.atlassian.net/browse/CACHE-240 . The logfile contains exceptions with the following error:

Cache is not alive (STATUS_SHUTDOWN)

Solution

The following provides a step-by-step solution:

  1. Shutdown Jira or the corresponding Datacenter node.

  2. Uninstall the app. Follow the official knowledgebase article at https://confluence.atlassian.com/upm/uninstalling-apps-273875709.html

  3. Start Jira or the corresponding Datacenter node.

  4. Install a fixed version (2.1.3 or newer).

It is possible that uninstalling the app via the user interface is not possible. The linked knowledgebase article describes an additional way of manually removing the jar file.