Unable to enable Zephyr Squad app v6.1.0 or higher in Jira

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

Problem

Zephyr Squad - Test Management for Jira app version 6.1.0 or higher fails to enable when an older version of Jira Cloud Migration Assistant App is enabled

The Jira application log (atlassian-jira.log) shows the following error:

1 2 Unable to start the plugin container for plugin 'com.thed.zephyr.je' org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'zfjMigrationComponent' defined in URL [bundle://249.0:0/META-INF/spring/atlassian-plugins-components.xml]: Unsatisfied dependency expressed through constructor parameter 0; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'zfjCloudMigrationAccessor' defined in URL [bundle://249.0:0/META-INF/spring/atlassian-plugins-components.xml]: Initialization of bean failed; nested exception is java.lang.RuntimeException: Failed to initialise CloudMigrationAccessor

Diagnosis

Environment

  • Jira Server or Datacenter

  • Zephyr Squad version 6.1.0 or higher

  • Jira Cloud Migration Assistant App is installed and enabled and is below version 1.5.4 (it is bundled within new versions of Jira)

Diagnostic Steps

  • Your environment matches above

  • You see the above mentioned log line in the atlassian-jira.log file (located in Jira Home/log directory) when attempting to start Zephyr Squad

Cause

Zephyr Squad relies on a module of the Jira Cloud Migration Assistant (JCMA) App which is not available in older versions of the JCMA App

Solution

Resolution

  1. Visit Jira Admin → Manage Apps

  2. Change the drop down from "User-installed" to "All Apps"

  3. Find Jira Cloud Migration Assistant App

  4. Upgrade it to version 1.5.4 or higher, or, alternatively, disable it.

  5. Once JCMA is upgraded or disabled, try to enable Zephyr Squad

Updated on April 8, 2025

Still need help?

The Atlassian Community is here for you.