Error converting XML to workflow descriptor when Upgrading 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

Symptoms

The following appears in the atlassian-jira.log:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 2014-10-07 23:44:19,747 JiraImportTaskExecutionThread-1 ERROR admin 1420x366x1 n5g4ws 127.0.0.1 /secure/admin/XmlRestore.jspa [atlassian.jira.upgrade.UpgradeManagerImpl] Exception thrown during upgrade: java.lang.RuntimeException: com.opensymphony.workflow.FactoryException: Error converting XML to workflow descriptor.: root cause: Attribute "name" is required and must be specified for element type "action". (line:381 col:45) com.atlassian.cache.CacheException: java.lang.RuntimeException: com.opensymphony.workflow.FactoryException: Error converting XML to workflow descriptor.: root cause: Attribute "name" is required and must be specified for element type "action". (line:381 col:45) at com.atlassian.cache.memory.DelegatingCache.get(DelegatingCache.java:67) at com.atlassian.jira.workflow.CachingWorkflowDescriptorStore.getWorkflow(CachingWorkflowDescriptorStore.java:67) at com.atlassian.jira.workflow.JiraWorkflowFactory.getWorkflow(JiraWorkflowFactory.java:37) at com.opensymphony.workflow.config.DefaultConfiguration.getWorkflow(DefaultConfiguration.java:89) at com.atlassian.jira.workflow.OSWorkflowManager.getWorkflow(OSWorkflowManager.java:197) at com.atlassian.jira.workflow.OSWorkflowManager.getWorkflows(OSWorkflowManager.java:116) at com.atlassian.jira.upgrade.tasks.UpgradeTask_Build6206.doUpgrade(UpgradeTask_Build6206.java:96) at com.atlassian.jira.upgrade.UpgradeManagerImpl.doUpgradeTaskSuccess(UpgradeManagerImpl.java:685) at com.atlassian.jira.upgrade.UpgradeManagerImpl.runUpgradeTasks(UpgradeManagerImpl.java:534) at com.atlassian.jira.upgrade.UpgradeManagerImpl.doUpgrade(UpgradeManagerImpl.java:463) ..... Caused by: java.lang.RuntimeException: com.opensymphony.workflow.FactoryException: Error converting XML to workflow descriptor.: root cause: Attribute "name" is required and must be specified for element type "action". (line:381 col:45) at com.atlassian.jira.workflow.CachingWorkflowDescriptorStore$WorkflowCacheLoader.load(CachingWorkflowDescriptorStore.java:142) at com.atlassian.jira.workflow.CachingWorkflowDescriptorStore$WorkflowCacheLoader.load(CachingWorkflowDescriptorStore.java:131) at com.atlassian.cache.memory.MemoryCacheManager$3$1.apply(MemoryCacheManager.java:104) at com.google.common.collect.ComputingConcurrentHashMap$ComputingValueReference.compute(ComputingConcurrentHashMap.java:355) at com.google.common.collect.ComputingConcurrentHashMap$ComputingSegment.compute(ComputingConcurrentHashMap.java:184) at com.google.common.collect.ComputingConcurrentHashMap.getOrCompute(ComputingConcurrentHashMap.java:69) at com.google.common.collect.ComputingConcurrentHashMap$ComputingMapAdapter.get(ComputingConcurrentHashMap.java:393) at com.atlassian.cache.memory.DelegatingCache.get(DelegatingCache.java:63) ... 23 more

Cause

Attribute "name" is required and must be specified for element type "action". Basically, in the workflow XML, all action id=""xxx"" must be followed by name=""

Resolution

  1. Get the XML backup and extract the contents

  2. Run the following to grep the lines that we want to check

    1. 1 grep "action id="\d*"" entities.xml > jira.txt
  3. Run another grep to list all that has no "name="

    1. 1 grep -v "name=" ./*.txt
    2. Results would be something like

      1 <action id="751" view="fieldscreen">
  4. Search for action id="751" in jira.txt file again to find the correct name value to fix the issue. For example

    1. 1 <action id="751" name="Open" view="fieldscreen">
  5. Open the entities.xml and update it as the above

  6. Compress them back to ZIP file and run the upgrade again

Updated on April 8, 2025

Still need help?

The Atlassian Community is here for you.