As you run Microsoft Dynamics NAV 2009 Setup, you can provide configuration information for the RoleTailored client. This information is then saved in the ClientUserSettings.config file.
A separate instance of the ClientUserSettings.config file is maintained for each client user. On Windows Server 2003 or Windows XP, the location of this file is Documents and Settings\\Local Settings\Application Data\Microsoft\Microsoft Dynamics NAV.
On Windows 7, Windows Vista, or Windows Server 2008, the location is Users\\AppData\Local\Microsoft\Microsoft Dynamics NAV.
This file is hidden by default. Change your folder options in Windows Explorer to view hidden files before you edit the ClientUserSettings.config file.
Configuring the RoleTailored Client in Setup
You can configure the RoleTailored client when running Microsoft Dynamics NAV 2009 Setup. You must first select the RoleTailored client as a component to install. To do this, select one of the following Installation Options that includes Microsoft Dynamics NAV Server:
You can also customize your installation and customize the list of components to install. For more information, see How to: Choose Components to Install.
After you specify an installation option or customize your component list, the Specify parameters pane is displayed in Setup. Click RoleTailored Client to open the Installation Parameters pane. The underscore indicates that this component is configurable.
Settings
The list of parameters that you see in the Specify parameters pane depends on which components that you have selected for configuration. The following parameters pertain to the RoleTailored client.
| Parameter | Description |
|---|
Server Name | The name of the computer running Microsoft Dynamics NAV Server for this client. Default value: Blank if you install using the Client installation option or localhost if you install using the Developer Environment installation option or a custom installation. |
Server Port | The listening TCP port for the computer running Microsoft Dynamics NAV Server for this client. Default value: 7046  Caution If you specify an invalid port number in Setup, then the RoleTailored client cannot connect to Microsoft Dynamics NAV Server. You will receive the following message when you attempt to open the RoleTailored client: The program could not create a connection to the server. Do you want to try again?If you click No, then the Select Server window opens. Correct the port number by typing a string in this format in the Server name field: servername:port/ServerInstance
|
Click Apply when you have finished entering values to return to the Specify parameters pane in Setup.
After you finish running Setup, you can modify Microsoft Dynamics NAV Server settings.
Configuring the RoleTailored Client After Installing
After you install the RoleTailored client, configuration settings are stored in the ClientUserSettings.config file. If you have configured the RoleTailored client in Setup, then your setting values are included in this file.
In addition to the settings that you can configure in Setup, the ClientUserSettings.config file contains other settings for the RoleTailored client. After you modify the ClientUserSettings.config file, you must restart the RoleTailored client for changes to take effect.
Settings in the ClientUserSettings.config File 
The ClientUserSettings.config file is an .xml file that you can edit with any text editor. Quotation marks are required for all values.
| Note |
|---|
The ClientUserSettings.config file is hidden by default. |
The following settings are available.
| Setting | Description |
|---|
Server | The name of the computer running Microsoft Dynamics NAV Server for this client. Default value: Empty string if you installed using the Client installation option or localhost if you installed using the Developer Environment installation option or a custom installation. |
ServerInstance | The name of the computer running Microsoft Dynamics NAV Server. Default value: DynamicsNAV You may need to modify this value if you have more than one instance of Microsoft Dynamics NAV Server installed on a single-server computer. For more information, see Walkthrough: Accessing Multiple Microsoft Dynamics NAV Databases from a Single Microsoft Dynamics NAV Server Computer. |
ServerPort | The listening TCP port for the computer running Microsoft Dynamics NAV Server for this client. Default value: 7046 |
ProtectionLevel | The security services for protecting the client/server data stream. This value must match the value that is specified in the Microsoft Dynamics NAV Server configuration file. For more information, see Configuring Microsoft Dynamics NAV Server. Default: EncryptAndSign Values: EncryptAndSign, Sign, None |
CompressionThreshold | The threshold in memory consumption at which the RoleTailored client starts compressing datasets, in kilobytes. Default: 64 |
ChunkSize | The default size for a chunk, in kilobytes. Default: 28. The range of values is from 4 to 80. |
AllowNtlm | The value for whether NTLM fallback is permitted for authentication. To require Kerberos authentication, set this value to false. Default value: true |
ServicePrincipalNameRequired | If this parameter is set to true, then the client can only connect to a Microsoft Dynamics NAV Server service that has been associated with a service principal name (SPN). If this parameter is set to false, then the client attempts to connect to the configured Microsoft Dynamics NAV Server service regardless of whether that service is associated with an SPN. For more information about SPNs, see How To: Set Up Delegation. Default: false |
OpenConnectionTimeout | The maximum amount of time to wait before determining that the client attempt to connect to Microsoft Dynamics NAV Server has failed. Time span format: [dd.]hh:mm:ss[.ff] Where: You can also use MaxValue to indicate no timeout. Default: 00:00:30 |
UnknownSpnHint | This is a parameter the RoleTailored client can use to establish connections more quickly. Do not modify this parameter. |
UrlHistory | A comma-delimited list of servers that is displayed in the Select Server window when you click the drop-down arrow in the Server name field. This parameter is not present after you install the RoleTailored client, but it is created and populated once the user enters a server name in the field. You can create and populate this field after installing the RoleTailored client. This gives the user a list of servers from which to choose. Example: |