Deployment region must be configured in Sitecore xDB Cloud


Description

Sitecore xDB Cloud used to provision a deployment to the nearest deployment region. This functionality has been deprecated, and the deployment region must now be configured using the new DeploymentRegion setting.

If you try connecting to xDB Cloud without specifying the deployment region, the following error may occur:

ERROR xDB Cloud - Exception during initializing occurred
Sitecore.Cloud.Xdb.Exceptions.RequestValidationFailedException: {"Message":"The setting for Sitecore.Cloud.Xdb.DeploymentRegion was not configured. Make sure you are using the latest version of Sitecore. Go to https://dev.sitecore.net/Downloads for the latest version of Sitecore, then specify the location setting in the Sitecore.Cloud.Xdb.config file."}
   at Sitecore.Cloud.Xdb.DiscoveryServiceClient.AssertStatusCodes(IRestResponse restResponse, String licenseId, String deploymentId)
   at Sitecore.Cloud.Xdb.DiscoveryServiceClient.PostXdbSet(String licenseId, String deploymentId, String sitecoreVersion, DeploymentType deploymentType)
   at Sitecore.Cloud.Xdb.DiscoveryServiceClient.<GetXdbSet>b__2()
   at Sitecore.Cloud.Xdb.Retryer.Execute(Action task, Func`2 stopOnException, String message, Int32 retryNum, TimeSpan retryInterval)
   at Sitecore.Cloud.Xdb.DiscoveryServiceClient.GetXdbSet()
   at Sitecore.Cloud.Xdb.UpdateXdbConnectionStrings.Process(PipelineArgs args)

If you are running an earlier version of Sitecore XP, ensure that the latest compatible update of xDB Cloud Client has been installed on your Sitecore Content Delivery and Content Management instances. Please refer to the xDB Cloud Service Compatibility Tables article to download the latest version.

Important: The DeploymentRegion setting has been introduced in:

Solution

To configure the deployment region, in the \App_Config\Include\XdbCloud\Sitecore.Cloud.Xdb.config file, set the Sitecore.Cloud.Xdb.DeploymentRegion setting to one of the supported values:

<setting name="Sitecore.Cloud.Xdb.DeploymentRegion" value="{region-name-here}" />

Sitecore xDB Cloud currently supports the following deployment regions: