Configure a dedicated email dispatch server

Last updated Friday, August 24, 2018 in Email Experience Manager for Administrator, Developer

Dedicated EXM servers generate messages in the same way as the primary server does. This allows you to speed up the message generation and sending process. You can install one or more dedicated email dispatch servers depending on your typical dispatch scenario and deployment environment. All servers share the same databases.

To configure a dedicated server:

  1. On the dedicated server, install Sitecore Experience Platform and configure it as a basic Content Management server. Ensure to enable the interaction registry. You can combine it with other server roles as needed.
  2. In the Web.config file, in the <appSettings> section, add DedicatedDispatch as a role. For example:
    <add key="role:define" value="ContentManagement, DedicatedDispatch" />
  3. On the primary CM server, in the Sitecore.EmailExperience.ContentManagementPrimary.config file, in the <DedicatedServers> section, enter the address of the dedicated server. For example:
    <DedicatedServers>
       <address value=" http://dedicated.server " />
    </DedicatedServers>

    Note

    If you enter the IP address of the dedicated server in the address setting (for instance: <address value="http://10.38.41.24" />), then on the dedicated server, Sitecore must run on the default web site.

  4. On the primary CM server, in the \App_Config\ConnectionStrings.config file, add the EXM.DedicatedDispatchService connection string, for example:
    <add name="EXM.DedicatedDispatchService" connectionString="/sitecore%20modules/web/exm/dedicateddispatchservice.asmx" />
  5. On all the content management servers in your scaled environment, in the \App_Config\ConnectionStrings.config file, add the EXM.InternalApiKey connection string, for example:
    <add name="EXM.InternalApiKey" connectionString="0x0000000000000000000000000000000000000000000000000000000000000000" />

    Note

    The format of the connection string value is represented by a 64-character hexadecimal format. The connection string value above is just an example and should not be used.

    You have now configured the dedicated server. You can configure several dedicated servers using this procedure.

When you start the dispatch process on the primary CM server, the same process starts on the dedicated servers. As long as there are subscribers left in the list in the EXM dispatch queue, each server accesses the list, takes some of the remaining subscribers, generates the message for them, and passes the message to the message transfer agent configured for this server.

Tip

You can use the Sleep setting in the SendEmail pipeline to balance the load between the primary CM server and the dedicated servers.

Send feedback about the documentation to docsite@sitecore.net.