Upgrade the E-mail Router
To upgrade your installation of the E-mail Router from Microsoft Dynamics CRM 4.0 to Microsoft Dynamics CRM 2011, you first back up the state files that are used by the E-mail Router, and then install the E-mail Router. Follow the steps in the following tasks:
Upgrade Task 1: Back up and use E-mail Router state files and Smart Matching settings. For more information, see “Back up and use E-mail Router state files” below.
Upgrade Task 2: Install the Microsoft Dynamics CRM 2011 E-mail Router. For more information, see “Upgrade the E-mail Router to Microsoft Dynamics CRM 2011” below.
In This Topic
Upgrading both the E-mail Router and Microsoft Dynamics CRM
Back up and use E-mail Router state files and Smart Matching settings
Upgrade the E-mail Router to Microsoft Dynamics CRM 2011
Upgrading both the E-mail Router and Microsoft Dynamics CRM
If you plan to upgrade both the E-mail Router and Microsoft Dynamics CRM, perform the upgrade tasks in the following order:
Stop the Microsoft Dynamics CRM E-mail 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. Right-click the Microsoft Dynamics CRM E-mail Router service, and then click Stop.
Upgrade Microsoft Dynamics CRM 4.0 Server to Microsoft Dynamics CRM Server 2011. For more information, see Upgrade from Microsoft Dynamics CRM 4.0 in the Microsoft Dynamics CRM 2011 Installing Guide.
Install the Microsoft Dynamics CRM 2011 E-mail Router:
If you already have the Microsoft Dynamics CRM 4.0 E-mail Router installed, upgrade to the Microsoft Dynamics CRM 2011 E-mail Router, as described below.
If you do not have the Microsoft Dynamics CRM 4.0 E-mail Router installed, install the Microsoft Dynamics CRM 2011 E-mail Router, as described in Install E-mail Router and Rule Deployment Wizard in the Microsoft Dynamics CRM 2011 Installing Guide.
You might need to restart the Microsoft Dynamics CRM E-mail Router service after the upgrade to the Microsoft Dynamics CRM 2011 E-mail Router finishes. To do this, in the services list, right-click Microsoft Dynamics CRM E-mail Router, and then click Start.
Back up and use E-mail Router state files and Smart Matching settings
We recommend that you back up the files that store the state of your E-mail Router before you upgrade to the Microsoft Dynamics CRM 2011 E-mail Router. The following steps describe how to back up and use these files to recover from a failed upgrade to the next version of the E-mail Router.
To back up and use E-mail Router state files
Locate the following files in the folder <drive:>\Program Files\Microsoft CRM Email\Service\:
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
Copy these files to a safe location.
If you have modified the smart matching email correlation settings that are located in the HKEY_LOCAL_MACHINE\Software\Microsoft\MSCRM Windows Registry, you must add the effective change in the System Settings area of the Microsoft Dynamics CRM 2011 application. The smart matching settings are no longer maintained in the Windows Registry and must be modified in the application. For more information about how to change smart matching settings in Microsoft Dynamics CRM 2011, see the Microsoft Dynamics CRM Help. The subkey names and default values are:
HashFilterKeywords. ^[\s]*([\w]+\s?:[\s]*)+
HashMaxCount. 20
HashDeltaSubjectCount. 0
HashMinAddressCount. 2
Perform the upgrade to Microsoft Dynamics CRM 2011 E-mail Router. For more information, see the following procedure, "To upgrade the E-mail Router on a server named EXBE01" below.
If the E-mail Router upgrade succeeds, you can discard the backup files and exit this procedure. If the E-mail Router upgrade fails, continue with the following procedure.
If the upgrade fails
If the upgrade fails, you have to uninstall the E-mail Router. For more information, see Uninstall, change, or repair E-mail Router in the Microsoft Dynamics CRM 2011 Installing Guide.
Reinstall the Microsoft Dynamics CRM 4.0 E-mail Router.
Reinstall all of the Microsoft Dynamics CRM update rollups that were installed before you attempted this upgrade. For more information, see Microsoft Dynamics CRM 4.0 updates and hotfixes.
Note
If you previously installed Microsoft Dynamics CRM 2011 Update Rollup 7 or later, you need not reinstall any of the individual Microsoft Dynamics CRM update rollups that preceded Microsoft Dynamics CRM 2011 Update Rollup 7. Instead, reinstall Microsoft Dynamics CRM 2011 Update Rollup 7 and then reinstall the latest Microsoft Dynamics CRM update rollup (such as Microsoft Dynamics CRM 2011 Update Rollup 9) that had been installed before you attempted to upgrade the E-mail Router.
Stop the E-mail Router service. For more information, see "To stop a service," in Incoming e-mail configuration issues in the Microsoft Dynamics CRM 2011 Installing Guide.
Copy the backed-up files to the installation location of Microsoft Dynamics CRM 4.0 E-mail Router. (This might be the original installation location: <drive>:\Program Files\Microsoft CRM Email\Service.)
Start the E-mail Router service. For more information, see "To start a service," in Incoming e-mail configuration issues in the Microsoft Dynamics CRM 2011 Installing Guide.
Upgrade the E-mail Router to Microsoft Dynamics CRM 2011
To upgrade the E-mail Router on a server named EXBE01
Meet the E-mail Router requirements specified in Microsoft Dynamics CRM E-mail Router hardware requirements and in Microsoft Dynamics CRM E-mail Router software requirements.
Log on to EXBE01 as a Domain User with Local Administrator privileges.
Obtain and run the appropriate installation files.
To install from a network or from a DVD: Open the appropriate installation folder (EmailRouter\amd64 or EmailRouter\i386) and then run the SetupEmailRouter.exe file. (To install on a 64-bit computer, use the Setup file in the EmailRouter\amd64 folder; to install on a 32-bit computer, use the Setup file in the EmailRouter\i386 folder.)
To install from the web, open the download page (Microsoft Dynamics CRM 2011) and then download and run the executable file.
Note
The download site may present you with a choice of executable files. If you are installing on a 64-bit computer, choose a file with a name such as DynamicsCRMEmail_1033_amd64.exe. For a 32-bit computer, the file name is similar to DynamicsCRMEmail_1033_i386.exe.
If a Security Warning dialog box appears, click Run.
On the Welcome to Microsoft Dynamics CRM 2011 E-mail Router setup page, select whether you want to update E-mail Router setup. We recommend that you click Get updates for Microsoft Dynamics CRM. Then, click Next.
On the License Agreement page, review the information and if you accept the license agreement, click I accept this license agreement, and then click I Accept.
On the Select Router Components page, click Next.
The System Checks page appears. This page is a summary of all system requirements for a successful E-mail Router installation. Verification errors must be corrected before the installation can continue. If there is a problem that will take time to correct, cancel Setup at this point, fix the problem, and restart Setup. When no verification errors remain, click Next.
The Ready to Upgrade page appears. Review the installation selections that you have made. Click Back to change your selections, or Upgrade to upgrade the E-mail Router now.
After E-mail Router Setup is finished, click Finish.
Your configuration settings from the previous installation have been retained. To change configuration settings, run the E-mail Router Configuration Manager. For more information, see Configure the E-mail Router in the Microsoft Dynamics CRM 2011 Installing Guide.
See Also
Concepts
Install E-mail Router and Rule Deployment Wizard
Configure the E-mail Router