Platform Administration and Architecture

EXM Dispatch

Abstract

Introduction to 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

The EXM Dispatch role can be hosted on:

Refer to the Sitecore compatibility table for compatible versions.

References

The EXM Dispatch role references the following application roles, storage roles, and indexes.

exm-dispatch.png

Storage roles

Role name

Connection string name

Port

Type

Notes

Master database

master

1433

SQL

Core database

core

1433

SQL

Message Bus

messaging

1433

SQL

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

433

Azure Service Bus

EXM database

exm.master

1433

SQL

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

Search indexes

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

Note

Lucene is recommended for developer environments only. Not recommended or supported in a production environment.

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:

Other

The EXM Dispatch role includes a reference to the Package Management Service via the PackageManagementServiceUrl connection string.

Cloud Services

Role Name

Port

Type

Endpoint URL

E-mail Cloud

443

HTTPS

Multiple endpoints

For more information, see:

Referenced by

The role is referenced by:

Scaling

Multiple EXM Dispatch roles can be set up to speed up the message generation and sending process.

For more information see Using dedicated email dispatch servers.

Supported combinations

The EXM Dispatch role should be dedicated to dispatching emails, however it must be combined with the Content Management role. This combined role can then be used as a fail-over Content Management role.

Security and privacy

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