Uploaded image for project: 'Jira Software Data Center'
  1. Jira Software Data Center
  2. JSWSERVER-16225

Documentation/Script request on the removed Jira Agile Upgrade Task

    XMLWordPrintable

Details

    • Suggestion
    • Resolution: Unresolved
    • None
    • Documentation
    • 0
    • 1
    • We collect Jira feedback from various sources, and we evaluate what we've collected when planning our product roadmap. To understand how this piece of feedback will be reviewed, see our Implementation of New Features Policy.

    Description

      Problem Definition

      As mentioned by the developer in this JRA-59832 ticket:

      Unfortunately it was becoming too difficult to maintain older upgrade tasks, so in 7.1.0 the Agile team removed upgrade tasks older than 12 months.
      You can either
      Upgrade JIRA Agile to 6.7.x on their original instance (for JIRA 6.3, 6.4 and 6.5). Or;
      Import the data into a JIRA Software 7.0.0 instance first. (or upgrade the original instance to 7.0.0)
      Both of these scenarios will run the required upgrade tasks.

      So currently,when user want to take "Roll back" action, he must prepare

      1. backup of JIRA Installation Directory
      2. backup of JIRA HOME directory
      3. backup of JIRA Database directory
        So if user missed those backups, user can't take this action.
        User can notice after upgrade by atlassian-jira.log because no error/warning on before upgrade process.(https://jira.atlassian.com/browse/JRA-60371)

      In 7.1.4, there are

      (ghUpgradeTask046)	Assign status categories to Agile Simplified Workflow statuses.
      (ghUpgradeTask047)	Remove classic gadget
      (ghUpgradeTask048)	Inserts a reindex required warning into the admin screen for the epic label custom field searching
      (ghUpgradeTask049)	Migration Manage Sprints permission
      (ghUpgradeTask050)	Re-migration Manage Sprints permission
      (ghUpgradeTask051)	Migration Manage Sprints permission for BTF customers only
      

      And in 7.0.10,

      (ghUpgradeTask003)	Moves some preferences values to settings
      (ghUpgradeTask004)	Layout Keys Upgrade Task
      (ghUpgradeTask007)	Flag Field Value Upgrade Task
      (ghUpgradeTask008)	Listener Removal Upgrade Task
      (ghUpgradeTask009)	GreenHopper Nightservice cleanup Task
      (ghUpgradeTask010)	Custom Field Reindex Message
      (ghUpgradeTask011)	Custom Field Reindex Message
      (ghUpgradeTask012)	Labs Ranking Migration
      (ghUpgradeTask013)	Ranking Migration
      (ghUpgradeTask014)	Introduction of UpgradeVersionService
      (ghUpgradeTask015)	Migrating Sprint data from PropertySets back into AO
      (ghUpgradeTask016)	Migrating RapidView data from PropertySets back into AO
      (ghUpgradeTask017)	Setting default Estimation Statistic configuration for boards
      (ghUpgradeTask018)	Setting default Estimation Statistic configuration for boards
      (ghUpgradeTask019)	Setting sprint field reindex required message
      (ghUpgradeTask020)	Setting default swimlane strategy for boards
      (ghUpgradeTask021)	Setting default Tracking Statistic configuration for boards
      (ghUpgradeTask022)	Attempt to create Sprint custom field as Scrum is no longer a 'Labs' feature
      (ghUpgradeTask023)	Setting default card color strategy for boards
      (ghUpgradeTask024)	Fixes default sprint marker names in the database
      (ghUpgradeTask025)	Renames the Epic Label field to Epic Name
      (ghUpgradeTask026)	Adds custom fields for Epic support
      (ghUpgradeTask027)	Updating epic status custom field value based on the current resolution of the epic
      (ghUpgradeTask029)	Modifying change history items for Epic Link field to include issue ID
      (ghUpgradeTask030)	Inserts a reindex required warning into the admin screen for the epic label custom field
      (ghUpgradeTask031)	Migrate default issue details fields into configuration
      (ghUpgradeTask032)	Updating stored usernames to work with JIRA 6.0 rename user feature
      (ghUpgradeTask033)	Merge data from duplicated custom fields of managed GreenHopper custom fields
      (ghUpgradeTask034)	Add epic link custom field to default screen
      (ghUpgradeTask035)	Update searcher type for Flagged custom field
      (ghUpgradeTask036)	Set started flag of existing sprints to true
      (ghUpgradeTask037)	Renamed custom fields and work flows for JIRA Agile
      (ghUpgradeTask038)	Reset Analytics opt in values
      (ghUpgradeTask039)	Upgrade Rapid View owners to Board Admins
      (ghUpgradeTask040)	Reset custom field names
      (ghUpgradeTask041)	Update epic color to the new palette
      (ghUpgradeTask042)	Add sprint field to view/create/edit issue screens
      (ghUpgradeTask043)	Force Sprint Marker Migration
      (ghUpgradeTask044)	Migrate to lexo rank
      (ghUpgradeTask045)	Remove 'Rank (Obsolete)' custom fields
      (ghUpgradeTask046)	Assign status categories to Agile Simplified Workflow statuses.
      (ghUpgradeTask047)	Remove classic gadget.
      (ghUpgradeTask048)	Inserts a reindex required warning into the admin screen for the epic label custom field searching
      (ghUpgradeTask049)	Upgrade task to bring build number in sync with cloud
      (ghUpgradeTask050)	Upgrade task to bring build number in sync with cloud
      

      Error message shows us that

      1. JIRA 6.3.15&JIRA Agile 6.3.13 is "ghUpgradeTask042"
      2. JIRA Software 7.1.x starts its upgrade task from "ghUpgradeTask045"

      So ghUpgradeTasks from 043 to 044 are removed.

      Suggested Solution

      Publish some document or script to do JIRA Agile upgrade task that removed by the development team. The documentation should include about the things such like DB tables/record that are changed by these upgradetask. This would be easier than performing the rollback process.

      Attachments

        Activity

          People

            wthompson Wazza
            rvasudiven Ranjen Vasudiven (Inactive)
            Votes:
            2 Vote for this issue
            Watchers:
            4 Start watching this issue

            Dates

              Created:
              Updated: