Microsoft KB Archive/946677

= How to install Microsoft Dynamics CRM 4.0 with the minimum required permissions =

Article ID: 946677

Article Last Modified on 1/2/2008

-

APPLIES TO


 * Microsoft Dynamics CRM 4.0

-



INTRODUCTION
This article describes the minimum permissions that are required for a user to install Microsoft Dynamics CRM 4.0.



MORE INFORMATION
Notes
 * This article assumes that all the Microsoft Dynamics CRM 4.0 server roles are being installed on the same computer.
 * For more information about server roles, see the implementation guide.
 * During the installation, the Environment Diagnostic wizard checks whether the user who is installing Microsoft Dynamics CRM has the minimum required permissions. If the minimum required permissions are not met, you receive an error message.

Installation options
You have two options when you install Microsoft Dynamics CRM with the minimum required permissions. You can let the Microsoft Dynamics CRM server Setup program create the security groups during the installation. Or, you can use pre-created Active Directory security groups.

You can also select to turn on the Auto Group Management functionality or to turn off the Auto Group Management functionality. By default, the Auto Group Management functionality is turned on. Microsoft Dynamics CRM automatically adds the appropriate user accounts and the appropriate computer accounts to the required Microsoft Dynamics CRM security groups. If you turn off Auto Group Management, Microsoft Dynamics CRM does not automatically add these accounts. In this case, a domain administrator or a user who has sufficient permissions must add the appropriate user accounts and the appropriate computer accounts to the required groups. These additions must be made after the installation and after any user is added to Microsoft Dynamics CRM.

Installation option 1: The Setup program creates the Active Directory security groups when you install Microsoft Dynamics CRM
 Add the user account of the user who is installing Microsoft Dynamics CRM as a member of the local administrator group. To do this, follow these steps on the Microsoft Dynamics CRM server and on the computer that is running Microsoft SQL Server:  Log on to the server as a user who has local administrator permissions. Click Start, point to Administrative Tools, and then click Computer Management. Expand System Tools. Expand Local Users and Groups. Click Groups. Right-click Administrators, and then click Properties.</li> To add the account of the user who is installing Microsoft Dynamics CRM, click Add.</li></ol> </li> If SQL Server Reporting Services (SSRS) is installed on a server other than the server on which you added permissions in step 1, you must add the Content Manager role at the root level for the installing user account. And, you must add the System Administrator role at the site-wide level for the installing user account. To do this, follow these steps on the Reporting Services server: <ol style="list-style-type: lower-alpha;"> Start Windows Internet Explorer, and then locate the following site:

http://srsserver/reports

</li> On the Properties tab, click New Role Assignment.</li> In the Group or user name box, type the user name of the user who is installing Microsoft Dynamics CRM, click to select the Content Manager check box, and then click OK.

Note Use the following format when you type the user name:

\

</li> Click Site Settings.</li> Under Security, click Configure site-wide security, and then click New Role Assignment.</li> In the Group or user name text box, type the user name of the user who is installing Microsoft Dynamics CRM, click to select the System Administrator check box, and then click OK.

Note Use the following format when you type the user name:

\

</li></ol> </li> For the user account of the user who is installing Microsoft Dynamics CRM, add the following permissions to the organizational unit (OU) in the Active Directory directory service. You must do this step for the OU to which you select to install during the installation of Microsoft Dynamics CRM 4.0.

Permissions <ul> Read</li> Create All Child Objects</li></ul>

Advanced permissions <ul> Read Permissions</li> Modify Permissions</li> Read Members</li> Write Members</li></ul>

To add the permissions, follow these steps: <ol style="list-style-type: lower-alpha;"> Log on to the domain controller server as a user who has domain administrator permissions.</li> <li>Click Start, click Administrative Tools, and then click Active Directory Users and Computers.</li> <li>On the View menu, click Advanced Features.</li> <li>In the navigation pane, find the OU that you want to use for the Microsoft Dynamics CRM installation. To do this, expand the tree to the node that contains the security group.</li> <li>Right-click the security group, click Properties, and then click the Security tab.</li> <li>In the Group or user names list, click the user account of the user who is installing Microsoft Dynamics CRM if the account is listed. If the account is not listed, click Add to add the user account.</li> <li>In the Allow column, click to select the check box for the Create All Child Objects permission.

Note By default, the Allow check box is selected for the Read permission.</li> <li>Click Advanced.</li> <li>In the Permission entries list, click Add, select the user account of the user who is installing Microsoft Dynamics CRM, and then click OK.</li> <li>In the Apply onto list, click Group objects.</li> <li>In the Allow column, click to select the following check boxes: <ul> <li>Read Permissions</li> <li>Modify Permissions</li></ul> </li> <li>Click the Properties tab.</li> <li>In the Apply onto list, click Group objects.</li> <li>In the Allow column, click to select the following check boxes: <ul> <li>Read Members</li> <li>Write Members</li></ul> </li> <li>Click OK three times.</li></ol> </li> <li>Install Microsoft Dynamics CRM.</li></ol>

Installation option 2: Use the pre-created Active Directory security groups when you install Microsoft Dynamics CRM
<ol> <li>Create the following security groups in Active Directory: <ul> <li>PrivUserGroup</li> <li>PrivReportingGroup</li> <li>ReportingGroup</li> <li>SQLAccessGroup</li> <li>UserGroup</li></ul>

To create the security groups in Active Directory, follow these steps: <ol style="list-style-type: lower-alpha;"> <li>Log on to the domain controller server as a user who has domain administrator permissions.</li> <li>Click Start, click Administrative Tools, and then click Active Directory Users and Computers.</li> <li>Expand the &quot;Active Directory Users and Computers&quot; tree to the root of the domain or to the specific organizational unit (OU) that you want to use to install Microsoft Dynamics CRM.</li> <li>Right-click the domain root or the OU that you want to use, click New, and then click Group.</li> <li>In the Group Name field, type the name of the group. For example, type PrivUserGroup .</li> <li>If the domain functional level is Windows Server 2003 or Microsoft Windows 2000 native, click Domain local in the Group scope list. If the domain functional level is Windows 2000 mixed, click Global in the Group scope list.</li> <li>Click OK.</li> <li>Repeat steps 1d through 1g earlier in this section to create each security group.</li></ol> </li> <li>Add the user account of the user who is installing Microsoft Dynamics CRM as a member of the Local Administrator group. You must complete this step on the computer that is running the Microsoft Dynamics CRM server and on the computer that is running SQL Server. <ol style="list-style-type: lower-alpha;"> <li>Log on to the server as a user who has local administrator permissions.</li> <li>Click Start, click Administrative Tools, and then click Computer Management.</li> <li>Expand System Tools, expand Local Users and Groups, and then expand Groups.</li> <li>Right-click Administrators, and then click Properties.</li> <li>To add the user account of the user who is installing Microsoft Dynamics CRM, click Add, and then click OK.</li></ol> </li> <li>If SQL Server Reporting Services (SSRS) is installed on a server other than the server on which you added permissions in step 1, add the Content Manager role at the root level for the installing user account. Then, add the System Administrator Role at site-wide level for the installing user account. To do this, follow these steps on the server that is running Reporting Services: <ol style="list-style-type: lower-alpha;"> <li>Start Internet Explorer, and then locate the following site:

http://srsserver/reports

</li> <li>Click the Properties tab, and then click New Role Assignment.</li> <li>In the Group or user name box, type the name of the user who is installing Microsoft Dynamics CRM, click to select the Content Manager check box, and then click OK.

Note Use the following format when you type the user name:

\

</li> <li>Click Site Settings.</li> <li>Under Security, click Configure site-wide security, and then click New Role Assignment.</li> <li>In the Group or user name box, type the name of the user who is installing Microsoft Dynamics CRM, click to select the System Administrator check box, and then click OK.

Note Use the following format when you type the user name:

\

</li></ol> </li> <li>If you want Microsoft Dynamics CRM to manage the Microsoft Dynamics CRM security groups that are created during the installation, add the following permissions to the security groups that you created in step 1 earlier in this section:

Permissions <ul> <li>Read</li> <li>Write</li> <li>Add/Remove self as member</li></ul>

Advanced permissions <ul> <li>List Contents</li> <li>Read All Properties</li> <li>Write All Properties</li> <li>Read Permissions</li> <li>Modify Permissions</li> <li>All Validated Writes</li> <li>Add/Remove self as member</li></ul>

