Server XML configuration file

The /config [drive:] [[path] configfilename.xml]] command-line parameter provides Microsoft Dynamics CRM Server Setup with required information. The information supplied by the XML configuration file is the same required by each installation screen.

Important

The XML elements must be in English (US). An XML configuration file that has localized XML elements will not work correctly. For example, if you have a German version of Microsoft Dynamics CRM Server 2011, the XML file elements must still be English (US).

By default, Setup will use UTF-8 encoding for the Setup XML configuration file. Setup cannot load an XML configuration file when there are extended characters in the file. You will receive an error message from Setup that the XML file is invalid. If the XML configuration file contains extended characters, you can work around this issue by saving the XML configuration file by using Unicode encoding. To do this, open the XML configuration file in Notepad, click Save As, in the Encoding list select Unicode, and then click Save.

An explanation of each XML element and a sample XML file for a Full Server installation follows. For information about how to install separate server roles by using the command prompt, see the Install Microsoft Dynamics CRM Server 2011 roles topic later in this section.

<CRMSetup> </CRMSetup>

The configuration file must be a valid XML file that uses <CRMSetup> as the root element.

<Server> </Server>

Specifies a Microsoft Dynamics CRM Server 2011 installation. All the Microsoft Dynamics CRM Server 2011 entries that follow must be inside the <Server> elements.

<InstallType>Uninstall/Repair/Configure</InstallType>

Specifies the type of installation that Setup will perform. The following options are available:

Uninstall. Uninstalls Microsoft Dynamics CRM Server 2011.

Repair. Starts Setup in repair mode.

Configure. Starts Setup in configuration mode.

<Patch update="true"/"false">\\ServerName\ShareName\Patch_Location</Patch>

Determines the behavior of the update Microsoft Dynamics CRM Server Setup technology. This feature lets Setup perform a one-time search for, and if applicable, download to apply the latest installation files for Microsoft Dynamics CRM.

By default, this element does not specify a location, which configures Setup to search for available updates by using Microsoft Update. If you want Setup to install updates from another location, such as a share on your network, add the file paths to the .msp file in the element, as shown in the following topic.

update

Specifies whether Setup will look for, download, and apply updates for Microsoft Dynamics CRM Server Setup. We recommend that you let Setup download the latest version by specifying true. By default, this value is set to false. If the value is set to false, Setup will ignore this step and continue with the installation. However, if running Setup by using the /Q or /QR parameter, you must specify this element.

For more information about how to obtain Setup updates, see How to obtain the setup updates for Microsoft Dynamics CRM 2011.

<SqlServer>SQLServername\InstanceName</SqlServer>

Specifies the name of the instance of Microsoft SQL Server that will manage the Microsoft Dynamics CRM Server 2011 database files. If you use the default instance, you can provide the name of the computer where SQL Server is installed. If SQL Server is running on the computer where you are installing Microsoft Dynamics CRM Server 2011, you can specify ". " or "localhost".

<Database create="true"/"false" update="true"/"false"/>

create

Values for this parameter are either true or false. True causes Setup to create a new Microsoft Dynamics CRM configuration database. False causes Setup to connect to an existing Microsoft Dynamics CRM configuration database.

update

Values for this parameter are either true or false. When you select true, Setup will write the appropriate server deployment information to the configuration database (MSCRM_CONFIG). Select false only when you are using a pre-existing configuration database and you do not want Setup to update the server deployment information. When you select false, the appropriate server deployment information for the computer where Microsoft Dynamics CRM 2011 Server is being installed must already exist in the configuration database for Setup to complete successfully. The default value is true.

<Organization>Organization friendly or long name</Organization>

Specifies the long name of your organization. The name can be up to 250 characters long and extended characters are supported.

<OrganizationUniqueName>Unique name</OrganizationUniqueName>

UniqueName

Specifies the name of your organization that will be used in the URL that users will use to access the deployment. There is a 30 character limit. Extended characters or spaces are not allowed. If you do not specify this element or leave the value blank, Setup will generate a short name based on the <Organization> element value.

Important

The unique organization name will be used to construct the URL for users to sign-in to the application. Therefore, we recommend that you limit the length of the unique organization name to reduce the overall length of the URL.

<muoptin optin="true”/“false" />

Specifies whether to use Microsoft Update to download and install updates to Microsoft Dynamics CRM Server 2011 and other installed applications. After the installation is completed, this feature helps keep your computer up-to-date on an ongoing basis.

  • True. When you specify this option, Setup will opt in to Microsoft Update as the update service and use the Windows automatic updating settings on the computer. Windows automatic update settings can be viewed in Windows Update in Control Panel. Microsoft Update helps make sure that your computer has the latest technology, which can help reduce the risk of vulnerabilities and security issues.
  • False. When you specify this option, Setup will not change the existing Windows automatic update settings. If the computer is not already configured to use Microsoft Update as the update service, we recommend that you have another method to install updates on the computer, such as by using Microsoft Windows Update Services (WSUS). If left blank, a value of false will be selected.

<OU> OU=value,DC=value,DC=value,DC=value,DC=value</OU>

The <OU> element specifies the Active Directory directory service organizational unit (OU) where the security groups will be created, for example, <OU> OU=CRM, DC=MySubDomain, DC=MyDomain, DC=com</OU>.

Important

You cannot use the <Groups> element with the <OU> element. Setup will not continue if you specify both elements together.

<PreferredDC>servername.domain.com</PreferredDC>

Specifies the domain controller to contact when performing operations that require Active Directory. If not specified, Setup will use the first domain controller available. This setting is only available when you use a configuration file.

<LicenseKey>KeyValue</LicenseKey>

Specifies the product key for this deployment. The configuration file can contain only one Microsoft Dynamics CRM product key. For example:

<licenseKey>XXXXX-XXXXX-XXXXX-XXXXX-XXXXX</licenseKey>

Note

If you purchase Microsoft Dynamics CRM through a Microsoft Volume Licensing program, the license key is provided in the license.txt file. The license.txt file is included in the Microsoft Dynamics CRM installation files.

<WebsiteUrl Create="true"/"false" port="TCPportnumber">path</WebsiteUrl>

Specifies the Web site to be used for Microsoft Dynamics CRM Server 2011.

Use Create="true" to create a new Microsoft Dynamics CRM Web site and leave the value between the element tags blank. Use port="TCPportnumber", where TCPportnumber is a valid and available TCP port number, to specify the port for connecting to the Microsoft Dynamics CRM Server 2011 application. If left blank, the port number that will be used is 5555.

Specify Create="false" to use an existing Web site and then you must type the Web site path in the element tags by using one of the following formats. When you use the Create="false" attribute, the port attribute is ignored.

For example:

<Help anonymous="true"/"false">https://host/Help</Help>

Optional element to specify a different URL where Microsoft Dynamics CRM Help is located. This setting is typically used in a multi-server deployment or to replace the default URL such as when using a host header. If you select false to disable anonymous access, it may produce repeated login prompts for users who access Microsoft Dynamics CRM Help. This setting is only available when you use a configuration file.

<InstallDir>c:\program files\Microsoft Dynamics CRM</InstallDir>

Specifies the folder in which application files will be installed. By default, Setup will use the folder C:\Program Files\Microsoft Dynamics CRM.Specifies the folder in which application files will be installed. By default, Setup will use the folder C:\Program Files\Microsoft Dynamics CRM.Specifies the folder in which application files will be installed. By default, Setup uses the folder C:\Program Files\Microsoft Dynamics CRM.

<basecurrency isocurrencycode="CurrencyCode" currencyname="CurrencyName" currencysymbol="CurrencySymbol" currencyprecision=”2"/"3"/"4”/>

isocurrencycode

Specifies the ISO three-letter currency-code, display name, and symbol to use for the base currency. For example, if you want to use U.S. dollars as the base currency, use isocurrencycode="USD". You must use a valid ISO currency description for the isocurrencycode attribute.

currencyname and currencysymbol

You must also specify the currency-name and currency-symbol display names for the ISO base currency. For example, if the ISO currency code is USD, the currency name should be "US Dollar" and the currency symbol should be "$". However, you can use any string that you want for these attributes.

Important

After Setup is complete, you cannot change the base ISO currency code. However, you can change the base-currency name, base-currency symbol, and base-currency precision.

A list of currently supported ISO currency codes is available in the Currency support of this guide. The currency codes are provided from Microsoft .NET Framework and may change.

currencyprecision

You must specify the precision for the base currency that you specified in the currencycode attribute. Valid values depend on the type of currency that you specify. For example, USD valid values are 1 – 9 and the default value is 2.

<OrganizationCollation>CollationName</OrganizationCollation>

This optional element specifies the SQL Server database collation name to use for the organization database. The default collation depends on the language of Microsoft Dynamics CRM Server 2011 that you are installing, for example, Latin1_General_Cl_Al, which is the default collation for English (US) language deployments. For more information about database collation, see the Microsoft MSDN Library Web site SQL Server Collation Fundamentals.

<CrmServiceAccount type="DomainUser"/"NetworkService">
     <ServiceAccountLogin>Domain\User</ServiceAccountLogin>
     <ServiceAccountPassword>password</ServiceAccountPassword>
</CrmServiceAccount>

Specifies the Microsoft Dynamics CRM service account used to run the Microsoft Dynamics CRM Unzip Service and ASP.NET AppPool application pool identity.

