Knowledge Base

MSCRMUnshareUtility is available to resolve the "The system cannot log you on" error in Microsoft CRM that is described in Knowledge Base article 883630

Article ID: 896596

Article Last Modified on 12/25/2006

APPLIES TO

Microsoft CRM 1.2

RESOLUTION

Hotfix information

A supported hotfix is now available from Microsoft, but it is only intended to correct the problem that is described in this article. Only apply it to systems that are experiencing this specific problem. This hotfix may receive additional testing. Therefore, if you are not severely affected by this problem, we recommend that you wait for the next version of Microsoft Business Solutions CRM that contains this hotfix.

To resolve this problem immediately, contact Microsoft Product Support Services to obtain the hotfix. For a complete list of Microsoft Product Support Services telephone numbers and information about support costs, visit the following Microsoft Web site:

http://support.microsoft.com/contactus/?ws=support

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 issues that do not qualify for the specific update in question.

Installation information

Install the tool on servers that are running Microsoft CRM 1.2.

Prerequisites

To install the files that are contained in this hotfix package, you must have Microsoft CRM 1.2 installed.

Removal information

To remove the tool, delete the files that are contained in this hotfix package.

Restart requirement

If you are prompted, restart the computer after you apply this hotfix.

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
   -----------------------------------------------------------------------------
   31-Oct-2003  20:29  1.2.3297.0      498,256  Microsoft.crm.platform.proxy.dll  
   31-Oct-2003  20:28  1.2.3297.0       26,704  Microsoft.crm.platform.types.dll  
   14-Jul-2005  12:36  1.0.2021.24508   40,960  Mscrmunshareutility.exe  
   14-Jul-2005  10:14                      458  Mscrmunshareutility.xml

Usage information

Important We recommend that you back up all the following objects before you use the MSCRMUnshareUtility tool:

The Microsoft CRM databases
The Microsoft CRM Active Directory organization unit
Active Directory user accounts that are configured as Microsoft CRM users

For more information about how to back up Microsoft CRM-related objects, see Chapter 10, "Backing Up and Restoring your Microsoft CRM System," in the Microsoft CRM 1.2 Implementation Guide.

To use the MSCRMUnshareUtility tool, follow these steps:

Note Make sure that all the affected user accounts are members of PrivUserGroup before you use the MSCRMUnshareUtility.

On the Microsoft CRM server, extract the MSCRMUnshareUtility files to a folder. For example, extract the files to the %ProgramFiles%\Microsoft CRM folder.
Connect to the Microsoft CRM server as the CRM Administrator, and then locate the \MSCRMUnshareUtility\bin\Release folder.
Open the file MSCRMUnshareUtility.xml file by using a text editor such as Notepad.
In the following tag, modify the value for the crmservername entry.
```
<add key="crmservername" value="YourCRMServer"/>
```
Note Replace YourCRMServer with the name of the Microsoft CRM server. For example, if the Microsoft CRM server name is CRMAdventure, modify the tag so that it appears as follows.
```
<add key="crmservername" value="crmadventure"/>
```
Save the changes to the .xml file, and then start MSCRMUnshareUtility.exe. A list of disabled Microsoft CRM user accounts appears on the left side of MSCRMUnshareUtility. A list of the related entities appears on the right side of MSCRMUnshareUtility.
Select a disabled user account, and then select one or more of the related entity entries.

Note We recommend that you select only one entity entry at a time for the first installation of MSCRMUnshareUtility to test the tool in your environment.
Click FastMode.

Event messages such as "now processing" and "now done" appear in the status window when MSCRMUnshareUtility correctly revokes access to Microsoft CRM records.

Note For more status information, see MSCRMUnshareUtilityLog in Event Viewer.

MORE INFORMATION

For more information about the terminology that is used to describe Microsoft product updates, click the following article number to view the article 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: kbmbsadministration kbmbsmigrate kbpubtypekc kbqfe kbhotfixserver KB896596

Microsoft KB Archive/896596

Contents