THIS IS ARCHIVED DOCUMENTATION

Upgrading from November 2018 to February 2019

For the best Coveo for Sitecore experience, always follow the Best Practices When Upgrading Coveo for Sitecore.

This section describes how to upgrade Coveo for Sitecore 4.1 from the November 2018 to the February 2019 release.

Step 1: Upgrade Coveo Services

  1. Ensure that you have the latest version of Coveo Enterprise Search (CES 7.0.9434.6). If necessary, proceed as follows:

    1. Install the September 2018 release of Coveo Enterprise Search 7.0 x64 (7.0.9434) for Sitecore.

    2. Install the hotfix for the September 2018 release of Coveo Enterprise Search (CES 7.0.9434.6).

    Although you may refer to Upgrading CES for general instructions on how to upgrade CES, you must use the Coveo for Sitecore specific installation files which can be downloaded on the Coveo for Sitecore Downloads page.

  2. Ensure that you have installed the August 2017 release of the Coveo Search API (8.0.1168).

Step 2: Upgrade Coveo for Sitecore

Ensure that the Microsoft MVC security update MS14-059 is installed on every Sitecore host in your environment.

If you’re using the Coveo Admin Service in secure mode, read this notice before installing the package.

In the Coveo.SearchProvider.config file, make sure that the AdminServiceUri value uses the same host name as the one specified in the certificate. If you’re using a different host name, 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'.]
  1. Log into the Sitecore Desktop.

  2. Access the Installation Wizard (Sitecore Start Menu > Development Tools > Installation Wizard).

  3. Install the Coveo for Sitecore .zip package.

  4. When prompted to overwrite files, click Yes to all.

  5. When prompted to overwrite items, select Overwrite, then click Apply to all.

    You might be prompted twice with this question. Select the Overwrite option and click Apply to all both times.

  6. Once the installation is completed, make sure that you restart both the Sitecore client and server.

Step 3: Delete Two Configuration Files From the \Modules\Coveo Folder

Sitecore 9

The following configuration files have been moved from the <SITECORE_INSTANCE_ROOT>\App_Config\Modules\Coveo folder to the new <SITECORE_INSTANCE_ROOT>\App_Config\Modules\Coveo\Analytics folder:

  • Coveo.Analytics.XConnect.config.disabled

  • Coveo.Analytics.xDB.config

When upgrading, these two files you already had in the <SITECORE_INSTANCE_ROOT>\App_Config\Modules\Coveo folder won’t be deleted automatically. You must therefore delete the Coveo.Analytics.XConnect.config.disabled and Coveo.Analytics.xDB.config files located in the <SITECORE_INSTANCE_ROOT>\App_Config\Modules\Coveo folder so that only the ones in the new <SITECORE_INSTANCE_ROOT>\App_Config\Modules\Coveo\Analytics folder remain.

Step 4: Publish Your Site

In the Sitecore Content Editor, perform a publish site action. This ensures any changes related to Coveo components in the upgrade are published to the web database.

Step 1: Upgrade Coveo for Sitecore

Ensure that the Microsoft MVC security update MS14-059 is installed on every Sitecore host in your environment.

  1. Log into the Sitecore Desktop.

  2. Access the Installation Wizard (Sitecore Start Menu > Development Tools > Installation Wizard).

  3. Install the Coveo for Sitecore .zip package.

  4. When prompted to overwrite files, click Yes to all.

  5. When prompted to overwrite items, select Overwrite, then click Apply to all.

    You might be prompted twice with this question. Select the Overwrite option and click Apply to all both times.

  6. Once the installation is completed, make sure that you restart both the Sitecore client and server.

Step 2: Delete Two Configuration Files From the \Modules\Coveo Folder

Sitecore 9

The following configuration files have been moved from the <SITECORE_INSTANCE_ROOT>\App_Config\Modules\Coveo folder to the new <SITECORE_INSTANCE_ROOT>\App_Config\Modules\Coveo\Analytics folder:

  • Coveo.Analytics.XConnect.config.disabled

  • Coveo.Analytics.xDB.config

When upgrading, these two files you already had in the <SITECORE_INSTANCE_ROOT>\App_Config\Modules\Coveo folder won’t be deleted automatically. You must therefore delete the Coveo.Analytics.XConnect.config.disabled and Coveo.Analytics.xDB.config files located in the <SITECORE_INSTANCE_ROOT>\App_Config\Modules\Coveo folder so that only the ones in the new <SITECORE_INSTANCE_ROOT>\App_Config\Modules\Coveo\Analytics folder remain.

Step 3: Publish Your Site

In the Sitecore Content Editor, perform a publish site action. This ensures any changes related to Coveo components in the upgrade are published to the web database.