Command-line parameters to specify for the Microsoft Dynamics CRM-Exchange E-mail Router
Published: April 6, 2007
As part of the silent installation of Microsoft Dynamics CRM Server, you can specify the incoming and outgoing e-mail servers that will be used by the Microsoft Dynamics CRM Exchange-E-mail Router.
On This Page
You can use the command line to install Microsoft Dynamics CRM Server. One advantage to performing a command-line installation of Microsoft Dynamics CRM Server is that you can complete the installation unattended. An unattended installation lets you schedule or automate the installation to occur at a certain time, such as late at night, to minimize the impact of taking the server offline. Because software installations can be time-consuming processes, unattended installations have become a favorite of many administrators. Installing software in this manner is also known as a silent installation.
To do this, you must add XML elements to the setup configuration file. The setup configuration file is an XML text file that contains all the information that ServerSetup.exe (the Setup program) needs to complete the installation. As part of the file, you can identify the incoming Microsoft Exchange Server computer and the outgoing SMTP server that the Microsoft Dynamics CRM system will use.
Note For more information about the XML setup configuration file, including a sample and how to perform a command-line installation, see Chapter 19: Use the Command Line to Install Microsoft CRM of the Microsoft CRM 3.0 Implementation Guide.
Setup configuration file elements
There are three elements to add to the setup configuration file to specify the incoming Exchange Server computer and the outgoing SMTP server. These elements must be placed inside the <Server> tags of the XML configuration file. The following syntax and structure must be used:
<Server>
…
<Email>
<IncomingExchangeServer/>
<OutgoingSMTPServer />
</Email>
…
</Server>
Specify incoming Exchange Server computer
This entry specifies the computer running Exchange Server that will be used by Microsoft Dynamics CRM Server to route incoming e-mail messages. The element and attribute to add to the setup configuration file for the incoming Exchange Server computer is as follows, where ExchangeServerName is the computer name of the server computer that is running Exchange Server:
<IncomingExchangeServer name="ExchangeServerName"/>
Note This element adds the Exchange Server computer to the Active Directory PrivUserGroup group. If the user running ServerSetup does not have the appropriate permissions to add members to groups, this element should not be added to the setup configuration file.
Specify outgoing SMTP server
This entry specifies the Microsoft Dynamics CRM Server computer to use for outgoing e-mail messages. If this entry is not specified in the setup configuration file, ServerSetup will use the SMTP service that is running on the local computer where ServerSetup is running. The entry and attributes to add to the setup configuration file for the outgoing SMTP server computer is as follows, where SMTP_ServerName is the computer name of the computer on which Microsoft Dynamics CRM Server is installed (or is to be installed) and is running the SMTP Server service:
<OutgoingSMTPServer useDefault="False/True" name=”SMTP_ServerName” port=” useSSL=”False/True”
authenticate=”Anonymous/Basic/NTLM” username=”name_of_user”
password=”password_of_the_user” />
OutgoingSMTPServer attributes:
| • | useDefault: If you set this value to True, ServerSetup will use the default settings when installing the outgoing SMTP server computer. |
| • | SMTP_Port_Number: This is the TCP port number to use. The default port number is 25. |
| • | Authenticate: This value specifies the type of authentication to be used by the SMTP service. By default, anonymous authentication is used. The values for this attribute can be one of the following: |
| • | useSSL: Use secure socket layer (SSL) for SMTP protocol transport. If you set this attribute to False, the SMTP protocol transport will not use SSL. |
| • | username: Required if you use Basic or NTLM for authentication. This is the name of the user account that will be used by the outgoing SMTP server component. |
| • | password: Required if you use Basic or NTLM for authentication. This is the password of the account specified in the username entry. |
Important If the username and password attributes are used, the values must be saved in a secure location or should be removed from the setup configuration file after ServerSetup completes. This practice helps ensure that user account passwords are not exposed.
If you use anonymous authentication without SSL, use attribute values that are similar to the following:
<Email>
<IncomingExchangeServer name="ServerName"/>
<OutgoingSMTPServer useDefault="false" name="ExchangeServerName"
port="25" authenticate="Anonymous" useSSL="false" />
</Email>
If a user name and NTLM authentication are used, use attributes that are similar to the following:
<Email>
<IncomingExchangeServer name="ExchangeServerName"/>
<OutgoingSMTPServer useDefault="false" name="ServerName"
port="25" authenticate="NTLM" useSSL="false"
username="UserName" password="Password"/>
</Email>
For examples of Microsoft Dynamics CRM Server silent install files, view the following Microsoft Knowledge Base article:
How to install Microsoft Dynamics CRM 3.0 as a user who is not a domain administrator by using the minimum required permissions http://support.microsoft.com/kb/908984
