Upgrade Server

Who this guide is for

This guide only concerns users who are looking to upgrade from the old Atlassian Labs "Automation Lite for Jira Server" (formerly "Jira Automation") add-on to the new "Automation for Jira" (either Lite or Pro) add-on.  If you are not sure which version you are currently on, navigate to 'Manage add-ons' and see if you currently have the 3 add-ons shown in the screenshot below installed with version 2.0.3 or earlier.  This guide is only required for Jira Server and can be ignored for Cloud users.  For a full breakdown of the differences between the different Automation for Jira editions, please see Lite vs Pro.

Please note that:

  • All your existing automation rules will be migrated in every upgrade scenario shown below.  So for example if you have some automation rules configured in "Automation Lite for Jira Server" and install the Pro edition, then all your automation rules will be migrated across.
  • You can downgrade back to the old Atlassian Labs add-on at any time simply by uninstalling the new Automation for Jira and re-installing the Atlassian Labs version 2.0.3 (still available for download from the Atlassian marketplace) in case something goes horribly wrong.

Upgrade scenarios

Old add-on New add-on How to upgrade
Automation Lite for Jira Server 2.0.3
by Atlassian Labs
Automation Lite for Jira 3.0.0
Simply upgrade the "Automation Lite for Jira Server" add-on via the 'Manage add-ons' section in Jira
Automation Lite for Jira Server 2.0.3
by Atlassian Labs
Automation for Jira 3.0.0
Simply install the "Automation for Jira" add-on via the 'Manage add-ons' section in Jira
Automation Lite for Jira 3.0.0
Automation for Jira 3.0.0
Simply install the "Automation for Jira" add-on via the 'Manage add-ons' section in Jira

Third party Automation extensions

A final scenario to consider is if you are using third party extensions to Automation for Jira.

We continue to provide support for these third party extensions, however the configuration UI has changed significantly and these third party extensions will have to be updated with the new UI. We're actively working with vendors to provide new versions of their add-ons soon, but in the meantime we will render a fallback UI that should still allow you to use these extensions.  Rules already configured with actions provided by third party extensions will continue to run.

What's shown in 'Manage add-ons'

If you are currently using the old Atlassian Labs provided add-on v.2.0.3 you will see these add-ons installed in your Jira instance:

Labs addons

If you upgrade to the new Lite version (see the first 'Upgrade Scenario' above), you will have these add-ons installed:

Lite addons

The old "Automation Module" and "Jira Automation SPI" add-ons can safely be uninstalled at some point in future. This will reduce memory footprint and startup times of your Jira instance.

If you upgrade to the Pro version at some stage in future from our Lite version, then you should see the following add-ons listed:

Pro addons

Upgrade Troubleshooting

The add-on system in Jira is a fickle beast. We tried our best to make this upgrade as smooth as possible, but even so - sometimes depending on your exact setup things can go wrong.  The underlying cause is that there's some complex dependencies between various add-ons at play here to support third party extensions.  Upgrading such an add-on can expose bugs in the Atlassian add-on system that only surface sometimes depending on exact ordering of events in your system (which is hardware dependant). We tried our best to catch all of these, but some scenarios we couldn't work around.

Problem: After upgrade pages like "Getting started" or the "Automation rules" admin page don't load

When you try to access these, you get 'Not found' 404 errors or 500 error pages with exceptions.  Most likely this is due to one of these hard to spot bugs in the Atlassian add-on system having triggered.

Troubleshooting steps

  • Uninstall the old labs add-ons "Automation module" and "Jira Automation SPI" in the 'Manage add-on' section (but don't worry, you wont lose any data)
  • Try disabling, then re-enabling Automation (Lite) for Jira in the Manage add-on section
  • If this didn't fix the problem: Try restarting Jira

Problem: Third party actions (like "Midori's Attach PDF") no longer work with audit log errors or errors when configuring rules

When rules execute, the audit log might contain errors like "This rule component was provided by a third party add-on for Automation for Jira. It appears this add-on is no longer installed or enabled." or the same error might be shown when trying to configure a rule. This means that during the upgrade somehow the third party add-ons providing these actions were disabled or not registered correctly.

Troubleshooting steps

  • Uninstall the old labs add-ons "Automation module" and "Jira Automation SPI" in the 'Manage add-on' section (but don't worry, you wont lose any data)
  • Try disabling, then re-enabling Automation (Lite) for Jira in the 'Manage add-on' section
  • Try disabling, then re-enabling the third party extension add-ons in the 'Manage add-on' section
  • If this didn't fix the problem: Try restarting Jira

Seeing other issues after the upgrade? Please contact Automation for Jira support!