Upgrade from Connect to Forge
- Danut M [StonikByte]
- Liana Boboescu [StonikByte]
Great Gadgets for Jira Cloud was originally developed on the Atlassian Connect app development platform, but meanwhile Atlassian introduces a brand-new platform named Atlassian Forge, which comes with significant improvements related to security, data residence and performance.
We developed a new version of Great Gadgets for Jira Cloud on the new Forge platform, which has been exposed to new installations over the past few months while we carefully monitored and refined it. Now, this version is also available as an upgrade for existing Connect-based app installations.
Connect to Forge app upgrade is a necessary step as Atlassian has announced the retirement of the Atlassian Connect platform in the near future (see Announcing Connect End of Support: Timeline and Next Steps).
How to determine if your installed app version is Connect or Forge?
Follow these steps to check if your app version is Connect or Forge.
Log on to Jira Cloud as an administrator
Go to Apps > Manage Apps and expand Great Gadgets. Look at the Version number.
If the app version ends in “-AC“ (e.g. 1.1.72-AC), then you have a Connect-based version of the app installed. In this case, please proceed further with the Forge upgrade steps described in the next sections.
If the app version does not end in "-AC" (e.g. 5.1.0 or 6.0.0), then you already have a Forge-based version of the app installed. In this case, you should upgrade to the latest Forge-based version of the app if the Update button is available and you're ready.
What is the impact of app upgrade from Connect to Forge?
The upgrade from Connect to Forge is expected to be a seamless process.
All the existing dashboard gadgets from Jira and their configuration will remain in-place. In addition, all the app features available in the Connect-based version will be also available in the Forge-based app version.
One difference that Jira users will notice is that there will be no “Title” field in the gadget configuration. The old gadget titles will be preserved, but editing will be possible by clicking on the gadget title.
If you also have Great Gadgets for Confluence Cloud app installed in your Confluence Cloud instance, the macros from Confluence pages will stop working if the StonikByte Connector for Jira Cloud (free app) is not installed in your Jira Cloud instance. So please make sure that the StonikByte Connector for Jira Cloud app is installed in your Jira Cloud instance before proceeding with the upgrade.
However, in the unlikely event that you experience any issues during or after the upgrade, please contact StonikByte Support by creating a ticket in the support portal or by emailing support@stonikbyte.com.
How to upgrade from Connect to Forge
Once you determine that you have a Connect-based version installed, follow these steps to upgrade to the latest Forge-based version of the app:
If you also have Confluence Cloud, check if Great Gadgets is also installed in your Confluence instance. Otherwise, skip to step 3.
Log in to your Confluence Cloud instance as an admin
Go to Apps > Manage Apps and check if Great Gadgets appears under installed apps.
If you found Great Gadgets installed in Confluence Cloud, check if StonikByte Connector app is installed in Jira Cloud.
Log in to your Jira Cloud instance as an admin
Go to Apps > Manage Apps and check if StonikByte Connector appears under the installed apps.
If it is not installed, go to Find new apps, search for “StonikByte Connector” and install it
Proceed with Great Gadgets upgrade in Jira Cloud:
Log in to your Jira Cloud instance as an admin
Go to Apps > Manage Apps, expand Great Gadgets and click Update
In the Confirm app update screen, click Accept & update.
If you are prompted that a page refresh is required, click Refresh.
At this stage the upgrade is complete and all the app gadgets should be functional.
For any questions, please contact StonikByte Support by creating a ticket in the support portal or by emailing support@stonikbyte.com.