Accepted values are DomainUser, which will use the specified domain user provided in the <prefixServiceAccount> element or NetworkService, which uses the Network Service system account. However, using the Network Service system account is not recommended because it may limit some database operations such as organization create, import, upgrade, or update. By default, Setup will use the DomainUser option. If DomainUser or no type is specified, <ServiceAccountLogin> and <ServiceAccountPassword> are required. When you run Setup by using the /Q or /QR parameter, if this element is not specified the Network Service account will be used.

Caution

Maintaining the configuration file that has <ServiceAccountLogin> and <ServiceAccountPassword> values specified is a security risk because you are storing a password in plain text. Delete these elements as soon as the configuration file is used to install Microsoft Dynamics CRM Server 2011.

We strongly recommend that you select a low-privilege domain account that is dedicated to running these services and is not used for any other purpose. Additionally, the user account that is used to run a Microsoft Dynamics CRM service cannot be a Microsoft Dynamics CRM user. This domain account must be a member of the Domain Users group. Additionally, if the Asynchronous Service and Sandbox Processing Service roles are installed, such as in a Full Server or a Back End Server installation, the domain account must a member of the Performance Log Users security group.

<SandboxServiceAccount type="DomainUser"/"NetworkService">

<ServiceAccountLogin>Domain\User</ServiceAccountLogin>

<ServiceAccountPassword>password</ServiceAccountPassword>

</SandboxServiceAccount>

Specifies the service account to use for the Sandbox Processing Service.

Accepted values are DomainUser, which will use the specified domain user provided in the <prefixServiceAccount> element or NetworkService, which uses the Network Service system account. However, using the Network Service system account is not recommended because it may limit some database operations such as organization create, import, upgrade, or update. By default, Setup will use the DomainUser option. If DomainUser or no type is specified, <ServiceAccountLogin> and <ServiceAccountPassword> are required. When you run Setup by using the /Q or /QR parameter, if this element is not specified the Network Service account will be used.

Caution

Maintaining the configuration file that has <ServiceAccountLogin> and <ServiceAccountPassword> values specified is a security risk because you are storing a password in plain text. Delete these elements as soon as the configuration file is used to install Microsoft Dynamics CRM Server 2011.

If you do not specify this element, Setup will use the account specified in the <CrmServiceAccount> element to run this service. Therefore, we recommend that you specify a different low-privilege user account for each of the Microsoft Dynamics CRM service accounts.

<DeploymentServiceAccount type="DomainUser"/"NetworkService">

<ServiceAccountLogin>Domain\User</ServiceAccountLogin>

<ServiceAccountPassword>password</ServiceAccountPassword>

<DeploymentServiceAccount>

Specifies the service account to use for the Deployment Web Service.

Accepted values are DomainUser, which will use the specified domain user provided in the <prefixServiceAccount> element or NetworkService, which uses the Network Service system account. However, using the Network Service system account is not recommended because it may limit some database operations such as organization create, import, upgrade, or update. By default, Setup will use the DomainUser option. If DomainUser or no type is specified, <ServiceAccountLogin> and <ServiceAccountPassword> are required. When you run Setup by using the /Q or /QR parameter, if this element is not specified the Network Service account will be used.

Caution

Maintaining the configuration file that has <ServiceAccountLogin> and <ServiceAccountPassword> values specified is a security risk because you are storing a password in plain text. Delete these elements as soon as the configuration file is used to install Microsoft Dynamics CRM Server 2011.

If you do not specify this element, Setup will use the account specified in the <CrmServiceAccount> element to run this service. Therefore, we recommend that you specify a different low-privilege user account for each of the Microsoft Dynamics CRM service accounts.

In addition to the permissions required by the other Microsoft Dynamics CRM service accounts, the Deployment Web Service account requires system administrator permission on the SQL Server, and must be a member of the local administrator group where SQL Server is running to be able to create or import organizations.

Important

To perform organization operations through the Deployment Web Service or Windows PowerShell, the Deployment Service account must have system administrator permissions on the computer that is running SQL Server and must be a member of the local administrators group where SQL Server is installed. Additionally, the user that is performing the organization operations should be a Deployment Administrator.

The Deployment Administrator role in Microsoft Dynamics CRM is set in Deployment Manager.

<AsyncServiceAccount type="DomainUser"/"NetworkService">

<ServiceAccountLogin>Domain\User</ServiceAccountLogin>

<ServiceAccountPassword>password</ServiceAccountPassword>

<AsyncServiceAccount>

Specifies the service account to use for the asynchronous processing services.

Accepted values are DomainUser, which will use the specified domain user provided in the <prefixServiceAccount> element or NetworkService, which uses the Network Service system account. However, using the Network Service system account is not recommended because it may limit some database operations such as organization create, import, upgrade, or update. By default, Setup will use the DomainUser option. If DomainUser or no type is specified, <ServiceAccountLogin> and <ServiceAccountPassword> are required.

