How to obtain and use the Administrative Operations Tool in Microsoft CRM 1.2 (893102)


The information in this article applies to:

  • Microsoft CRM 1.2

This article describes how to obtain, install, and use the Microsoft Business Solutions CRM Administrative Operations Tool. It describes the conditions where it is appropriate to use the tool and the precautions that you must take before you use the tool. This article tells you how to obtain the tool, and it provides information that is relevant to installing to tool. Finally, the article describes how to start the tool. Each action that the tool can perform is explained in detail.

Contents

INTRODUCTION

The Administrative Operations Tool is a tool that is frequently used by Microsoft Product Support Services (PSS). You can use this tool to help resolve issues that you would typically have to resolve by restoring the Microsoft CRM databases and the Microsoft CRM organizational unit. You can also use the Administrative Operations Tool to perform certain administrative functions that you cannot perform in Microsoft CRM.

back to the top

MORE INFORMATION

Resolving issues and performing administrative functions

The following are the issues that you can resolve and the functions that you can perform by using Administrative Operations Tool:
  • A Microsoft CRM user who has the role of System Administrator has been deleted from the Active Directory directory service in Microsoft Windows 2000 or in Microsoft Windows Server 2003. If no other Microsoft CRM user has the System Administrator role, Microsoft CRM system administrative functions cannot be performed without restoring the Microsoft CRM program.
  • You want to create a new root business unit, and you want to add a new Microsoft CRM system administrator on the Microsoft CRM server.
  • You want to grant user licenses to multiple users.
  • Microsoft CRM users cannot see or update records in their business units or in a child business unit. The users cannot see or update the records even though the roles that the users have should let them see or update the records.
  • You want to reenable multiple Microsoft CRM user accounts that are disabled at the same time.
  • You want to reenable multiple Microsoft CRM business units that are disabled at the same time.
back to the top

Support policy

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

back to the top

Obtaining and installing the tool

This tool is available from Microsoft, but it is only intended to address the issues that are described in the "Resolving issues and performing administrative functions" section. Only use this tool when you are experiencing these issues.

To obtain this tool, contact Microsoft Product Support Services. 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/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 issues that do not qualify for the specific update in question.

Installation

Install this tool on a computer that is running Microsoft CRM 1.2 Server.

Prerequisites

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

Removal

You can uninstall this tool.

Restart requirement

You do not have to restart the computer after you install this tool.

File information

The English version of this tool 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.
DateTimeVersionSizeFile name
26-Jan-200511:371.2.3297.140305,952Microsoft.Crm.Tools.AdminToolResources.dll
26-Jan-200511:351.2.3297.140129,800Microsoft.Crm.Tools.AdminTool.exe
26-Jan-200511:251.2.3297.140105,192CRMAdminReqTool.dll
back to the top

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
For more information, see Chapter 10, "Backing Up and Restoring your Microsoft CRM System," in the Microsoft CRM 1.2 Implementation Guide.

back to the top

Starting the tool

To start the Administrative Operations Tool, follow these steps:
  1. Locate the C:\Program Files\Microsoft CRM\Server\Bin folder on the Microsoft CRM server.
  2. Double-click theMicrosoft.Crm.Tools.AdminTool.exe file to start the program.
The Flush cache button and the radio buttons in the Administrative Operations Tool window are not currently used by Product Support Services (PSS). The Flush cache button and the radio buttons do not change any data or decrease performance if you use them. However, avoid using them unless a support engineer instructs you to use them.

back to the top

Using the commands

The following sections describe each command that is on the Action menu.

Create System Admin User

The Create System Admin User command lets you create and assign the Microsoft CRM System Administrator role to the user who is currently logged on to the computer where Microsoft CRM Server is installed.

Note The user who performs this action cannot already exist as a Microsoft CRM user. If the user already exists as a Microsoft CRM user, this action will not be successful. Only use this command if you cannot restore Microsoft CRM or if no other Microsoft CRM users exist who have the System Administrator role.

To create a new user who has the System Administrator role, follow these steps:
  1. In the Business Unit list, select the root business unit.
  2. In the First Name box, type your first name.
  3. In the Last Name box, type your last name, and then click OK.

    Note By default, the Domain Login box contains the domain login of the user who is currently logged in to the Microsoft CRM Server.
  4. Click OK to create new user who has the System Administrator role.

Create Root Business Unit

The Create Root Business Unit command lets you create a new root business unit. To do this, follow these steps:
  1. In the Organization list, select the organization.
  2. In the Business unit name box, type the name of the new root business unit.
  3. In the First Name box, type the first name of the Microsoft CRM user who has the System Administrator role.
  4. In the Last Name box, type the last name of the Microsoft CRM user who has the System Administrator role, and then click OK.

Grant User License

The Grant User License command lets you grant user licenses to multiple users. To do this, follow these steps:
  1. In the License type list, select the license type.
  2. Users who do not have a license are displayed in the Users without a license box. Click a user, and then click Click to insert.
  3. Click OK.

Repair Object Security

The Repair Object Security command lets you update all the Microsoft CRM records in the Organization_Name_MSCRM database that have security descriptors with the correct security information. This information is based on the Microsoft CRM users and the Active Directory security groups that are related to the Microsoft CRM security roles.

Note Verify that all the Microsoft CRM business units are enabled in Microsoft CRM before you click Repair Object Security. This action will not be successful if any business units are disabled.

To update the Microsoft CRM records, follow these steps:
  1. In the Organization list, select the organization, and then click OK.
  2. In the Confirm action dialog box, click OK.
  3. Open Microsoft Windows Explorer, and then locate the Program Files\Microsoft CRM\Server\Bin folder. If the hidden Sspcqc.bin file is present, the security descriptor tool is running.
This process may take several hours to run. The time depends on the amount of data and the performance of Microsoft SQL Server. After the process starts it cannot be stopped. A hotfix has been released that may increase the speed of this repair process. For additional information, click the following article number to view the article in the Microsoft Knowledge Base:

835292 Copying a role does not work in Microsoft Business Solutions CRM version 1.2

Enable Users

The Enable Users command lets you easily reenable some of the Microsoft CRM users who are disabled. Or, it lets you easily reenable all the users who are disabled. To do this, follow these steps:
  1. All users who are disabled appear in the Disabled users box. Select the users who you want to enable. To select multiple users, press and hold SHIFT+CTRL, and then click each user.
  2. Click Click to insert, and then click OK.

Enable Business Units

The Enable Business Units command lets you easily reenable some of the Microsoft CRM business units that are disabled. Or, it lets you easily reenable al the business units that are disabled. To do this, follow these steps:
  1. All business units that are disabled appear in the Disabled business units box. Select the business units that you want to enable. To select multiple business units, press and hold SHIFT+CTRL, and then click each business unit.
  2. Click Click to insert, and then click OK.
back to the top
Modification Type:MinorLast Reviewed:6/2/2006
Keywords:kbMBSadministration kbMBSMigrate kbQFE kbHotfixServer KB893102 kbAudDeveloper kbAudITPRO kbAudEndUser
©2004 Microsoft Corporation. All rights reserved.