Upgrade Guide

If there is a newer version released to Atlassian Marketplace, you can upgrade your add-on using the following:

1. Login to Jira as a system administrator, then click the "COG" icon in the top right corner of the page and select "Add-ons"
2. Select "Add-ons" from the administration menu, then click the “Manage add-ons” link from the left panel
3. Find the synapseRT add-on from the list, then click it
4. Click the “Upgrade” button
5. Once the upgrade process is done, installation of the latest version is complete

[Screenshot - IN0004_Upgrade_to_Newer_Version]

Upgrade synapseRT (version 7.x) to synapseRT latest version (v7.3.7.9 → v8.4.4.1 → Migration (Data) → latest version)

Upgrade synapseRT (version 6.x) to synapseRT version 8.4.1.0 (v6.x → v6.3.7.9 → Migration (Data) → 8.4.1.0)

1. Before installing synapseRT to your Jira server:
   1). Check if you have other issue types mapped to "Test Case" and "Test Plan" in synapseRT. If you do, convert the tickets to Test Case and Test Plan issue types; for help with this, please refer to "Moving an issue."
   2). Check and update the synapseRT configuration from "Administration->Add-ons->SYNAPSERT->synapseRT Configuration->Issue Types" with the following:
   1. Select "Test Case" as Test Case issue type
   2. Select "Test Plan" as Test Plan issue type
   3. Note down mapping values for Requirements issue type
   4. Note down mapping values for Bugs issue type
      

   3). Check if any Jira services are configured for synapseRT (prior to version 8.0) e.g 'Synapse Bonfire Service'. If you do, you need remove these Jira services manually:

   1. Log in as a user with the Jira System Administrator permission

   2. Choose Administration > System
   3. Select Advanced > Services to open a page showing all the configured services
   4. Click the Delete link associated with the service you wish to remove
2. Make sure your Jira server has already been upgraded to Jira 7.x; please refer to synapseRT supported Jira versions
3. Install synapseRT v8.4.4.1 to your Jira server; please refer to "Installation guide"
4. Update synapseRT configuration settings from "Administration->Add-ons->SYNAPSERT->Configuration" with the following:
   a. Set the same value as is in synapseRT for "Requirements" mapping
   b. Set the same value as is in synapseRT for "Bugs" mapping
5. Complete the migration process by following these steps:
   a. Go to "Administration->Add-ons->SYNAPSERT->Migration"
   b. Click the "Migrate" button and wait until the migration process is complete
6. As workflows created from old synapseRT (prior to version 8.0) are no more required by synapseRT, we request to remove the Postfunctions offered by old synapseRT from your workflows or assign any newly created workflow or Jira default workflow to them. Otherwise, you may face an error 'Could not load FunctionProvider class' when you execute your workflow actions. 

Changes are made once the upgrading and migration are complete

Issue types change

Entities/fields change inside different issue types