Upgrading Insight with Jira Service Management
Insight - Asset Management is part of Jira Service Management Data Center, but it’s also available as a separate app on Atlassian Marketplace so people not ready to upgrade their instances can also get it. This page will help you understand which version of the Marketplace app corresponds to Jira Service Management, and will guide you through some upgrade steps if you’re using this app.
Versions
The built-in functionality and the Marketplace app are essentially the same. Here’s how the app’s version corresponds to Jira Service Management:
| Jira Service Management | Insight - equivalent Marketplace app |
|---|---|
| 4.18 | 8.8.0 |
| 4.17 | 8.7.9 |
| 4.16 | 8.7.4 |
| 4.15 | 8.6.13 |
There were some differences in issues resolved and release timeline in versions 4.15-4.17. Since version 4.18, the built-in functionality and the Marketplace app are aligned.
Upgrading Insight with Jira Service Management
Whether you need to complete any pre-upgrade steps before upgrading Insight or Jira Service Management depends on the Insight version you’re using, so let’s start with checking that.
Step 1: Check your Insight version
To check which Insight version you’re using:
Go to Administration > Manage apps > Manage apps.
Find Insight and expand it to see the version.
If you’re seeing Insight in versions 9.x, like on the image above, it means that you’re using the built-in Insight functionality in Jira Service Management. You don’t have to take any actions and can safely upgrade.
Step 2: Complete the pre-upgrade steps
Look at the versions below and complete the steps required for your version.
Insight 8.4 or later
You’re good to go. You’re on one of the latest versions and there are no breaking changes.
Insight 8.x - 8.3
Complete these steps before upgrading: Preparing for Insight 8.4
Insight 7.x
Step 3: Upgrade Insight or Jira Service Management
If you completed all the required steps, your app is ready to be upgraded.
If you’re looking to just upgrade the Marketplace app to the latest version, upgrade it in Administration > Manage apps > Manage apps.
If you’re upgrading Jira Service Management that has the Insight functionality built in, your app will be automatically upgraded.
How to upgrade Insight to specific versions instead of the latest one
When you try to update the app in Manage apps, it will be updated to the latest version, which isn’t a good idea if you need to upgrade through intermediary versions first.
To download and install a specific version:
Check the Version history tab on Marketplace.
Download your version.
In Jira, in Manage apps, click Upload app. Your version will be uploaded and installed.