This page outlines the steps required to migrate the Great Gadgets app for Jira Cloud from Connect to Forge.
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 Confluence Cloud as an administrator
-
Go to Confluence administration > Settings > Atlassian marketplace > Manage apps
-
Click Take me there to be redirected to Administration > Site settings > Connected apps page
-
In the list of the connected apps, look for Great Gadgets for Confluence (Agile Charts Custom Reports) and click View app details.
-
Look at the Version number. If the app version ends in “-AC“ (e.g. 1.1.36-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. 1.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 app macros 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.
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.
-
If you have IP allowlisting enabled at the organisation level, the gadgets may return error 403 (Forbidden) after the update. To fix this, add the app server IP addresses to the allowlists (see Technical Notes | IP Allowlisting).
For any questions, please contact StonikByte Support by creating a ticket in the support portal or by emailing support@stonikbyte.com.