Installing Coveo for Sitecore 4.1
- Coveo recommends that you upgrade at least to the September 2017 (4.0.1536.6) release of Coveo for Sitecore 4.0 before migrating to the September 2017 (184.108.40.206) release of Coveo for Sitecore 4.1.
- The Leading Practices When Upgrading Coveo for Sitecore also apply to a migration to Coveo for Sitecore 4.1.
Upgrade Coveo Services
If you upgrade to Coveo for Sitecore On-Premises, you will need to upgrade Coveo Enterprise Search (CES) and the Coveo Search API.You are encouraged to first upgrade your Coveo for Sitecore 4.0 to the version that uses the same CES and Search API version as the Coveo for Sitecore 4.1 release that you plan to install.
Upgrade Coveo Enterprise Search (CES). For more details, see Upgrading CES.
Upgrade Coveo Search API. Follow the normal steps of the installation wizard.
Prepare your Sitecore Instance
Disable all the Coveo for Sitecore configuration files.
- In the
.disabledat the end of the following
Sitecore 7.5 In the
.disabledat the end of the
- Sitecore 7.5
.disabledat the end of the
Upgrade Coveo for Sitecore
If you are using the Coveo Admin Service in secure mode, read this notice before installing the package.
Coveo.SearchProvider.config file, make sure that the
adminServiceUri value uses the same hostname as the one specified in the certificate. If you are using a different hostname, such as
localhost, you might get the error below when installing the package.
The remote certificate is invalid according to the validation procedure. ... [WebException: The underlying connection was closed: Could not establish trust relationship for the SSL/TLS secure channel.] ... [SecurityNegotiationException: Could not establish trust relationship for the SSL/TLS secure channel with authority 'localhost'.]
Log into the Sitecore Desktop.
- Access the Installation Wizard (Sitecore Start Menu > Development Tools > Installation Wizard).
- Upload and install the
Coveo for Sitecore XX 4.1 (YYY).zippackage.
- When prompted to overwrite files, click Yes to all.
When prompted to overwrite items, select Overwrite, then click Apply to all.
You might be prompted twice with this question. Simply select the Overwrite option and click Apply to all both times.
You may get the following message. Simply select Continue Always.
Role 'sitecore\Coveo Admin' will not be installed since it already exists.
Follow the instructions of the Post Installation Wizard. This will configure certain mandatory settings in the configuration files. For more information, see Installing Coveo for Sitecore.
Once the installation is completed, make sure that you restart both the Sitecore client and server.
Rebuild your Indexes
Once your client and server are up and running, you should rebuild your indexes (see Coveo for Sitecore Indexing Guide).
Not doing so will result in the duplication of your index items.
Merging Your Modifications into the Configuration Files
Since upgrading Coveo for Sitecore updates the Coveo configuration files with the latest fixes and enhancements, you need to manually merge these modifications into your current configuration files. This method allows you to keep your own customization intact, while still benefiting from the latest enhancements brought in the product. You can use a merge tool such as WinMerge to do that.
To see the list of modifications that you should perform, see Upgrading Configuration Files from Coveo for Sitecore 4.0 to Coveo for Sitecore 4.1.