How to migrate to version 2.x

Summary

Version 2 of the add-on uses a different plugin key. This means both version 1 and version 2 add-ons can be installed at the same time. However, because of this refactoring, existing post functions using version 1 of this add-on will NOT automatically migrate to version 2. This describes the options for migrating the configuration.

Details

There are a number of ways to migrate - choose one method that works best for you:

Define the post functions again

  1. Remove old post functions

  2. Add new post functions

Save and restore your workflow(s) using XML using standard JIRA functions for workflows

This needs to be done for each workflow that uses the create function:

  1. Save the existing workflow.

  2. Edit the saved XML using any editor.

    • Find: com.telenor.jira.plugin.workflow.createsubissue.CreateSubIssueFunction

    • Replace: org.swift.jira.cot.functions.CreateSubIssueFunction

    • Find: "field.subIssueAssignTo"

    • Replace: "field.subIssueAssignee"

    • Find: "field.subIssueOverview"

    • Replace: "field.subIssueSummary"

  3. Rename existing workflow and scheme.

  4. Import modified workflow.

  5. Re-associate the new workflow with a workflow scheme.

  6. Re-associate project to the new scheme.

Direct JIRA database update

This should be tested on a test instance and you should backup your database first.

  1. Stop JIRA.

  2. Run this SQL against your JIRA database.

    SQL to migrate from version 1 to version 2

    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 update jiraworkflows set descriptor = replace(descriptor, '<arg name="class.name">com.telenor.jira.plugin.workflow.createsubissue.CreateSubIssueFunction</arg>', '<arg name="class.name">org.swift.jira.cot.functions.CreateSubIssueFunction</arg>') where descriptor like '%<arg name="class.name">com.telenor.jira.plugin.workflow.createsubissue.CreateSubIssueFunction</arg>%'; update jiraworkflows set descriptor = replace(descriptor, '<arg name="field.subIssueAssignTo">', '<arg name="field.subIssueAssignee">') where descriptor like '%<arg name="field.subIssueAssignTo">%'; update jiraworkflows set descriptor = replace(descriptor, '<arg name="field.subIssueOverview">', '<arg name="field.subIssueSummary">') where descriptor like '%<arg name="field.subIssueOverview">%';

     

  3. Restart JIRA.

  4. Verify function definitions are accurate and new field defaults are appropriate.