Install and configure the Experience Edge Connector
This topic shows how you install and perform basic post-installation configuration of the Experience Edge Connector module.
To install and use this module, you must meet the following pre-requisites:
-
Sitecore Experience Management 10.1, or later
-
An active Sitecore Experience Edge subscription
You can also use SIF to install the module.
Install the Experience Edge Connector
To install the Sitecore Experience Edge connector:
-
Go to the Downloads page for Sitecore Headless Rendering, and choose the link for the package that is compatible with your version of XP.
-
Download the installation package for the Experience Edge Connector module.
-
In the Sitecore Launchpad, open the Control Panel, and in the Administration section, select Install a package.
-
Follow the steps in the installation wizard.
-
Before you close the wizard, select Restart the Sitecore Client and Restart the Sitecore Server.
Do not connect more than one Sitecore instance to an Edge instance.
Configure the Experience Edge Connector
Before you can use the connector module, you must configure:
-
The authorization credentials.
-
The API endpoint.
-
The Solr index.
To configure the authorization credentials:
-
In the
Website
root folder, open theApp_Config\ConnectionStrings.config
file. -
Add a new connection string with the name
experienceedge.authority
and set the value to the Experience Edge authorization credentials you have been provided with when you signed up:RequestResponseshell<add name="experienceedge.authority" connectionString="url=AUTHORITY_URL_HERE;client_id=CLIENT_ID_HERE;client_secret=CLIENT_SECRET_HERE;audience=AUDIENCE_HERE"/>
NoteReplace the placeholders (
AUTHORITY_URL_HERE
, and so on) with the correct values for your subscription.
To configure the Experience Edge API endpoint:
-
Create a patch file that specifies the value of the
ExperienceEdge.DeliveryEndpoint
configuration setting as the Experience Edge API endpoint you have been provided. The file you are patching is theApp_Config\Modules\ExperienceEdgeConnector\ExperienceEdgeConnector.config
file.
To configure the Experience Edge CDN URI:
-
Create a patch file that specifies the value of the
ExperienceEdge.CDN.Uri
configuration setting as the Experience Edge CDN URI you have been provided. The file you are patching is theApp_Config\Modules\ExperienceEdgeConnector\ExperienceEdgeConnector.config
file.
To configure the Experience Edge CDN media prefix:
-
Create a patch file that specifies the value of the
ExperienceEdge.CDN.MediaPrefix
configuration setting as the Experience Edge CDN media prefix you have been provided. The file you are patching is theApp_Config\Modules\ExperienceEdgeConnector\ExperienceEdgeConnector.config
file.
To configure the Solr index core, the connector uses:
-
Create a patch file that specifies the
core
parameter value under thesitecore_experienceedge_index
node as the same Solr core name used by thesitecore_master_index
index. The file you are patching is theApp_Config\Modules\ExperienceEdgeConnector\ ExperienceEdgeConnector.Search.Solr.Index.config
file.