How to obtain and use the CRMADRecovery tool in Microsoft CRM 1.2 (893106)

MORE INFORMATION

Support Policy

Microsoft Product Support Services does not provide support or software updates for this tool. This tool is only available in English.

Obtaining and installing the tool

This tool is available from Microsoft, but it is only intended to address the problems that are described in the "Introduction" section. Use this tool only when you are experiencing these problems.

To obtain this tool, contact Microsoft Product Support Services. For a complete list of Microsoft Product Support Services telephone numbers, and for information about support costs, visit the following Microsoft Web site:Note In special cases, charges that are ordinarily incurred for support calls may be canceled if a Microsoft Support Professional determines that a specific update will resolve your problem. The usual support costs will apply to additional support questions and problems that do not qualify for the specific update in question.

Installation information

Install this tool on computers that are running Microsoft CRM 1.2 Server.

Prerequisites

To install this tool, you must have installed Microsoft CRM version 1.2.

Removal information

To remove this hotfix from a computer that is running Microsoft Windows 2000, Microsoft Windows XP, or Microsoft Windows Server 2003, use Add or Remove Programs in Control Panel.

System administrators may use the Spunist.exe utility to remove this hotfix from a computer that is running Windows 2000, Windows XP, or Windows Server 2003. The Spuninst.exe utility is located in the following folder:For more information about how to use a package installer to remove a hotfix, see the following article in the Microsoft Knowledge Base:

Restart requirement

If you are prompted, restart the computer after you install the tool.

File information

The English version of this hotfix has the file attributes (or later file attributes) that are listed in the following table. The dates and times for these files are listed in coordinated universal time (UTC). When you view the file information, it is converted to local time. To find the difference between UTC and local time, use the Time Zone tab in the Date and Time tool in Control Panel.

   Date         Time   Version         Size   File name
   -----------------------------------------------------------
   07-Apr-2005  22:42  1.2.3297.147  31,464  Crmadrecovery.exe  

Preparing to use the tool

Before you use the tool, perform a complete backup of the following:

• The Microsoft CRM databases
• The Microsoft CRM organizational unit
• The user accounts in Active Directory that also exist as Microsoft CRM user accounts

Note The organizational unit and the user accounts in Active Directory will be backed up by the system state backup from one of the domain controllers that contain the Microsoft CRM Server and Microsoft CRM Users.

For more information about backing up Microsoft CRM user information, see Chapter 10, "Backing Up and Restoring your Microsoft CRM System," in the Microsoft CRM 1.2 Implementation Guide.

Using the tool

Follow these steps to use the CRMADRecovery tool:

1. Log on to the Microsoft CRM Server as a user who has at a minimum read and write and change privileges to the Microsoft CRM organizational unit (OU) in Active Directory and permissions to access the Microsoft CRM Databases. This is typically accomplished by running the CRMADRecovery tool as the user who installed the Microsoft CRM application.
2. Install Crmadrecovery.exe on Microsoft CRM Server.
   Note The default installation path is: C:\Program Files\Microsoft CRM\Server\Bin.
3. Click Start, click Run, type cmd, and then click OK.
4. Change the directory to point to the C drive. To do this, type C:, and then press ENTER.
5. To access the directory that contains the CRMADRecovery program, type CD Program Files\Microsoft CRM\Server\Bin, and then press ENTER.
   Note The default installation path is: C:\Program Files\Microsoft CRM\Server\Bin. If you have installed Crmadrecovery.exe program to a different directory, you must replace Program Files\Microsoft CRM\Server\Bin in this step with the actual directory to which you have installed.
6. Type crmadrecovery.exe -d > crmadrecovery_diagnosis.txt, and then press ENTER.
   Notes
   • This step will create a text file named CRMADRECOVERY_diagnosis.txt that will list every Microsoft CRM Security role that exists in the Microsoft CRM application, starting at the root business unit level. For a Security role that is set up correctly, Good!!! will be listed at the start of every entry. If errors are found, Error will be listed with a short description of the Security role and what is wrong with the role.
   • If no errors are found, you do not have to continue. If errors are found, follow the next steps to run this tool in recovery mode.
7. Back up the Microsoft CRM databases and the Active Directory. For comprehensive instructions, see Chapter 10, "Backing Up and Restoring your Microsoft CRM System," of the Microsoft CRM 1.2 Implementation Guide.
8. Type crmadrecovery.exe -r > crmadrecovery_recovery.txt, and then press ENTER to run CRMADRecovery in recovery mode. CRMADRecovery will try to fix the problems that it finds by using the role and business unit information found in the MSCRM database and correcting the Active Directory security groups.
   Note CRMADRecovery will try to fix any errors found and will log the errors to the text file named Crmadrecovery_recovery.txt. CRMADRecovery will log both the successes and the failures that occurred in trying to fix those errors.

For more information about the terminology that is used to describe Microsoft product updates, click the following article numbers to view the articles in the Microsoft Knowledge Base: