EXM Dispatch

Abstract

Overview of Sitecore EXM Dispatch supported infrastructure, references, scaling, and security and privacy.

The EXM Dispatch role is a Core role that has been configured to generate emails and dispatching them to the email message transfer agent (MTA).

Note

The EXM Dispatch role cannot run as a standalone role but must be combined with the Content Management role.

Supported infrastructure

You can host the EXM Dispatch role on:

Refer to the Sitecore compatibility table for compatible versions.

Reference structure

The EXM Dispatch role has its place in the Sitecore reference structure. It can be referenced by other roles, and it can also reference other roles.

Illustration showing the EXM Dispatch role's place in the Sitecore reference structure.

Referenced by

The EXM Dispatch role is referenced by the following roles:

References

The EXM Dispatch role references the following roles:

Storage roles

Role name

Connection string name

Port

Type

Notes

Master database

master

1433

SQL

Core database

core

1433

SQL

Security database

Message Bus

messaging

1433

SQL

In Sitecore version 9.2, you can choose to use SQL or the Azure Service Bus.

443

Azure Service Bus

EXM database

exm.master

1433

SQL

On-premise application roles

Role name

Connection string name

Port

Type

Notes

xConnect Collection Search service

xconnect.collection

443

HTTPS

The xConnect Collection Search service acts as a xConnect Collection service for the role

Reference Data service

xdb.referencedata.client

443

HTTPS

Authoring

N/A - see notes

5000

HTTPS

Service url is configured in the <content management root>\App_ConfigIncludeY.Commerce.Engine\ Sitecore.Commerce.Engine.Connect.config

The following client certificates are required in a secure production environment:

Role

Connection string name

Type

Notes

xConnect Collection service

xconnect.collection.certificate

Certificate

Reference Data service

xdb.referencedata.client.certificate

Certificate

Azure application roles

On XP1 topologies deployed on Azure, the xConnect Collection Search service has a dedicated connection string. This is to separate the collection requests from the search and indexing requests. The xConnect Collection Search service is hosted under a basic hosting plan which might not have enough resources for collection, search, and indexing requests.

Role name

Connection string name

Port

Type

Notes

xConnect Collection service

xconnect.collection

443

HTTPS

Hosted on a resource intensive plan.

xConnect Collection Search service

xconnect.search

443

HTTPS

Hosted on a basic plan.

Reference Data service

xdb.referencedata.client

443

HTTPS

Authoring

N/A - see notes

5000

HTTPS

Service url is configured in the <content management root>\App_ConfigIncludeY.Commerce.Engine\ Sitecore.Commerce.Engine.Connect.config

The following client certificates are required in a secure production environment:

Role

Connection string name

Type

Notes

xConnect Collection service

xconnect.collection.certificate

Certificate

xConnect Collection Search service

xconnect.search.certificate

Certificate

Reference Data service

xdb.referencedata.client.certificate

Certificate

Search indexes

The Content Search provider determines how the Content Delivery role connects to the indexes. Sitecore supports Azure Search and Solr.

Index

Port, Solr

Port, Azure Search

Type

Notes

Master index

8983

443

HTTPS

Core index

8983

443

HTTPS

Master Marketing Definitions index

8983

443

HTTPS

Master Marketing Assets index

8983

443

HTTPS

For more information, see:

Cloud Services

Role Name

Port

Type

Endpoint URL

E-mail Cloud

443

HTTPS

Multiple endpoints

For more information, see:

Security and privacy

The EXM Dispatch role handles personal data in the following ways: