Technology + People + Process

Install E-mail Router on multiple computers
Jul 21
2012

Install E-mail Router on multiple computers

Install E-mail Router on multiple computers

Install E-mail Router on multiple computers

You can deploy and run the Microsoft Dynamics CRM E-mail Router on multiple computers in a Microsoft cluster to provide high availability and failover functionality. In Windows Server 2003 this kind of server cluster is known as server clustering and in Windows Server 2008 it is known as failover clustering. Both of these server clustering technologies are supported with the E-mail Router.

To implement the minimum configuration for a cluster with failover capabilities, you must have the following hardware and configuration:

At least two nodes running Windows Server that support clustering.

A common storage I/O technology between the nodes in the cluster, such as Parallel SCSI or Fibre Channel.

The cluster configured in an active/passive manner.

Step 1: Establish the cluster

To install and configure the cluster

Install the minimum configuration of a two-node cluster with a shared disk.

Configure the cluster as active/passive. The E-mail Router does not support an active/active cluster deployment.

Step 2: Install the E-mail Router to the active primary node in the cluster

Install and configure the E-mail Router on the active primary node in the cluster

Run E-mail Router Setup on the active primary node in the cluster.

Start the E-mail Router Configuration on the first node and configure the E-mail Router. Verify that the E-mail Router is routing messages correctly.

Copy all E-mail Router application files to the common storage or shared hard disk. By default, the E-mail Router files are located at <drive:>\Program Files\Microsoft CRM Email.

The following files must be located on the common storage or shared disk so that they can be moved to the secondary node in the event of a failover:

Microsoft.Crm.Tools.EmailAgent.Configuration.bin

Microsoft.Crm.Tools.EmailAgent.SystemState.xml

Microsoft.Crm.Tools.EmailAgent.xml

Microsoft.Crm.Tools.Email.Management.config

EncryptionKey.xml

Update the following Windows registry subkey so that the E-mail Router will use the shared disk to load the E-mail Router settings:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\MSCRMEmail

To do this, change the ImagePath value to point to the common storage or shared disk drive where the E-mail Router files were copied.

Restart the “Microsoft CRM Email Router” service. To do this, on the Start menu, type services.msc, and then press ENTER; or click Run, type services.msc, and then press ENTER. In the services list, right-click the “Microsoft CRM Email Router” service, and then click Start. Close the Services application.

Step 3: Install the E-mail Router to the passive node in the cluster

Install and configure the E-mail Router on the passive secondary node in the cluster

Run E-mail Router Setup on the second node in the cluster.

Update the Windows registry subkey as in the previously performed steps on the primary node. Repeat these steps for each additional node in the cluster.

Restart the “Microsoft CRM Email Router” service. To do this, on the Start menu, type services.msc, and then press ENTER; or click Run, type services.msc, and then press ENTER. In the services list, right-click the “Microsoft CRM Email Router” service, and then click Start. Close the Services application.

Step 4: Create the generic resource service for the cluster

To create a generic service resource for the cluster

On each node in the cluster, start the Services MMC snap-in. In the list of services, right-click “Microsoft CRM Email Router,” click Properties, and then set Startup type to Manual. Close the Services MMC snap-in.

Start Active Directory Users and Computers. Locate the PrivUserGroup {GUID} security group for the deployment. Add the computer accounts for each node in the cluster. Close Active Directory Users and Computers.

If you are using Windows Server 2003, start Cluster Administrator or, if you are using Windows Server 2008, start Failover Cluster Manager, and create a generic service resource. Use the following parameters:

Name: Create a descriptive name for the generic service resource, such as MSCRM E-mail Router.

Resource type: Generic Service

Group: Cluster Group

Possible owners: Add all nodes in the cluster.

Dependencies: If you are using Microsoft Exchange Server and you have installed the E-mail Router on the Exchange Server (not recommended), add Exchange Server Information Store.

Service Name: Microsoft CRM Email Router

Start Parameters: Leave blank.

Use Network Name for Computer Name: Leave unchecked.

Do not checkpoint any Registry keys.

Bring the resource online. If necessary, configure the resource properties, such as the failover policies.

Close Cluster Administrator or Failover Cluster Manager.

For more information about how to create a generic service resource, see Checklist: Installing a Generic Service resource.

Step 5: Verify and monitor the cluster

During a failover of node 1 (the primary node), node 2 (the secondary node) will become the primary node and the common storage or shared disk resources described in “Step 2: Install the E-mail Router to the active primary node in the cluster” will move from node 1 to node 2. To test for failover, start Cluster Administrator or Failover Cluster Manager and force a failover.


Request for Quote

Drop us a line and we'll get in touch with you as quick as we can