To add the permissions, follow these steps for each security group that you created in step 1 earlier in this section: <ol style="list-style-type: lower-alpha;"> <li>Log on to the domain controller server as a user who has domain administrator permissions.</li> <li>Click Start, click Administrative Tools, and then click Active Directory Users and Computers.</li> <li>On the View menu, click Advanced Features.</li> <li>In the navigation pane, expand the tree to the security group, right-click the security group, click Properties, and then click the Security tab.</li> <li>In the Group or user names list, click the user account of the user who is installing Microsoft Dynamics CRM if the account is listed. If the account is not listed, click Add to add the user account.</li> <li>In the Allow column, click to select the check box for the Write permission. This action causes the system to automatically select the check box for the Add/Remove self as member permission.

Note By default, the Allow check box is selected for the Read permission.</li> <li>Click Advanced.</li> <li>In the Permission entries list, click the user account of the user who is installing Microsoft Dynamics CRM, and then click Edit.</li> <li>Click to select the Modify Permissions check box in the Allow column.</li> <li>Click OK three times.</li></ol>

Notes <ul> <li>By default, the following permissions are set to Allow: <ul> <li>List Contents</li> <li>Read All Properties</li> <li>Write All Properties</li> <li>Read Permissions</li> <li>All Validated Writes</li> <li>Add/Remove self as member</li></ul> </li> <li>If you will turn off Auto Group Management for the installation, you do not have to complete step 4.</li> <li>For more information about Auto Group Management, see the &quot;Auto Group Management options&quot; section.</li></ul> </li> <li>When you first log on to Microsoft Dynamics CRM, and every time that a user is added to Microsoft Dynamics CRM, you must complete the following actions: <ul> <li>To log on, use a user account that has the necessary rights.</li> <li>Manually add the users and the computers to the appropriate security groups.</li></ul> </li> <li> To use the pre-created Active Directory security groups, create a configuration file to point to Microsoft Dynamics CRM. To do this, create an XML configuration file that uses the syntax that is in the following example. Modify the variables as appropriate. The list that follows the sample code describes how to modify the variables that are in this example.

In the following sample code, the XML file is named Config_precreate.xml. The domain name is microsoft.com. These names represent the actual names that you use. The Active Directory hierarchy is as follows: <ul> <li>root domain <ul> <li>Company Name OU <ul> <li>Company Name OU</li></ul> </li></ul> </li></ul>

Sample code <CRMSetup> <Server> <Groups AutoGroupManagementOff=&quot;true&quot;> <PrivUserGroup>CN=PrivUserGroup,OU=Company Name,OU=Company Name,DC= ,DC=<domain_extension></PrivUserGroup> <SQLAccessGroup>CN=SQLAccessGroup,OU=Company Name,OU=Company Name, DC= ,DC=<domain_extension></SQLAccessGroup> <UserGroup>CN=UserGroup,OU=Company Name,OU=Company Name,DC= ,DC=<domain_extension></UserGroup> <ReportingGroup>CN=ReportingGroup,OU=Company Name,OU=Company Name, DC= ,DC=<domain_extension></ReportingGroup> <PrivReportingGroup>CN=PrivReportingGroup,OU=Company Name,OU=Company Name, DC= ,DC=<domain_extension></PrivReportingGroup> </Groups> </Server> </CRMSetup> Modify the parameters in the example by using the following replacement values: <ul> <li>PrivUserGroup: The name of the PrivUserGroup security group</li> <li>SQLAccessGroup: The name of the SQLAccessGroup security group</li> <li>UserGroup: The name of the UserGroup security group</li> <li>ReportingGroup: The name of the ReportingGroup security group</li> <li>PrivReportingGroup: The name of the ReportingGroup security group</li> <li>domain: The domain name</li> <li>domain_extension: The domain extension</li></ul>

Note For more information about all the configuration file parameters and samples, see the implementation guide. </li> <li>Run the Microsoft Dynamics CRM server installation. To do this, click Start, click Run, type C:\ServerSetup.exe /config C:\configprecreate.xml in the Open box, and then click OK.

Notes <ul> <li>&quot;C:\ServerSetup.exe&quot; refers to the path of the ServerSetup.exe file on the installation medium.</li> <li>&quot;C:\configprecreate.xml&quot; refers to the name and the path of the configuration file that was created.</li></ul> </li></ol>

