It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Jira and Jira Align Integration: Migrating an integrated Jira Align team to a new Program

Agile (Scrum) and Kanban teams in Jira Align are associated to a Program (Agile Release Train).  Due to organizational changes it is sometimes necessary to migrate Jira Align teams from one Program to another.  The following article covers how to migrate a Jira Align team integrated with Jira from one Program to another in Jira Align

 

1. Navigate to Jira Align Admin > Jira Settings > Manage Projects and update the Program mapping for the Jira Project that contains the team’s data.

image.png

  1. Click Administration
  2. Click Jira Settings
  3. You will be taken to the Manage Projects panel
  4. Select the Jira Project you want to update
  5. Select the new Program
  6. Click Save & Close

 

2. Navigate to Jira Align Admin > Jira Management > Manage Projects and update the Program mapping of the Jira Board associated to the Team that is being Migrated to a new Program.

image.png

  1. Click Administration
  2. Click Jira Management
  3. Search for the Board Name you want to update
  4. Click Board ID
  5. Update the Board’s Program mapping to new Program
  6. Click Save & Close

 

3. Navigate to Jira Align Admin > Jira Management > Manage Projects and update the Program association of the Team that is being Migrated.

image.png

  1. Click Administration
  2. Click Jira Management
  3. Search for the Board Name of the team you want to update
  4. Click the Team you want to update
  5. Update the Team’s Program field to new Program
  6. Click Save & Close

 

4. Navigate to Team > Sprints (Iterations) and update the Team’s legacy Sprint’s Program and PI fields (This step can be skipped for Kanban teams).

image.png

  1. Set the Context Menu with the Team being updated
  2. Click Team on Navigation Bar
  3. Click Sprints (Iterations)
  4. Select the Sprint you will update (all associated team sprints will need to be updated)
  5. Update the Sprint’s Program field to new Program and if the new Program is associated to a different PI update the PI
  6. Click Save & Close
  7. Repeat for all Team Sprints

 

5. Navigate to Jira Align Admin > Jira Settings > Jira Integration and run a custom JQL to update the Team’s work items to the new Program.

image.png

  1. Click Administration
  2. Click Jira Settings
  3. Click Jira Integration Panel
  4. Select the Jira Project you want to query
  5. Select the data you want to query: (createdDate >= -90d or updatedDate >=-90d) will migrate all data from the selected Project that was created or updated in the last 90 days from its legacy Jira Align Program to its new Program. You can shift the day count as needed.
  6. Set the Board Sync to No
  7. Copy the JQL Query Preview and test it in your Jira Application to verify it captures the correct issues that you would like to migrate to the new Program in Jira Align
  8. Click Run

7 comments

Thanks for sharing Tim. 

Like Tim Keyes likes this
SriKumar P Atlassian Team Jan 21, 2020

Hey Tim,

Thanks for the great share 🙂👍

Like Tim Keyes likes this

Much needed article, Tim! Good work!

Like Tim Keyes likes this

Hello @Tim Keyes 

Thanks for sharing this article, I have a query which I wanted to ask. Basically, this process works well, but there can be a situation where a Jira project is having 5 team boards but when we map it to Align then from a organisational structure point of view, 4 teams out of the 5 can be under a single program X and the 5th team can be under program Y. 

Thus, is it possible to move a team from program X to program Y in Jira Align while keeping the source Jira project to Program mapping the same but just doing steps 2 to 5 and not doing the step 1 because the source project still maps to program X having majority of teams. While updating the boarding configuration for the 5th team and updating the program in the board configuration and in the Jira Align team configuration by moving this team to program Y.

Like Tim Keyes likes this

Hi @Tarun Sapra great question and point to raise.  This article is intended for the recommended setup of one integrated Jira board per an integrated Project.  Jira Align relies heavily on the vertical nesting of data meaning that the Program of an integrated Story will need to be the same as the Program of an integrated Feature (unless it is a multi-program feature which will add significantly more complexity to a setup).

I would recommend moving the fifth board to a new Project in the referenced case as there is a 1:1 ratio of how a Jira Project can only map to one Jira Align Program.  This means if the fifth team was changing to a new Program in Jira Align the only way to send the data to a new Program in Jira Align would be utilizing a brand new Project. 

Cheers!
Tim 

Like Shawn Kessler likes this

Hi Tim,

Thank you for the article. We have 52 sprints to be moved to new program. Is there any bulk update that i can do?

Also how to handle the sprints that are completed and locked in status?

Regards,

Vandana.

Tim Keyes Atlassian Team Jun 30, 2020

Hi @Vandana Kurapati

I hope all is well!

Thank you for the question.  There is not a method of bulk updating the Program and Program Increment of the sprints.  This process is still manual.  I have discussed automating this process with our Product team but the work has not been planned as of this time.

For sprints that are completed and locked a Super Admin user can change the State of the Sprint in Jira Align from Complete to Not Started, save the sprint, unlock the sprint, change its Program and Program Increment, then Complete the sprint again.

Cheers!
Tim

Comment

Log in or Sign up to comment
TAGS
Community showcase
Published in Jira Align

Best Practices in Jira Align

Hello Jira Align customers! In order to better serve you on your journey with Jira Align, the Community team has worked with the Jira Align team to curate the content in this collection to better s...

102 views 0 3
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you