Microsoft KB Archive/893106

= How to obtain and use the CRMADRecovery tool in Microsoft CRM 1.2 =

Article ID: 893106

Article Last Modified on 6/2/2006

-

APPLIES TO


 * Microsoft CRM 1.2

-





SUMMARY
''This article describes how to obtain, to install, to start, and to use the Microsoft Business Solutions CRMADRecovery tool. The description includes the conditions where it is appropriate to use the tool and the precautions that you must take before you use the tool. Each action that the tool can perform is explained in detail.''



INTRODUCTION
CRMADRecovery is a tool that is used by Microsoft Product Support Services (PSS). You can use this tool to help resolve problems that affect the Microsoft CRM security model and the security groups within Active Directory that are associated to Microsoft CRM Security roles. This tool compares Microsoft CRM databases, and also makes sure that the Active Directory security groups in the Microsoft CRM organizational unit (OU) correctly match.



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 &quot;Introduction&quot; 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:

http://support.microsoft.com/default.aspx?scid=fh;[LN;CNTACTMS]

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:

%windir%\$NTUninstallKB123456$\Spuninst

For more information about how to use a package installer to remove a hotfix, see the following article in the Microsoft Knowledge Base:

832475 Description of the new features in the package installer for Windows software updates

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, &quot;Backing Up and Restoring your Microsoft CRM System,&quot; 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:.
 * 1) Click Start, click Run, type cmd, and then click OK.
 * 2) Change the directory to point to the C drive. To do this, type C:, and then press ENTER.
 * 3) To access the directory that contains the CRMADRecovery program, type CD , 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  in this step with the actual directory to which you have installed.
 * 1) Type crmadrecovery.exe –d > crmadrecovery_diagnosis.txt, and then press ENTER.

Notes
 * 1) * 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.
 * 2) * 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.
 * 3) Back up the Microsoft CRM databases and the Active Directory. For comprehensive instructions, see Chapter 10, &quot;Backing Up and Restoring your Microsoft CRM System,&quot; of the Microsoft CRM 1.2 Implementation Guide.
 * 4) 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:

824684 Description of the Standard Terminology That Is Used to Describe Microsoft Software Updates

887283 Microsoft Business Solutions CRM software hotfix and update package naming standards

Keywords: atdownload kbinfo kbmbsmigrate kbqfe kbhotfixserver KB893106

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.