Giorgio Garcia-Agreda (MVP)

TroubleShooting Email Router in MS Dynamics CRM 4.0

Problema: Cliccando su CARICA DATI nel Configuration Manager dell’Email Router non è possibile collegarsi all’Organizzazione indicata nella Gestione Distribuzioni.

Scenario di Esempio:
3 Server: 1 Microsoft Dynamics CRM Server + Email Router, 1 Domain Controller, 1 SQL Server + Reporting Services.

1)      CRM Server è installato su porta di default dell’installazione (5555), è anche configurato un certificato Self-Signed per la connessione SSL su porta 443.

2)      Sul server “in locale” l’organizzazione di default è accessibile tramite URL
a.       http://servercrm:5555
b.      https://crm.mioserver.com (configurato un DNS Esterno) (facoltativo)

WORKAROUND:

1)      Database MSCRM_Config

Nel DB MSCRM_Config verificare nella tabella DeploymentProperties che siano rispettate le seguenti condizioni:

Nel caso non si avesse accesso “diretto” al SQL Server ma si è amministratori di macchina locale dove è installato il CRM Server allora è possibile utilizzare il MICROSOFT DYNAMICS CONFIGURATION TOOL:

“949079 (http://support.microsoft.com/kb/949079/ ) How to use the Microsoft Dynamics CRM Deployment Configuration tool for Microsoft Dynamics CRM 4.0”

Utilizzare poi da riga di comando le seguenti istruzioni:
- microsoft.crm.deploymentconfigtool.exe addresssettings update –sdkrootdomain:servercrm:5555
- microsoft.crm.deploymentconfigtool.exe addresssettings update -webapprootdomain:servercrm:5555

2)      “MICROSOFT CRM EMAIL ROUTER” Service:
Il Servizio dell’email router può essere eseguito con 3 diversi account: LOCAL SYSTEM, NETWORK Service ed un account “dedicato” che viene creato per motivi di sicurezza.
Può essere impostato l’account: LOCAL SYSTEM

3)      “MICROSOFT CRM ASYNCHRONUS PROCESSING”  (Servizio Elaborazione Eventi Asincroni di Microsoft CRM (ITA):
In caso di “Gestione Sicurezza” avanzata per il server SQL è opportuno creare un utente ad-hoc per il servizio in questione.
a.       Creare un utente che sia amministratore della macchina locale (utente di dominio membro del gruppo administrators del server dove è installato l’email Router)
b.      Assicurarsi che lo stesso utente abbia i permessi di dbdatareader e dbdatawriter sul server SQL ed in particolare sia per il database MSCRM_Config, sia per il database dell’organizzazione per la quale si vuole
gestire l’email router

4) L’utente che utilizza la Gestione Configurazione Router di Posta Elettronica per Microsoft Dynamics CRM deve appartenere al gruppo PRIVUSERGROUP creato da CRM durante l’installazione

5) Non è necessario che l’utente sia anche amministratore della distribuzione

6) Registro di Configurazione:

Verificare che in:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSCRM
La chiave ServerURL abbia il valore: http://servercrm:5555/MSCRMServices

In questo modo dovrebbe essere risolto il problema indicato.

CONSIDERAZIONI:
E’ molto utile fare alcune considerazioni di carattere “tecnico” e cioè:
Questi problemi legati all’email router si verificano frequentemente quando si ha a che fare con pubblicazioni IFD o con esposizione dell’organizzazione verso l’esterno (anche non in presenza di pubblicazione IFD). Questo perché probabilmente (come indicato all’inizio di questo articolo), si vuole raggiungere il server CRM con Autenticazione di Windows e magari anche su protocollo https.

a)      L’amministratore del Server CRM (ma anche quello della distribuzione) dovrebbe avere i permessi per accedere al Server SQL e ai database del CRM (Config + singole distribuzioni)

b)      La configurazione dei 2 servizi (Email Router e Asincrono) va fatta sin da un principio CORRETTAMENTE, per non imbattersi in ulteriori “inutili” problemi durante il deployment oppure durante l’utilizzo giornaliero da parte degli utenti

c)       E’ molto importante non sottovalutare il fatto che l’Email Router non si connette all’organizzazione, anche se tutto “sembra” funzionare, come invii e ricezione di posta elettronica sia per gli utenti che per le code. Infatti questo genera una moltitudine di errori nell’Event Viewer perlopiù sconosciuti o in ogni caso non riconducibili alla non corretta configurazione dell’Email Router.

Issue: Clicking on Load Data in the Email Router Configuration Manager receive an error that it’s impossible to connect to the Organization – The Event Viewer gives poor infos.

Example Scenario:
3 Server: 1 Microsoft Dynamics CRM Server + Email Router, 1 Domain Controller, 1 SQL Server + Reporting Services.

1)      CRM Server with default organization installed on default port (5555), it’s also installed ed configured a self-signed Certificate for SSL Connection on port 443.

2)      Locally, on Server, default organization is accesible with following URLs:
a.       http://servercrm:5555
b.      https://crm.myserver.com (External DNS Configured) (optional)

WORKAROUND:

1)      Database MSCRM_Config

In the DataBase MSCRM_Config verify that in the DeploymentProperties table will be following conditions:

In case the user could not access directly SQL Server (for security reasons) but he is an administrator of local machine where is installed CRM Server, it’s possible to use MICROSOFT DYNAMICS CONFIGURATION TOOL:

“949079 (http://support.microsoft.com/kb/949079/ ) How to use the Microsoft Dynamics CRM Deployment Configuration tool for Microsoft Dynamics CRM 4.0”

Then, from command line launch following instructions:
- microsoft.crm.deploymentconfigtool.exe addresssettings update –sdkrootdomain:servercrm:5555
- microsoft.crm.deploymentconfigtool.exe addresssettings update -webapprootdomain:servercrm:5555

2)      “MICROSOFT CRM EMAIL ROUTER” Service:
Email Router Service could be executed with 3 different accounts (better 3 types ): LOCAL SYSTEM, NETWORK Service or a dedicated account, created “ad-hoc” before for security reasoned.
It could be leaved the account LOCAL SYSTEM for this Service.

3)      “MICROSOFT CRM ASYNCHRONUS PROCESSING”:
In case of an adavanced Security Management of all infrastructure (and for SQL Server in particular) it’s useful to create an “ad-hoc” user for this service.
a.  Create a user that will be administrator of local machine (domain user member of Administrators Group on that Machine where is installed the Email Router)
b.  The same user must have DBDATAREADER and DBDATAWRITE Permissions on the SQL Server and in particular for MSCRM_Config and for the Organization’s Database which you would manage the email
configuration/distribution.

4) The user that runs the Email Router Configuration Manager must be a member of PRIVUSERGROUP, created by CRM during the installation (like the Computer that runs the Email Router)

5) Windows System Registry:

Verify that in:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSCRM
The Key ServerURL has the value: http://servercrm:5555/MSCRMServices

In this way the problem could be resolved.

CONSIDERATIONS:
It’s very useful making few “technical” considerations, in the detail:
Different issues connected to the email router configuration happen frequently overall when you are trying to configure IFD or if you would like to expose CRM Website on the Internet (without IFD): sometimes IT managers prefers not to use IFD and leave Windows Authentication also with encryption (SSL & htpps)

a)      The CRM Adminisitrator (but also the administrators of a specified organization) could have permission to access and manage the CRM Databases on SQL Server. (Config + single organizations)

b)      The exact configuration for 2 services (Email Router and Asynchronus) must be done CORRECTLY starting from the “second after” the completed installation of CRM Server

c)       It’s very important also to consider that sometimes the Email Router doesn’t connect to the organization, but at the same time, every “email fact”  are working correctly. It means that users can send and receive emails from CRM Platform, queues are working fine, but if you check in the Event Viewer, you could find a lot of errors that most of times are not related correctly to Email Router Issues.