---
title: May 17, 2019 release (5.0.387.10)
slug: '2875'
canonical_url: https://docs.coveo.com/en/2875/
collection: coveo-for-sitecore-v5
source_format: adoc
---
# May 17, 2019 release (5.0.387.10)
> **Important**
>
> Per the Coveo [Version Support Lifecycle policy](https://docs.coveo.com/en/1485.md), this Coveo for Sitecore 5 release has reached end of support.
> See [available Coveo for Sitecore releases](https://docs.coveo.com/en/2274.md).
>
> Even if this release is no longer supported, you must still perform some of its [upgrade steps](#upgrade-steps) to [upgrade to a more recent version](https://docs.coveo.com/en/2155.md#multi-release-upgrade) of Coveo for Sitecore.
> Even if this release is no longer supported, you must still perform some of its upgrade steps to [upgrade to a more recent version](https://docs.coveo.com/en/2155.md#multi-release-upgrade) of Coveo for Sitecore.
This release includes the 2.5926.10 version of the JavaScript Search Framework (see [April 2019 Release (v2.5926.10)]({{ site.baseurl }}/3277#april-2019-release-v25926)).
When using a CDN with the Coveo Hive Framework, this release includes the latest 2.5926 version of the JavaScript Search Framework (see [Choosing between local and CDN Coveo JavaScript resource files]({{ site.baseurl }}/2629/)).
Release Notes
This section summarizes the new features and fixed support cases introduced in the Coveo for Sitecore May 17, 2019 release (5.0.387.10).
Upgrade Steps
> **Important**
>
> Per the Coveo [Version Support Lifecycle policy](https://docs.coveo.com/en/1485.md), this Coveo for Sitecore 5 release has reached end of support.
> See [available Coveo for Sitecore releases](https://docs.coveo.com/en/2274.md).
>
> Even if this release is no longer supported, you must still perform some of its [upgrade steps](#upgrade-steps) to [upgrade to a more recent version](https://docs.coveo.com/en/2155.md#multi-release-upgrade) of Coveo for Sitecore.
> Even if this release is no longer supported, you must still perform some of its upgrade steps to [upgrade to a more recent version](https://docs.coveo.com/en/2155.md#multi-release-upgrade) of Coveo for Sitecore.
This section describes how to upgrade Coveo for Sitecore from April 18, 2019 (5.0.362.4) to May 17, 2019 (5.0.387.10). If you're upgrading over multiple versions, Coveo has a [procedure]({{ site.baseurl }}/2155#multi-release-upgrade) to streamline the process.
> **Important**
>
> For the best Coveo for Sitecore experience, always follow the [upgrading leading practices](https://docs.coveo.com/en/2155.md).
Step 1: Upgrade Coveo for Sitecore
> **Important**
>
> Make sure the Microsoft MVC security update [MS14-059](https://docs.microsoft.com/en-us/security-updates/SecurityBulletins/2014/ms14-059) is installed on every Sitecore host in your environment.
- Log in to the Sitecore Desktop.
- Access the Installation Wizard (**Sitecore Start Menu** > **Development Tools** > **Installation Wizard**).
- Upload and install the `Coveo for Sitecore XX 5.0.387.10` package.
- When prompted to overwrite files, click **Yes to all**.
- When prompted to overwrite items, select **Overwrite**, then click **Apply to all**.
> **Note**
>
> You might be prompted twice with this question.
> Select the **Overwrite** option and click **Apply to all** both times.
- Once the installation is completed, make sure that you restart both the Sitecore client and server.
Step 2: Manually Update the Coveo Configuration Files
The Coveo configuration files are located in the `Website\App_Config\Include\Coveo` folder. When upgrading, you must compare the changes to the `.example` files from your current Coveo for Sitecore version with the ones in the build you're upgrading to. Then, you can merge these changes 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](http://winmerge.org/) to accomplish this.
In further detail, here are the modifications that you must perform to the configuration files resulting from the feature changes between the previous and current Coveo for Sitecore releases:
Coveo.Authentication.config
The modification below only pertains to Sitecore 9.1 instances.
The following line:
`<site patch:before="*[1]" name="coveoapi" virtualFolder="/coveo" physicalFolder="/coveo" enableTracking="false" content="master" domain="sitecore" set:loginPage="$(loginPath)shell/SitecoreIdentityServer" />
`
has been changed to:
`<site patch:before="*[1]" name="coveoapi" virtualFolder="/coveo" physicalFolder="/coveo" enableTracking="false" content="master" domain="sitecore" set:loginPage="$(loginPath)shell/SitecoreIdentityServer">
<patch:attribute role:require="ContentDelivery" name="content">web</patch:attribute>
</site>
`
The modification below only pertains to Sitecore 9.1 instances.
The `<site name="coveoapi"` element has been moved to become the first child of the `<sites>` element. Comments regarding the `<site name="coveoapi"` and `<site name="coveorest"` elements have been changed accordingly.
When combined, the result of the two Sitecore 9.1 changes above on the `<sites>` element is the following:
`<sites>
<!-- The site coveoapi needs to be inserted as the first element, or before any other sites that have the coveoapi site as a child (for example, sites defined with virtualpath="/coveo*"). -->
<site patch:before="*[1]" name="coveoapi" virtualFolder="/coveo" physicalFolder="/coveo" enableTracking="false" content="master" domain="sitecore" set:loginPage="$(loginPath)shell/SitecoreIdentityServer">
<patch:attribute role:require="ContentDelivery" name="content">web</patch:attribute>
</site>
<!-- The site coveorest needs to be inserted before any other sites that have the coveorest site as a child (for example, sites defined with virtualpath="/coveo/rest*"). -->
<site patch:before="*[1]" name="coveorest" virtualFolder="/coveo/rest" physicalFolder="/coveo/rest" enableTracking="false" database="web" domain="extranet" />
<!-- The site coveoanalytics needs to be inserted before coveorest, as it requires analytics to be enabled. -->
<!-- The coveoanalytics website database attribute value should match the published website database attribute value to allow Coveo Usage Analytics logging. -->
<site patch:before="*[1]" name="coveoanalytics" virtualFolder="/coveo/rest/v6/analytics" enableTracking="true" database="web" domain="extranet" />
<site patch:before="*[1]" name="coveo_website" virtualFolder="/sitecore modules/Web/Coveo" physicalFolder="/sitecore modules/Web/Coveo" rootPath="/sitecore/content" startItem="/home" language="en" content="web" domain="sitecore" loginPage="/identity/login/admin/SitecoreIdentityServer" />
</sites>
`
The modification below only pertains to Sitecore 9.1 instances.
The following block has been added inside the `<sitecore>` element.
`<settings>
<setting name="Coveo.Framework.DatabasePropertyName" value="web" />
</settings>
`
The modification below pertains to all Sitecore versions except Sitecore 9.1.
The comment line regarding the `<site name="coveorest"` element has been changed from:
`<!-- The site coveorest needs to be inserted as the first element, or before any other sites that have the coveorest site as a child (for example, sites defined with virtualpath="/"). -->
`
to:
`<!-- The site coveorest needs to be inserted as the first element, or before any other sites that have the coveorest site as a child (for example, sites defined with virtualpath="/coveo/rest*"). -->
`
Coveo.SearchProvider.config
The modification below only pertains to Sitecore 9.1 instances.
The `databasePropertyStore/Database` element has been changed from
`<Database>core</Database>
`
to
`<Database>web</Database>
`
Coveo.SearchProvider.Custom.config
If you have Sitecore 9, the `<configuration>` element has been changed from
`<configuration xmlns:patch="http://www.sitecore.net/xmlconfig/" xmlns:coveo="http://www.sitecore.net/xmlconfig/coveo/">
`
to
`<configuration xmlns:patch="http://www.sitecore.net/xmlconfig/" xmlns:role="http://www.sitecore.net/xmlconfig/role/" xmlns:coveo="http://www.sitecore.net/xmlconfig/coveo/">
`
If you have Sitecore 9, the `<index id="Coveo_master_index">` element has been changed to
`<index role:require="!ContentDelivery" id="Coveo_master_index">
`
Step 3: Regenerate and Save your Encryption Key
Sitecore 9.1
For Sitecore 9.1 instances only, you must regenerate and save your encryption key in the `web` database and subsequently copy your new configurations across your instances.
- On your **CM**, regenerate your API keys by using the **Command Center** (see [Modifying Your Coveo Organization]({{ site.baseurl }}/2572#modifying-your-coveo-organization)). Select the same organization than previously configured.
- Regenerate your Sitecore Credentials using the `Security` panel of the **Command Center** (see [Understanding the Indexing Manager - Security]({{ site.baseurl }}/2566#security)). Re-enter the credentials, and click `Apply and Restart`.
- Copy the configuration files (see [Deploy Coveo for Sitecore on the Content Delivery Servers - Copying the Configuration Files]({{ site.baseurl }}/2264#step-3-copying-the-configuration-files)).
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.
---
[〈{nbsp}{nbsp}Previous version upgrade steps,role="float-start btn home-outline-btn d-inline-flex px-150 mt-100"](https://docs.coveo.com/en/2847.md#step-2-manually-update-the-coveo-configuration-files)
[Next version upgrade steps{nbsp}{nbsp}〉,role="float-end btn home-outline-btn d-inline-flex px-150 mt-100"](https://docs.coveo.com/en/2904.md#step-2-delete-coveo-for-sitecore-legacy-ui-items)
{nbsp}
{nbsp}
{nbsp}