Sitecore SXA Throws Errors When Upgrading From Coveo for Sitecore 4.1 to Coveo for Sitecore 5

Sitecore Ecommerce Website Workplace Developer System Administrator Product Documentation
In this article

Symptoms

This issue occurs when you have an instance of Sitecore with Sitecore SXA installed and you upgrade Coveo for Sitecore from version 4.1 to version 5. During the installation of the Coveo for Sitecore 5 package, you get the following error in the Install a Package dialog:

The installation failed.
One or more exceptions occurred while processing the subscribers to the 'item:moving' event.
For more information see the Sitecore log.
Try one of the following options:
Retry the installation

Cause

Sitecore SXA detects a change in the Coveo Search panel options between Coveo for Sitecore 4.1 and Coveo for Sitecore 5.

Resolution

The solution is to temporarily disable the SXA processor responsible for throwing this error in order to be able to install Coveo for Sitecore 5.

To disable the SXA processor

  1. Open the Sitecore.XA.Foundation.Multisite.config file with a text editor. In Sitecore 9 instances, this file is located under <SITECORE_INSTANCE_ROOT>\App_Config\Include\Foundation . In Sitecore 8 instances, the file is located under <SITECORE_INSTANCE_ROOT>\Website\App_Config\Include\Foundation.

  2. In the <events> element, locate the following element:

    <event name="item:moving">
    <handler type="Sitecore.XA.Foundation.Multisite.EventHandlers.VirtualMediaFolderValidator, Sitecore.XA.Foundation.Multisite" method="OnItemMoving" />
</event>

  3. Comment out the <handler> element as follows:

    <event name="item:moving">
    <!--
    <handler type="Sitecore.XA.Foundation.Multisite.EventHandlers.VirtualMediaFolderValidator, Sitecore.XA.Foundation.Multisite" method="OnItemMoving" />
    -->
</event>

  4. Install Coveo for Sitecore 5.

  5. Uncomment the <handler> element.