Solution update fails with an error "Found more than one RibbonDiff entity"

Applies to: Microsoft Dynamics CRM 2011

Symptoms


Solution update fails with an error "Found more than one RibbonDiff entity.", when the installed solution has the same Id value for multiple LocLabels.

Cause


During the import of an updated solution, CRM tries to find the LocLabel node to update with the new customization. When there are multiple LocLabel nodes with same ID, CRM doesn't identify which one to update, and fails.

Resolution


Resolution 1:

Update the customization.xml file to have an empty RibbonDiff or one that doesn't have the LocLabel ID. Once updated, you are able to install the correct Solution again that would have the Ribbon customizations.

Resolution 2:

If the solution is managed, you are able to uninstall the solution to delete the existing Ribbon definition. Then re-import the managed solution with correct Ribbon.
Note: Uninstalling a managed solution will delete any entities, fields, ect that the solution installed which would include the data in those areas as well.