Unable to enable Zephyr Squad app v6.1.0 or higher in Jira
Platform notice: Server and Data Center only. This article only applies to Atlassian products on the Server and Data Center platforms.
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
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:
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
Resolution
- Visit Jira Admin → Manage Apps
- Change the drop down from "User-installed" to "All Apps"
- Find Jira Cloud Migration Assistant App
- Upgrade it to version 1.5.4 or higher, or, alternatively, disable it.
- Once JCMA is upgraded or disabled, try to enable Zephyr Squad