Auto Group Management options
The Auto Group Management option is used to determine how the appropriate users and the appropriate computers are added to the security groups. Microsoft Dynamics CRM can add the users and the computers. Or, a user who has appropriate permissions in the Microsoft Dynamics CRM security groups can manually add the users and the computers.

For the Auto Group Management option, use one of the following methods. Use Method 1 to set the AutoGroupManagementOff option to &quot;false&quot; and to have Auto Group Management turned on. Use Method 2 to set the AutoGroupManagementOff option to &quot;true&quot; and to have Auto Group Management turned off.

Note The Auto Group Management option can be used only if you are installing Microsoft Dynamics CRM by using pre-created Active Directory security groups.

Method 1: Set the AutoGroupManagementOff option to &quot;false&quot;
Because this setting is the default setting, you do not have to add anything to the configuration file. However, the following procedure is an example that describes how to set the AutoGroupManagementOff option to &quot;false.&quot;

Create an XML configuration file that uses the syntax in the following example. Modify the variables as appropriate. To modify the variables that are in this example, refer to step 6 in the &quot;Installation option 2: Use the pre-created Active Directory security groups when you install Microsoft Dynamics CRM&quot; section as a guideline.

In this example, the XML file is named Config_precreate.xml. The domain name is microsoft.com. The Active Directory hierarchy is as follows:
 * root domain
 * Company Name OU
 * Company Name OU

Sample code <CRMSetup> <Server> <Groups> <Groups autogroupmanagementoff=&quot;false&quot;> <PrivUserGroup>CN=PrivUserGroup,OU=Company Name,OU=Company Name,DC=microsoft,DC=com</PrivUserGroup> <SQLAccessGroup>CN=SQLAccessGroup,OU=Company Name,OU=Company Name, DC=microsoft,DC=com</SQLAccessGroup> <UserGroup>CN=UserGroup,OU=Company Name,OU=Company Name,DC=microsoft,DC=com</UserGroup> <ReportingGroup>CN=ReportingGroup,OU=Company Name,OU=Company Name, DC=microsoft,DC=com</ReportingGroup> <PrivReportingGroup>CN=PrivReportingGroup,OU=Company Name,OU=Company Name, DC=microsoft,DC=com</PrivReportingGroup> </Groups> </CRMSetup>

Method 2: Set the AutoGroupManagementOff option to &quot;true&quot;
<ol> <li> Create an XML configuration file that uses the syntax that is in the following example. Modify the variables as appropriate. To modify the variables that are in this example, refer to step 6 in the &quot;Installation option 2: Use the pre-created Active Directory security groups when you install Microsoft Dynamics CRM&quot; section as a guideline.

In this example, the XML file is named Config_manageoff.xml. The domain name is microsoft.com. The Active Directory hierarchy is as follows: <ul> <li>root domain <ul> <li>Company Name OU <ul> <li>Company Name OU</li></ul> </li></ul> </li></ul>

Sample code <CRMSetup> <Server> <Groups AutoGroupManagementOff=&quot;true&quot;> <PrivUserGroup>CN=PrivUserGroup,OU=Company Name,OU=Company Name, DC=microsoft,DC=com</PrivUserGroup> <SQLAccessGroup>CN=SQLAccessGroup,OU=Company Name,OU=Company Name, DC=microsoft,DC=com</SQLAccessGroup> <UserGroup>CN=UserGroup,OU=Company Name,OU=Company Name, DC=microsoft,DC=com</UserGroup> <ReportingGroup>CN=ReportingGroup,OU=Company Name,OU=Company Name, DC=microsoft,DC=com</ReportingGroup> <PrivReportingGroup>CN=PrivReportingGroup,OU=Company Name,OU=Company Name, DC=microsoft,DC=com</PrivReportingGroup> </Groups> </Server> </CRMSetup> </li> <li>Add the appropriate user accounts and the appropriate computer accounts as members of the following groups.

Note You must follow this step only if the AutoGroupManagementOff option is set to &quot;true.&quot;

PrivUserGroup <ul> <li>The account that the CRMAppPool application pool uses</li> <li>The account that the ASP.NET process model uses</li> <li>The user account that runs the Microsoft Dynamics CRM installation</li> <li>The computer account on which the Microsoft Dynamics CRM-Exchange E-mail Router will be installed</li></ul>

