1. The Experience Edge Connector

Upgrade the Experience Edge Connector to version 20.0

Version:

If you are using Sitecore 10.2 or later, this topic explains how to upgrade the Experience Edge Connector from version 19.0 to version 20.0.

To upgrade the connector:

  1. In the Website root folder, locate the App_Config\Modules\ExperienceEdgeConnector\ExperienceEdgeConnector.config file, and back it up.

  2. In the same folder, disable all ExperienceEdgeConnector index config files by adding disabled to the file extension name, for example: ExperienceEdgeConnector.Search.config.disabled. You can remove the disabled file after completing the upgrade successfully.

  3. Open the App_Config\ConnectionStrings.config file, and change the connection string name from experienceedge.authority to experienceedge, and add details of the Experience Edge authorization credentials you were provided when you signed up, as shown in the following example. Replace the placeholders (AUTHORITY_URL_HERE, and so on) with the correct values for your subscription:

    <add name="experienceedge" connectionString="url=AUTHORITY_URL_HERE;client_id=CLIENT_ID_HERE;client_secret=CLIENT_SECRET_HERE;audience=AUDIENCE_HERE;delivery_endpoint=DELIVERY_ENDPOINT_HERE; cdn_uri=CDN_URI_HERE;media_prefix=MEDIA_PREFIX_HERE"/>
  4. Disable the Sitecore.ExperienceEdge.Connector.Search.dll file by adding disabled to the file extension name. You can remove the disabled file after completing the upgrade successfully.

  5. Install the Sitecore Experience Edge Connector version 20.0 on your Sitecore instance.

  6. In the Content Editor, go to /sitecore/system/Publishing targets.

  7. Add a publishing target item, set the value of its Target database field to experienceedge, and make sure the Publish to Experience Edge check box is selected.

  8. Perform a full site republish.

If you have suggestions for improving this article, let us know!