Caution

Maintaining the configuration file that has <ServiceAccountLogin> and <ServiceAccountPassword> values specified is a security risk because you are storing a password in plain text. Delete these elements as soon as the configuration file is used to install Microsoft Dynamics CRM Server 2011.

If you do not specify this element, Setup will use the account specified in the <CrmServiceAccount> element to run this service. Therefore, we recommend that you specify a different low-privilege user account for each of the Microsoft Dynamics CRM service accounts.

<SQM optin=" true / false"/>

Specifies whether you will participate in the Customer Experience Improvement Program. If you specify true, you will participate in the program.

Note

For more information, see Microsoft Customer Experience Improvement Program.

<Reporting URL="https://srsserver1/ReportServer"/>

URL

Specifies the URL of the Report Server.

<Groups autogroupmanagementoff="true/false">

<PrivUserGroup>CN=value,OU=value,DC=value,DC=value,DC=value</PrivUserGroup>

<SQLAccessGroup>CN=value,OU=value,DC=value,DC=value,DC=value</SQLAccessGroup>

<ReportingGroup>CN=value,OU=value,DC=value,DC=value,DC=value</ReportingGroup> <PrivReportingGroup>CN=value,OU=value,DC=value,DC=value,DC=value</PrivReportingGroup>

</Groups>

Important

You cannot use the <Groups> element with the <OU> element. Setup will not continue if you specify both elements together.

When specified, Setup will use the existing groups in Active Directory instead of creating them during installation. If <automanagegroupsoff> is true, Setup will not add or remove any members to those groups. If you specify <automanagegroupsoff> as true, you must manually create and add the appropriate membership to these groups for users to be able to run the application, and you must continue to do so as new members are added or removed from Microsoft Dynamics CRM.

This setting is only available when you use a configuration file.

<Reboot>"true" / "false"</Reboot>

If this option is not specified, the default is false. This means that the server will not automatically restart at the end of Setup. Also, this option applies only to a final install restart, and not previous restarts that may be required for other components.

NOTE

The installation of Microsoft .NET Framework may require you to restart your computer before you can continue to run Microsoft Dynamics CRM Setup.

<Email>

<IncomingExchangeServer name="ServerName"/>

This optional element specifies the Microsoft Exchange Server computer or POP3 that will be used by the E-mail Router to route incoming e-mail messages. If not specified and later the E-mail Router is used in the deployment, the computer must be added to the PrivUserGroup security group.

</Email>

Specifies the e-mail server that will be used for e-mail routing.

<configdb>

This is the parent for the following encryption key elements:

Warning

By default, encryption keys are not stored in the configuration database in an encrypted format. We strongly recommend that you specify encryption when you run Setup by using the following entries. For more information, see Key Management in Microsoft Dynamics CRM.

<encryptionkeys certificate="CrmEncryptionCertificate" generate="true"/"False" password="SCpassword" keysource="uniqueID">

The <encryptionkeys> element specifies how, and whether, to encrypt the keys that are stored in the Microsoft Dynamics CRM system. Use generate="true" to enable the system-generated keys that are encrypted. The keysource may be any value, but must be different from other keysource values. SCpassword is the password that will be used to create the symmetric certificate. This setting is only available when you use a configuration file.

Warning

Maintaining a configuration file that has password and keysource values specified is a security risk because you are storing a password and key information in plain text. We recommend that you save the password in a secure location from where it can be retrieved later for recovery. For more information about best practices for password storage, see the MSDN article Passwords Best practices. Then, delete these elements as soon as the configuration file is used to install Microsoft Dynamics CRM.

<encryptionkey physicalname="CrmSymmetricKey" virtualname="CrmKeyEncryptionKey"/>

Each <encryptionkeys> element specifies a mapping between a symmetric key store in the Microsoft SQL Server database to a virtual key name, hard-coded in Microsoft Dynamics CRM for encrypting data in the configuration database. This setting is only available when you use a configuration file.

</encryptionkeys>

</configdb>

<LaunchReportingExtensionsSetup>"false" / "true"</LaunchReportingExtensionsSetup>

Optional element that specifies whether to start Microsoft Dynamics CRM Reporting Extensions Setup immediately after Microsoft Dynamics CRM Server Setup completes. By default, the value for this element is false and Microsoft Dynamics CRM Reporting Extensions Setup will not start after Microsoft Dynamics CRM Server Setup completes. Additionally, Microsoft Dynamics CRM Reporting Extensions Setup will only start when the following conditions are true:

  • Microsoft Dynamics CRM Server Setup will be creating or upgrading the first organization in the deployment
  • The specified Report Server computer is the local computer where Setup is running

For more information, see:

Sample server XML configuration file

Sample server XML configuration file for installing with pre-created groups