ReportingGroup <ul> <li>All Microsoft Dynamics CRM user accounts (this includes the user who is installing Microsoft Dynamics CRM)</li></ul>

SQLAccessGroup <ul> <li>The account that the CRMAppPool application pool uses</li> <li>The account that the ASP.NET process model uses</li></ul>

UserGroup <ul> <li>All Microsoft Dynamics CRM user accounts (this includes the user who is installing Microsoft Dynamics CRM)</li></ul>

PrivReportingGroup <ul> <li>The computer account on which the Microsoft Dynamics CRM Data Connector for Microsoft SQL Server Reporting Services will be installed</li></ul>

To add the accounts, follow these steps for each group in the list: <ol style="list-style-type: lower-alpha;"> <li>Log on to the domain controller server as a user who has domain administrator permissions.</li> <li>Click Start, click Administrative Tools, and then click Active Directory Users and Computers.</li> <li>In the navigation pane, expand the tree to the node that contains the security group, right-click the security group, click Properties, and then click the Members tab.</li> <li>To add a user account, click Add, and then click OK. To add a computer account, click Object Types, click to select the Computers check box, and then click OK.</li></ol> </li> <li>To verify which account the CRMAppPool application pool uses, follow these steps on the computer that is running the Microsoft Dynamics CRM server: <ol style="list-style-type: lower-alpha;"> <li>Click Start, click Administrative Tools, and then click Internet Information Services (IIS) Manager.</li> <li>Expand the computer name.</li> <li>Expand Application Pools.</li> <li>Right-click CRMAppPool, click Properties, and then click the Identity tab.</li></ol>

The NetworkService account and the LocalSystem account are both represented by the &quot;domainname\computername $&quot; account. Therefore, if you must add the NetworkService account or the LocalSystem account to a security group, you must add the &quot;domainname\computername $&quot; account.

If the Configurable option is selected, you must add the specified user account to the security group. The specified user account appears in a text box.</li> <li>To verify the account that the ASP.NET process model uses, follow these steps on the Microsoft Dynamics CRM server: <ol style="list-style-type: lower-alpha;"> <li>In Windows Explorer, open the following folder:

C:\WINNT\Microsoft.NET\Framework\v1.1.4322\CONFIG

</li> <li>Right-click Machine.config, click Open With, and then click Notepad.</li> <li>Search for the word &quot;username&quot; in the text. The file contains multiple instances of the word. Locate the fifth instance of &quot;username&quot; that is in the text. The value for the fifth instance of &quot;username&quot; is the account that the ASP.NET process model uses.</li></ol>

The SYSTEM account and the computer account are both represented by the &quot;domainname\computername $&quot; account. Therefore, if you must add the SYSTEM account or the computer account to a security group, you must add the &quot;domainname\computername $&quot; account.

If a user name is specified in the Machine.config file, you must add the specified user account to the security group.</li></ol>

<div class="moreinformation_section">

Service account
During the installation of Microsoft Dynamics CRM, you will see a Specify Security Account page. On this page, you can select to use a domain user account as the security account. To do this, follow these steps: <ol> <li>Add the domain user account to the Performance Log Users local group. To do this, follow these steps: <ol style="list-style-type: lower-alpha;"> <li>On the computer that is running the Microsoft Dynamics CRM server, click Start, click All Programs, click Administrative Tools, and then click Computer Management.</li> <li>Expand Local Users and Groups, and then expand Groups.</li> <li>Right-click the Performance Log Users group, and then click Add to Group.</li> <li>Click Add, type the domain user account, and then click OK two times.</li></ol> </li> <li>Create the HTTP Service Principal Names account under the domain user account. To do this, follow these steps: <ol style="list-style-type: lower-alpha;"> <li>Install Windows Server Support Tools if it is not installed.

Note This step does not have to be done on the computer that is running the Microsoft Dynamics CRM server. This step can be done on another server in the domain. And, you must be logged on by using an account that has permissions to add service principal names (SPNs) to user accounts.</li> <li>At a command prompt, type the following commands, and then press ENTER after each command:

SETSPN –a http/.

SETSPN –a http/

</li></ol>

Note The  placeholder is the name of the server on which Microsoft Dynamics CRM will be installed. The  placeholder represents the name of the domain. The  placeholder represents the account that you are using as the Service Account during the Microsoft Dynamics CRM installation.</li></ol>

<div class="references_section">