Upgrading Sitecore With Coveo for Sitecore

THIS IS ARCHIVED DOCUMENTATION

Upgrading Sitecore With Coveo for Sitecore

This is for:

To benefit from the latest features, enhancements, and bug fixes of Sitecore, you may want to upgrade your instance. This page describes the procedure to follow to upgrade your Sitecore instance with Coveo for Sitecore installed on it.

Leading Practices

Here are some leading practices to follow to avoid common issues when upgrading Sitecore with Coveo for Sitecore installed.

Verify that Coveo for Sitecore is compatible with your Sitecore version (see Supported Sitecore Versions and Dependencies).
Back up your Sitecore instance with Coveo for Sitecore before upgrading Sitecore. This includes backing up your files, licenses, encryption keys, and databases
Disable your Coveo for Sitecore .config files. They can be found in the App_Config\Include\Coveo folder. This way, you can avoid any potential conflict with other Sitecore .config files.
Upgrade from one update of Sitecore to the one strictly consecutive to the one you have installed. For example, if you want to update from Sitecore update 1 to update 3, it’s a good practice to update from update 1 to 2, and then from update 2 to 3.
If you want to upgrade both Sitecore and Coveo for Sitecore, upgrade Sitecore first, and Coveo for Sitecore after.
Follow the Leading Practices When Upgrading Coveo for Sitecore.
After having finished upgrading Sitecore and Coveo for Sitecore, rebuild your indexes (see Coveo for Sitecore Indexing Guide).

Upgrade to a New Update Revision

You may want to upgrade your Sitecore version to a new update revision, for example from Sitecore version 8.0 update 1 to 8.0 update 5. In this case, you would need to follow these steps.

With the Same Release of Coveo for Sitecore

You need to follow the Sitecore upgrade steps found on the Sitecore Developer Portal.

Coveo for Sitecore releases one version per minor Sitecore version per release (see Downloads). Therefore, Coveo for Sitecore will already be configured for your revision of Sitecore.

With a New Coveo for Sitecore Version

If you want to upgrade your Sitecore instance to a new update revision while also upgrading your Coveo for Sitecore version, you need to follow these steps:

Go to your App_Config\Include\Coveo folder, and disable all of the Coveo .config files. A common practice is to add .disabled at the end of their file name.
Upgrade your Sitecore instance. Follow the upgrade steps found on the Sitecore Developer Portal.
Once your Sitecore instance is upgraded, follow the Upgrade Procedures for Coveo for Sitecore.

Upgrade to a New Major or Minor Version of Sitecore

You may want to upgrade your Sitecore version to a new major or minor version, for example from Sitecore version 7.5 to 8.0, or from 8.0 to 8.1 In this case, you need to follow these steps:

Go to your App_Config\Include\Coveo folder, and disable all of the Coveo .config files. A common practice is to add .disabled at the end of their file name.
Update your Sitecore instance. Follow the steps found on the Sitecore Developer Portal.
Once your Sitecore instance is upgraded, download and install the new Coveo for Sitecore package corresponding to your new Sitecore instance. Follow the steps found on Installing Coveo for Sitecore.

Make sure that you upgrade to the same Coveo for Sitecore version that you had on your previous Sitecore instance.

For example, if you had the April 2016 release of Coveo for Sitecore for Sitecore 8.0 on your Sitecore 8.0 instance, and have now upgraded to Sitecore 8.1, make sure that you install the April 2016 release of Coveo for Sitecore for Sitecore 8.1.
Using a merge tool such as WinMerge, manually merge your customization from your disabled files into your new .config files.
If you also wanted to upgrade your Coveo for Sitecore version, follow the Upgrade Procedures for Coveo for Sitecore.
Rebuild your indexes (see Coveo for Sitecore Indexing Guide).