ShareShare on LinkedIn.Share on Facebook.Share on Twitter.Share via email.

Zephyr Squad for Jira: Migration Evaluation

February 1, 2022
<p>In this post we share our experience with migrating <a href="https://marketplace.atlassian.com/apps/1014681/zephyr-for-jira-test-management?hosting=cloud&amp;tab=overview" target="_blank" rel="noreferrer noopener">Zephyr Squad – Test Management for Jira</a>, (previously known as Zephyr for Jira) developed by SmartBear.</p> <hr class="wp-block-separator"> <div style="height:64px" aria-hidden="true" class="wp-block-spacer"></div> <div class="wp-block-columns are-vertically-aligned-center is-layout-flex wp-container-core-columns-layout-1 wp-block-columns-is-layout-flex"> <div class="wp-block-column is-vertically-aligned-center is-layout-flow wp-block-column-is-layout-flow" style="flex-basis:33.33%"> <div class="wp-block-image"><figure class="aligncenter size-full is-resized"><img loading="lazy" decoding="async" src="https://wordpress.highwaythreesolutions.com/wp-content/uploads/2021/08/zephyr-logo.jpeg" alt="" class="wp-image-850" width="269" height="141" srcset="https://wordpress.highwaythreesolutions.com/wp-content/uploads/2021/08/zephyr-logo.jpeg 980w, https://wordpress.highwaythreesolutions.com/wp-content/uploads/2021/08/zephyr-logo-300x158.jpeg 300w, https://wordpress.highwaythreesolutions.com/wp-content/uploads/2021/08/zephyr-logo-768x404.jpeg 768w" sizes="(max-width: 269px) 100vw, 269px"></figure></div> </div> <div class="wp-block-column is-vertically-aligned-center is-layout-flow wp-block-column-is-layout-flow" style="flex-basis:66.66%"> <p>Before migrating Zephyr, you should take the time to understand what and how attributes are migrated. Not only does shifting Zephyr data to the Cloud require a good knowledge of Jira migration tools, but also Zephyr Squad Migration Tools. Atlassian and SmartBear provide limited documentation and support resources to aid you in your migration.</p> </div> </div> <figure class="wp-block-table is-style-h3-table"><table class="has-fixed-layout"><tbody><tr><td><strong>Feature Compatibility</strong></td><td class="has-text-align-center" data-align="center"><img loading="lazy" decoding="async" width="264" height="83" class="wp-image-567" style="width: 150px" src="https://wordpress.highwaythreesolutions.com/wp-content/uploads/2021/08/feature-compatibility-partial.png" alt="Partial"></td></tr><tr><td><strong>Migration Complexity</strong></td><td class="has-text-align-center" data-align="center"><img loading="lazy" decoding="async" width="263" height="82" class="wp-image-570" style="width: 150px" src="https://wordpress.highwaythreesolutions.com/wp-content/uploads/2021/08/migration-complexity-medium.png" alt="Medium"></td></tr><tr><td><strong>Migration Method</strong></td><td class="has-text-align-center" data-align="center"><img loading="lazy" decoding="async" width="264" height="82" class="wp-image-573" style="width: 150px" src="https://wordpress.highwaythreesolutions.com/wp-content/uploads/2021/08/migration-method-mixed.png" alt="Mixed"></td></tr><tr><td><strong>Migration Support Available</strong></td><td class="has-text-align-center" data-align="center"><img loading="lazy" decoding="async" width="264" height="83" class="wp-image-576" style="width: 150px;" src="https://wordpress.highwaythreesolutions.com/wp-content/uploads/2021/08/migration-support-available-limited.png" alt="Limited"></td></tr><tr><td><strong>Supported Jira Migration Methods</strong></td><td class="has-text-align-center" data-align="center"><img loading="lazy" decoding="async" width="264" height="82" class="wp-image-578" style="width: 150px" src="https://wordpress.highwaythreesolutions.com/wp-content/uploads/2021/08/supported-jira-migration-methods-full-site-import.png" alt="Full Site Import"><br><img decoding="async" src="https://wordpress.highwaythreesolutions.com/wp-content/uploads/2021/08/supported-jira-migration-methods-jcma.png" alt="JCMA" style="width: 150px;"></td></tr></tbody></table></figure> <hr class="wp-block-separator"> <div style="height:64px" aria-hidden="true" class="wp-block-spacer"></div> <h3 class="wp-block-heading" id="feature-compatibility">Feature Compatibility</h3> <div class="wp-block-columns is-layout-flex wp-container-core-columns-layout-2 wp-block-columns-is-layout-flex"> <div class="wp-block-column is-layout-flow wp-block-column-is-layout-flow" style="flex-basis:66.66%"> <p>Most of the features offered on Zephyr Squad’s Server environment are also available on Cloud, but there a few features that are exclusive to either the Server or Cloud environment. Features that are not available include:</p> </div> <div class="wp-block-column is-vertically-aligned-center is-layout-flow wp-block-column-is-layout-flow" style="flex-basis:33.33%"> <div class="wp-block-image"><figure class="aligncenter size-full"><img loading="lazy" decoding="async" width="96" height="96" src="https://wordpress.highwaythreesolutions.com/wp-content/uploads/2021/08/icons8-comparing-96.png" alt="" class="wp-image-590"></figure></div> </div> </div> <ul><li>Workflow Validator in Global Settings</li><li>Archiving projects</li><li>Reordering test executions</li><li>Zephyr permissions</li></ul> <p>Cloud does offer new functionality:</p> <ul><li>ADG UI in Global settings</li><li>Ability to use Jira and Zephyr filters with the traceability matrix</li><li>Native support for BDD</li></ul> <p>For a complete list of feature differences, take a look at<a href="https://zephyrdocs.atlassian.net/wiki/spaces/ZFJ0500/pages/2529689607/Zephyr+for+Jira+Features+-+Server+Data+Center+vs+Cloud" target="_blank" rel="noreferrer noopener"> this comparison of Zephyr features</a>.</p> <p>Even though there are feature discrepancies between the environments, SmartBear continues to bring more functionality to the Cloud offering of Zephyr Squad.</p> <div style="height:64px" aria-hidden="true" class="wp-block-spacer"></div> <h3 class="wp-block-heading" id="migration-method-and-complexity">Migration Method and Complexity</h3> <div class="wp-block-columns is-layout-flex wp-container-core-columns-layout-3 wp-block-columns-is-layout-flex"> <div class="wp-block-column is-vertically-aligned-center is-layout-flow wp-block-column-is-layout-flow" style="flex-basis:33.33%"> <div class="wp-block-image"><figure class="aligncenter size-full"><img loading="lazy" decoding="async" width="96" height="96" src="https://wordpress.highwaythreesolutions.com/wp-content/uploads/2021/08/icons8-hard-to-find-96.png" alt="" class="wp-image-591"></figure></div> </div> <div class="wp-block-column is-layout-flow wp-block-column-is-layout-flow" style="flex-basis:66.66%"> <p>One method to migrate Zephyr is to use a <a href="https://support.smartbear.com/zephyr-squad-server/docs/get-started/cloud-migration-guide/via-open-source-tool.html" target="_blank" rel="noreferrer noopener">Zephyr migration tool</a>. A <a href="https://community.atlassian.com/t5/Jira-articles/How-to-migrate-Zephyr-data/ba-p/985762" target="_blank" rel="noreferrer noopener">post by Alex Matveev</a> outlines a few different options of applying the Zephyr Squad Migration Tool; however, it does not have information on migrating resources associated with test cases like cycles, folders, historical data on executions, and attachments.</p> </div> </div> <p>Another approach to migrating Zephyr data is to complete a full site import and then use scripting to move Zephyr Squad artifacts. In order to move these artifacts you will need to enable the Zephyr API (ZAPI), which is available by installing Zephyr Squad’s ZAPI add-on on both Server and Cloud.</p> <p>In mid-October 2021, <a href="https://jira.atlassian.com/browse/MIG-533">support to migrate Zephyr</a> with the Jira Cloud Migration Assistant (JCMA) became available within the JCMA beta. The Zephyr Squad Server Documentation contains instructions on how it can <a href="https://support.smartbear.com/zephyr-squad-server/docs/get-started/cloud-migration-guide/via-jcma.html">migrate via the JCMA</a>. This support is only accessible to versions six-and-up of the Zephyr Squad Server app and does not migrate data such as archived tests or ZBot agents from the test automation.</p> <div style="height:64px" aria-hidden="true" class="wp-block-spacer"></div> <h3 class="wp-block-heading" id="migration-support-available">Migration Support Available</h3> <div class="wp-block-columns is-layout-flex wp-container-core-columns-layout-4 wp-block-columns-is-layout-flex"> <div class="wp-block-column is-layout-flow wp-block-column-is-layout-flow" style="flex-basis:66.66%"> <p>While Zephyr documentation provides limited <a href="https://zephyrdocs.atlassian.net/wiki/spaces/ZFJ0500/pages/2217869317/Cloud+Migration+Guide">documentation</a> about Zephyr migration, SmartBear has produced step-by-step documentation to <a href="https://support.smartbear.com/zephyr-squad-server/docs/get-started/cloud-migration-guide/index.html">support Server to Cloud migration</a> with the JCMA and open support tools. You can always contact SmartBear by <a href="https://support.smartbear.com/open-ticket/">submitting a support request</a> to get assistance on issues specific to your migration.</p> </div> <div class="wp-block-column is-vertically-aligned-center is-layout-flow wp-block-column-is-layout-flow" style="flex-basis:33.33%"> <div class="wp-block-image"><figure class="aligncenter size-full"><img loading="lazy" decoding="async" width="96" height="96" src="https://wordpress.highwaythreesolutions.com/wp-content/uploads/2021/08/icons8-service-96.png" alt="" class="wp-image-592"></figure></div> </div> </div> <p>Also we have written a detailed, technical post about the Zephyr migration journey: <a href="https://www.highwaythreesolutions.com/blog/zephyr-for-jira-migrating-to-the-cloud">Zephyr for Jira: Migrating to the Cloud</a>.</p> <div style="height:64px" aria-hidden="true" class="wp-block-spacer"></div> <h2 class="wp-block-heading" id="possible-challenges">Possible Challenges</h2> <div class="wp-block-columns is-layout-flex wp-container-core-columns-layout-5 wp-block-columns-is-layout-flex"> <div class="wp-block-column is-vertically-aligned-center is-layout-flow wp-block-column-is-layout-flow" style="flex-basis:33.33%"> <div class="wp-block-image"><figure class="aligncenter size-full"><img loading="lazy" decoding="async" width="96" height="96" src="https://wordpress.highwaythreesolutions.com/wp-content/uploads/2021/08/icons8-warning-shield-96.png" alt="" class="wp-image-593"></figure></div> </div> <div class="wp-block-column is-layout-flow wp-block-column-is-layout-flow" style="flex-basis:66.66%"> <p><br>When we completed our Server to Cloud Zephyr migration, we encountered several issues:</p> <ul><li>Since the Cloud app may be feature light, non-hosted environments may leave app providers to host and run their code as it would have run on a Jira Server.</li></ul> </div> </div> <ul><li>Despite the benefits of using ZAPI, there are no scripts available for pulling and pushing data between environments.</li><li>If you are implementing a full site import, it will remove the Zephyr Squad plug-in which will cause Zephyr Squad’s <code>test</code> issue type to be undefined and break the Jira Cloud instance after Zephyr Squad is re-installed.</li><li>Any attachments within the test executions migrated by the JCMA beta are not migrated properly, leaving the migrated file as empty in Cloud.</li></ul> <p>Also, ZAPI cannot be installed if Zephyr Squad was previously installed to the Jira Cloud instance. This should not be an issue as Zephyr Squad for Cloud is supposed to consist of ZAPI’s API and materials.</p> <div style="height:64px" aria-hidden="true" class="wp-block-spacer"></div> <div class="wp-block-buttons is-layout-flex wp-block-buttons-is-layout-flex"> <div class="wp-block-button is-style-h3-cta-button"><a class="wp-block-button__link" href="https://www.highwaythreesolutions.com/contact" target="_blank" rel="noreferrer noopener">Need assistance? Contact us!</a></div> </div> <div style="height:64px" aria-hidden="true" class="wp-block-spacer"></div> <p><strong>Resources:</strong></p> <ul><li><strong><a rel="noreferrer noopener" href="/blog/jira-app-migration-getting-ready-for-the-cloud" target="_blank"></a><strong><strong><strong><a rel="noreferrer noopener" href="/blog/jira-app-migration-getting-ready-for-the-cloud" target="_blank">Highway Three Top 10 Apps Evaluated series</a></strong></strong></strong></strong></li><li><strong><a rel="noreferrer noopener" href="https://marketplace.atlassian.com/apps/1014681/zephyr-for-jira-test-management?hosting=cloud&amp;tab=overview" target="_blank">Zephyr Squad – Test Management for Jira App</a></strong></li><li><strong><a rel="noreferrer noopener" href="/blog/zephyr-for-jira-migrating-to-the-cloud" target="_blank">Zephyr for Jira: Migrating to the Cloud Blog Post</a></strong></li><li><strong><a rel="noreferrer noopener" href="https://zephyrdocs.atlassian.net/wiki/spaces/ZFJ0500/pages/2529689607/Zephyr+for+Jira+Features+-+Server+Data+Center+vs+Cloud" target="_blank">Server and Cloud Feature Comparison</a></strong></li><li><strong><a rel="noreferrer noopener" href="https://community.atlassian.com/t5/Jira-articles/How-to-migrate-Zephyr-data/ba-p/985762" target="_blank">Alex Matveev’s post on migrating Zephyr data</a></strong></li><li><a href="https://jira.atlassian.com/browse/MIG-533"><strong>Support Migration for: Zephyr Squad (fka: Zephyr for Jira)</strong></a></li><li><a href="https://support.smartbear.com/zephyr-squad-server/docs/get-started/cloud-migration-guide/via-jcma.html"><strong>Migrate via JCMA</strong></a></li><li><strong><a rel="noreferrer noopener" href="https://zephyrdocs.atlassian.net/wiki/spaces/ZFJ0500/pages/2217869317/Cloud+Migration+Guide" target="_blank">Zephyr Cloud Migration Guide</a></strong></li><li><strong><a rel="noreferrer noopener" href="https://support.smartbear.com/open-ticket/" target="_blank">Smartbear Support</a></strong></li></ul>