Agile Poker Server to Cloud migration guide

Owned by Derya Özdemir
Last updated: Aug 08, 2024 by Derya Özdemir
4 min read

Here's all you need to know about moving your Jira Server or Jira Data Center (DC) instance to Jira Cloud with Agile Poker.

On this page:

On this page:

1. Server/Data Center to Cloud migration

Agile Poker will appear in Jira Cloud Migration Assistant to allow a smooth transition from Server to Cloud.

Most Agile Poker data will be migrated one-to-one, including general configuration, Interactive and Asynchronous sessions, and their configurations. However, there are a few caveats to keep in mind:

Automatic migration availability depends on Atlassian enabling app migration in Jira Cloud Migration Assistant.

1.1. Not migrated

Relative estimation sessions will not be migrated. Please finish any ongoing Relative sessions before the migration, as their state won't be transferred.

1.2. Special handling of some fields

For Asynchronous estimation sessions, only the estimation comments from the last round will be migrated. Comments from previous rounds will not be transferred.

If there is more than one Moderator defined for an Asynchronous session in Agile Poker Server, each session participant will become a Moderator (the "Everyone" option will be selected for that field). The same behavior applies if no Moderator was set.

Agile Poker for Jira Server allowed the inclusion of issues that did not have the Estimation field configured for them into estimation sessions. Such issues will be migrated to Cloud as part of the corresponding Agile Poker session, but they will be hidden from the session until the Estimation field is configured for them in Jira. This was done to avoid confusion when estimates for such issues could not be saved.

1.3. Special cases handling (Update)

Agile Poker sessions are linked to a specific Jira board. Previously, there were limitations during migration documented by Atlassian. However, Atlassian has resolved the migration issue mentioned in this section via the resolution of the MIG-169 ticket. Boards linked to more than one project can now be migrated successfully.

Estimation sessions that didn't have at least one participant available were not migrated previously. However, this issue has also been addressed in the resolution of the aforementioned ticket. It's recommended to verify the latest updates on Jira Cloud migration to ensure the smooth transition of all sessions. To learn more, check out Atlassian documentation here.

1.4. Migration troubleshooting

We highly recommend enabling logging for Agile Poker. In order to do that, you need to add com.spartez.pokerng with info level at Jira Server’s logging and profiling page (more info).

The following log entry will appear once after Agile Poker or JCMA gets restarted. It indicates that Agile Poker is ready for the migration process:

2021-02-19 ... INFO ... [...CloudMigrationHandler] The migration listener is ready to take migrations events

The following log entries will appear during each migration process:

2021-02-24 ... INFO [...CloudMigrationHandler] Migration New Migration started 2021-02-24 ... INFO [...MigrationDtoProvider] Preparing MigrationDto ... 2021-02-24 ... INFO [...MigrationDtoProvider] MigrationDto with 10 boards and 45 sessions is prepared. 2021-02-24 ... INFO [...CloudMigrationHandler] Writing app data on the cloud ... 2021-02-24 ... INFO [...CloudMigrationHandler] App data is written.

Such warning logs will contain information about boards and sessions that were skipped during the migration; as well as details about session participants, issues, and custom fields referenced in the migrated sessions that were missing in Jira Cloud:

2021-02-24 ... WARN [...MigrationDtoProvider] 3 sessions from 2 boards got skipped. Board ids: [1001, 1002] - Session ids: [2001, 2002, 2003] 2021-02-24 ... WARN [...MigrationDtoProvider] 4 users are missing from cloud. User ids: [31, 32, 33, 34] 2021-02-24 ... WARN [...MigrationDtoProvider] 5 issues are missing from cloud. Issue ids: [41, 42, 43, 44, 45] 2021-02-24 ... WARN [...MigrationDtoProvider] 2 custom fields are missing from cloud. Custom field ids: [51, 52]

We have put a limit on the maximum size of the Agile Poker data migration bundle. If that limit is exceeded, you’ll see a corresponding message in the migration log. Please contact our support team for assistance in such cases. Although we anticipate no customers will exceed this limit, we have implemented measures to protect our systems from unexpectedly large data sets.

2. Features available in Agile Poker Cloud only

The Cloud version introduces collaborative boards for team estimations. In Relative sessions, it used to be only the moderator who placed the stories while sharing a screen in the Server version. Cloud brings a significant change to team estimations:

  • All team members can join the same session simultaneously, eliminating the need for a moderator to share a screen.

  • If your team cannot reach a consensus during the estimation session, there is an unbiased voting feature to help you decide on the issue's relative complexity.

  • Check out Team Relative in action video for more information.

Another valuable addition is the support of Bucket Sizing estimation, which is similar to a Relative session but with a set of predefined labeled buckets. There are other features available in Cloud only:

  • Issue Detail View: In the Cloud Relative session, you can view and comment on Jira issues directly from the session, in a manner you are familiar with. Issue details appear in a modal window, just like on any Jira board.

  • Interactive session in Cloud is available through a dedicated page, rather than being embedded directly into Jira's backlog.

What you might want to do:

  • Consider giving your team a quick tour of Agile Poker or share this page as an instructional guide.

  • If you need help, please get in touch, and we'll be happy to introduce your team to Agile Poker for Cloud.

3. Functionality missing from Agile Poker Cloud

As a user of Jira Server or Data Center, you may be accustomed to certain functionalities and may be concerned about what is missing. Here are the features that are currently unavailable in the Cloud version of Agile Poker:

  • Distribution chart in Asynchronous session
    UPDATE, Jan-23: the Distribution chart is now available in Interactive and Async sessions of Agile Poker.

  • Capacity calculator

    UPDATE, Jan-23: a simplified version of the Capacity calculator is now available in Interactive and Async sessions of Agile Poker.

  • Estimation sessions summary for Interactive session, including a page showing the history of personal and final estimation changes

  • Mobile view

If you need any guidance or assistance during your migration process, please don't hesitate to contact us. We'll be glad to help! We'd also love to hear about your organization's specific needs so that we can adjust our product development plans accordingly.