Microsoft Dynamics NAV Server is a component of the RoleTailored Architecture in Microsoft Dynamics NAV 2009.
When you run Microsoft Dynamics NAV 2009 Setup, you can provide configuration information for Microsoft Dynamics NAV Server. This information is then written by Setup to the CustomSettings.config file. If you install Microsoft Dynamics NAV Server to the default destination, then you can find the CustomSettings.config file after installation at C:\Program Files\Microsoft Dynamics NAV\60\service.
 Note |
|---|
|
The content in this topic only applies to Microsoft Dynamics NAV 2009 SP1. For Microsoft Dynamics NAV 2009 content, see Developer and IT Pro Help for Microsoft Dynamics NAV 2009. |
Configuring Microsoft Dynamics NAV Server in Setup
You can configure Microsoft Dynamics NAV Server when running Microsoft Dynamics NAV 2009 Setup. You must first select Microsoft Dynamics NAV Server as a component to install. To do this, select one of the following Installation Options that includes Microsoft Dynamics NAV Server:
-
Server Option installs Microsoft Dynamics NAV Server without any other components.
-
Developer Environment Option installs Microsoft Dynamics NAV Server with other components that are used for developing client applications.
You can also customize your installation and 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 page is displayed. Click Server to open the Installation Parameters page. The underscore indicates that this component is configurable.
Settings
The parameter list that you see in the Specify parameters pane depends on which components you have selected for configuration. The following parameters pertain to Microsoft Dynamics NAV Server.
| Parameter | Description |
|---|---|
|
Server Name |
The computer running Microsoft Dynamics NAV Server. |
|
Server Port |
The listening TCP port for Microsoft Dynamics NAV Server, which becomes part of the server's URL. Default value: 7046 Valid range: 1-65535 |
|
SQL Server |
The computer running SQL Server. |
|
SQL Database |
The SQL Server database. |
|
Web Service Port |
The listening HTTP port for Microsoft Dynamics NAV Web services. Default value: 7047 Valid range: 1-65535 |
Click Apply when you have finished entering values to return to the Specify parameters page in Setup.
After you finish running Setup, you can modify Microsoft Dynamics NAV Server settings by editing the CustomSettings.config file.
Configuring Microsoft Dynamics NAV Server After Installation
After you install Microsoft Dynamics NAV Server, configuration settings are stored in the CustomSettings.config file. By default, this file is located in C:\Program Files\Microsoft Dynamics NAV\60\Service. If you have configured Microsoft Dynamics NAV Server in Setup, then your setting values are also included in this file.
In addition to the settings that you configure in Setup, the CustomSettings.config file contains additional settings for Microsoft Dynamics NAV Server. After you modify the CustomSettings.config file, you must restart the Microsoft Dynamics NAV Server service. For more information about working with Windows services, see How to: Configure Windows Services.
Settings in the CustomSettings.config File
The CustomSettings.config file is an .xml file that you can edit with any text editor. It contains the following settings. Quotation marks are required for all values.
| Setting | Description |
|---|---|
|
NetType |
The network protocol used to access the database. Default value: Default Valid values: Default, NamedPipes, Sockets |
|
DatabaseServer |
The computer running SQL Server. |
|
DatabaseInstance |
The name of the SQL Server database instance to connect to. |
|
DatabaseName |
The name of the SQL Server database. |
|
ServerInstance |
A name that identifies the instance of Microsoft Dynamics NAV Server. Default: DynamicsNAV You may need to modify this value if you have more than one Microsoft Dynamics NAV Server instance 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 Microsoft Dynamics NAV Server, which becomes part of the server URL. Default value: 7046 Valid range: 1 - 65535 |
|
WebServicePort |
The listening HTTP port for Microsoft Dynamics NAV Web services. Default value: 7047 Valid range: 1 - 65535 |
|
WebServiceSSLEnabled |
The parameter for whether SSL (https) is enabled for the Web service port. Default value: false Values: true, false |
|
WebServicesMaxMsgSize |
The maximum permitted size of a Web services request, in kilobytes. Default: 512 |
|
WebServicesUseNTLMAuthentication |
Set this parameter to true if you are using PHP or Java to initiate a Web services connection to Microsoft Dynamics NAV and if the RoleTailored client, Microsoft Dynamics NAV Server, and SQL Server database are all on separate computers. See How to: Configure Web Services with Delegation. Default value: false |
|
OperationTimeout |
The maximum time that Microsoft Dynamics NAV Server can take to return a call from the client. Time span format: [dd.]hh:mm:ss[.ff] Where:
You can also use MaxValue to indicate no timeout. This is the default value. |
|
ProtectionLevel |
The security services for protecting the client/server data stream. All RoleTailored clients connecting to the Microsoft Dynamics NAV Server must have the same ProtectionLevel value in their ClientUserSettings.config files. See Configuring the RoleTailored Client. Default: EncryptAndSign Values: EncryptAndSign, Sign, None |
|
MaxConcurrentCalls |
The maximum number of concurrent client calls that can be active on Microsoft Dynamics NAV Server. Default: 40 Range: 1 - 2,147,483,647 To disable this setting, use a value of MaxValue. |
|
MaxConcurrentConnections |
Specifies the maximum number of concurrent client connections that the Microsoft Dynamics NAV Server accepts. Default: 150 You can also use MaxValue to indicate no limit. |
|
ClientReconnectPeriod |
The period during which a client can reconnect to a running instance of Microsoft Dynamics NAV Server. Time span format: [dd.]hh:mm:ss[.ff] Where:
Default: 00:10:00 You can also use MaxValue to indicate no limit on this period. |
|
MaxNumberOfOrphanedConnections |
Specifies the maximum number of orphaned connections to be kept alive simultaneously for the time that is specified by the ClientReconnectPeriod parameter. A connect is said to be orphaned when the client is involuntarily disconnected from Microsoft Dynamics NAV Server. Default: 20 You can also use MaxValue to indicate no limit. |
|
CompressionThreshold |
The threshold in memory consumption at which Microsoft Dynamics NAV Server starts compressing datasets, in kilobytes. Default: 64 |
|
MetadataProviderCacheSize |
The Metadata Provider cache size. The value specifies the number of objects to be cached. Set this value to 0 to disable caching. Default: 150 |
|
MaxUploadSize |
The maximum size of files that can be uploaded to or downloaded from Microsoft Dynamics NAV Server, in megabytes. Use this parameter to avoid out-of-memory errors. Default: 5 |
|
EnableDebugging |
The parameter for whether Microsoft Dynamics NAV Server starts with debugging mode enabled. If set to true, then this mode has three functions:
Default: false |
|
MaxItemsInObjectGraph |
The maximum number of objects to serialize or deserialize, in kilobytes. Default: 128 |
|
ChunkSize |
The default size for a chunk of data that is transferred between Microsoft Dynamics NAV Server and the RoleTailored client, in kilobytes. Default: 28. The range of values is from 4 to 80. |