Configuring Microsoft Dynamics NAV Server

When you run Microsoft Dynamics NAV 2013 Setup and install Microsoft Dynamics NAV Server, you can provide configuration information that is then used as the configuration for the default Microsoft Dynamics NAV Server instance.

After you install Microsoft Dynamics NAV Server, you can change any of the settings you provided during Setup, or any of numerous other Microsoft Dynamics NAV Server settings, using either the Microsoft Dynamics NAV Server Administration tool or the Microsoft Dynamics NAV PowerShell cmdlets for Microsoft Dynamics NAV 2013.

This topic describes the Microsoft Dynamics NAV Server settings you can configuring during Setup, and the larger set of Microsoft Dynamics NAV Server settings you can configure after Microsoft Dynamics NAV Server is installed.

Note

Each Microsoft Dynamics NAV Server instance has its own settings.

Configuring Microsoft Dynamics NAV Server in Setup

You can configure the default instance of Microsoft Dynamics NAV Server when running Microsoft Dynamics NAV 2013 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 along with the Microsoft Dynamics NAV Server Administration tool.

• Developer 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.

Settings

The list of parameters that you see in the Specify parameters pane varies depending on which components you have selected for configuration. When you install Microsoft Dynamics NAV Server, you are prompted for settings relating to Microsoft Dynamics NAV Server itself and to the SQL Server computer and instance Microsoft Dynamics NAV Server will connect to.

Important

All parameters identified with an asterisk in Setup are required parameters. You cannot continue in Setup until you provide values for these parameters.

Category/Parameter	Description
Install Location/ Destination Folder (x86)	Specifies the destination folder for 32-bit components. You cannot install Microsoft Dynamics NAV Server on computers running 32-bit editions of Windows.
Install Location/ Destination Folder	Specifies the destination folder where Microsoft Dynamics NAV Server will be installed.
Server/ Send Feedback	When you set this parameter to Yes, Microsoft Dynamics NAV Server will collect basic information about your hardware configuration and about how you use Microsoft Dynamics NAV Server, and send it to Microsoft. Microsoft uses this information to identify trends and usage patterns and to improve its software. For more information, see Customer Experience Improvement Program and Microsoft Dynamics NAV Server.
Server/ Service Name	Specifies the name of the Microsoft Dynamics NAV Server instance. For information about Microsoft Dynamics NAV Server instances, see Managing Microsoft Dynamics NAV Server Instances. The instance name must not include spaces. Default: DynamicsNAV70
Server/ Service Account	Specifies the computer account that Microsoft Dynamics NAV Server uses to log on. For more information, see How to: Create a Microsoft Dynamics NAV Server Instance. Default: NT AUTHORITY\NETWORK SERVICE
Server/ Service Account Password	Specifies the password for the specified server account. The password is used only during installation and is not stored on the target computer. For local built-in computer accounts such as NT AUTHORITY\NETWORK SERVICE, this parameter is ignored.
Server/Client Services Port	The listening TCP port for RoleTailored clients. Default: 7046 Valid range: 1-65535
Server/SOAP Services Port	The listening HTTP port for Microsoft Dynamics NAV SOAP web services. Default: 7047 Valid range: 1-65535
Server/OData Services Port	The listening HTTP port for Microsoft Dynamics NAV OData web services. Default: 7048 Valid range: 1-65535
Server/ Add Rule to Firewall	Specifies whether Microsoft Dynamics NAV Setup adds a rule to Windows Firewall to allow Microsoft Dynamics NAV Server instances on the target computer to communicate with RoleTailored clients on other computers, through the specified Client Services Port. The default value is Yes for the Client or Server installation options, where the assumption is that Microsoft Dynamics NAV Server is installed on a different computer from the RoleTailored client, and No for the Demo and Developer options, where the assumption is that the Microsoft Dynamics NAV Server is installed on the same computer as the RoleTailored client. If the target computer uses a firewall other than Windows Firewall, or if networking is not configured on the target computer, then this option must be set to No or Setup will not be able to complete successfully.
SQL Server Database Components/ SQL Server	Specifies the computer running SQL Server.
SQL Server Database Components/ SQL Server Instance	The SQL Server instance Microsoft Dynamics NAV Server connects to. If you leave this parameter blank, Microsoft Dynamics NAV Server connects to the default SQL Server instance. Default: NAVDEMO Use an empty string to specify a non-named (default) SQL Server instance. Important If you are installing the CRONUS International Ltd. demonstration database, Microsoft Dynamics NAV 2013 Setup may automatically install SQL Server 2012 Express even if there is already a valid version of SQL Server on the target computer, unless you create an instance named NAVDEMO in SQL Server before you run Microsoft Dynamics NAV Setup. For more information, see Installation Considerations for Microsoft SQL Server.
SQL Server Database Components/SQL Database	Specifies the database name. Default: Demo Database NAV (7-0)

Choose 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 using any of the methods described in the following section.

Configuring Microsoft Dynamics NAV Server after Installation

After you install Microsoft Dynamics NAV Server, you can change any of the settings you provided during Setup, or any of numerous other Microsoft Dynamics NAV Server settings, in any of the following ways:

1. Using the Microsoft Dynamics NAV Server Administration tool. See Microsoft Dynamics NAV Server Administration Tool.

2. Using the Microsoft Dynamics NAV PowerShell cmdlets for Microsoft Dynamics NAV 2013. See Microsoft Dynamics NAV Windows PowerShell Cmdlets.

3. By directly editing CustomSettings.config, the Microsoft Dynamics NAV Server configuration file. By default, this file is located in C:\Program Files\Microsoft Dynamics NAV\70\Service\Instances\<instancename>. We recommend that you do not directly edit the configuration file, because if you make any mistakes in typing, then you may not be able to start the instance.

Important

After you modify a Microsoft Dynamics NAV Server setting, you must restart the associated Microsoft Dynamics NAV Server instance before any changes can take effect.

Settings in the Microsoft Dynamics NAV Administration Console

In the following table, Microsoft Dynamics NAV Server Administration tool setting names are used. Settings names in the CustomSettings.config are slightly different. These names are shown in the Description column. Quotation marks are required for all values.

Note

You must choose Edit in the Microsoft Dynamics NAV Server Administration tool before you can modify any values.

Tab	Setting	Description
General	Credential Type	Specifies the authentication mechanism for Microsoft Dynamics NAV users of this Microsoft Dynamics NAV Server instance. The options are Windows, Username, NavUserPassword, and ACS. For more information, see Users and Credential Types. Default: Windows
General	Database Instance	The name of the SQL Server database instance to connect to. If the value is a null string (""), Microsoft Dynamics NAV Server connects to the default SQL Server instance. Default: NAVDEMO
General	Database Name	The name of the Microsoft Dynamics NAV database in SQL Server. Default: "Demo Database NAV (7-0)"
General	Database Server	A valid network name for the computer running SQL Server. Default: The computer you selected in Microsoft Dynamics NAV Setup.
General	Data Cache Size	The contextual size of the data cache. Default: 9
General	Debugging Allowed	Specifies whether C/AL debugging is allowed for this Microsoft Dynamics NAV Server instance. Default: Enabled
General	Enable Debugging	Specifies whether the Microsoft Dynamics NAV Server instance starts with debugging enabled. If this option is enabled, the following occurs: When the RoleTailored client first connects, all C# files for the application are generated. C# files persist between Microsoft Dynamics NAV Server restarts. Application objects are compiled with debug information. Default: Not enabled
General	Send Feedback	When this setting is enabled, the Microsoft Dynamics NAV Server instance collects basic information about your hardware configuration and about how you use Microsoft Dynamics NAV Server, and sends it to Microsoft. Microsoft uses this information to identify trends and usage patterns and to improve its software. Default: Not enabled For more information, see Customer Experience Improvement Program and Microsoft Dynamics NAV Server.
General	Enable Encryption on SQL Server Connections	Specifies whether the SQL connect string should request encryption when connecting to SQL Server services.
General	Max Concurrent Calls	The maximum number of concurrent client calls that can be active on this Microsoft Dynamics NAV Server instance. Default: 40 Range: 1 - 2,147,483,647 You can also use MaxValue as a value to indicate no limit.
General	Metadata Provider Cache Size	Specifies the number of objects that can be cached. Set this value to 0 to disable caching. Default: 150
General	Network Protocol	Specifies the network protocol for accessing the database. Valid values: Default, Named, Sockets, MultiProtocol. Default: Default
General	Services Default Time Zone	Specifies the time zone in which web service and NAS services calls are run. Values: UTC All business logic for web services and NAS services on the server instance runs in Coordinated Universal Time (UTC). This is how all web services business logic was handled in Microsoft Dynamics NAV 2009 and Microsoft Dynamics NAV 2009 SP1. Server Time Zone Services use the time zone of the computer running Microsoft Dynamics NAV Server. <ID of any time zone recognized by the current version of Windows> Specifies any Windows time zone as defined in the system registry under HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. For example, Romance Standard Time Default: UTC
General	Session Event Table Purge Frequency	Specifies the day of the week and the start time when the Session Event table is queried for purging. The day-of-the-week part of the value is an integer from 0 (Sunday) to 6 (Saturday). The time part of the value is a valid time of the day expressed in the format hh:mm, where hh is a value from 1 to 24. Default: 0 6:00 That is, 6:00 a.m. on Sunday.
General	Session Event Table Retain Period	An integer value specifying how many months events in the Session Events table are retained. Default: 3
General	SQL Command Timeout	The contextual timeout for a SQL command. Default: 0:30:00
General	Enable trust of SQL Server Certificate	Specifies whether Microsoft Dynamics NAV Server should trust the SQL Server certificate.
General	Use NTLM Authentication	Specifies whether NTLM authentication is enabled for web services. To require Kerberos authentication, disable this option. Default: Not enabled
Client Services	Certificate Thumbprint	If you use security certificates to protect communications between RoleTailored clients and Microsoft Dynamics NAV Server over an open or wide-area network, you must provide the certificate thumbprint to Microsoft Dynamics NAV Server by updating this setting. See Walkthrough: Implementing Security Certificates in a Test Environment and How to: Implement Security Certificates in a Production Environment.
Client Services	Enable Certificate Validation	Specifies whether validation should be performed on the security certificate. Default: Enabled
Client Services	Chunk Size	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.
Client Services	Compression Threshold	The threshold in memory consumption at which Microsoft Dynamics NAV Server starts compressing datasets, in kilobytes. Default: 64
Client Services	Enable Client Services	Specifies whether RoleTailored client services are enabled for this Microsoft Dynamics NAV Server instance. Default: Enabled
Client Services	Idle Client Timeout	The interval of time that a Microsoft Dynamics NAV Server client session can remain inactive before the session is dropped. Time interval format: [dd.]hh:mm:ss[.ff] Where: dd: days hh: hours mm: minutes ss: seconds ff: hundredths of a second You can also use MaxValue as a value to indicate no timeout. This is the default value.
Client Services	Max Concurrent Connections	Specifies the maximum number of concurrent client connections that the current Microsoft Dynamics NAV Server instance accepts. Default: 150 You can also use MaxValue as a value to indicate no limit.
Client Services	Max Items in Object Graph	The maximum number of objects to serialize or deserialize. Default: 512
Client Services	Max Number of Orphaned Connections	Specifies the maximum number of orphaned connections to be kept alive simultaneously for the time that is specified by ReconnectPeriod. A connection is said to be orphaned when the client is involuntarily disconnected from Microsoft Dynamics NAV Server. Default: 20 You can also use MaxValue as a value to indicate no limit.
Client Services	Max Upload Size	The maximum size of files that can be uploaded to or downloaded from Microsoft Dynamics NAV Server, in megabytes. Use this setting to avoid out-of-memory errors. Default: 5
Client Services	Operation Timeout	The maximum amount of time that Microsoft Dynamics NAV Server can take to return a call from the client. Time span format: [dd.]hh:mm:ss[.ff] Where: dd: days hh: hours mm: minutes ss: seconds ff: hundredths of a second You can also use MaxValue as a value to indicate no timeout. This is the default value.
Client Services	Port	The listening TCP port for RoleTailored clients. Default: 7046 Valid range: 1 - 65535
Client Services	Prohibited File Types	Specifies a series of file extensions, delimited by semi-colons. Microsoft Dynamics NAV Server will not store files of any of the specified types when requested to do so by clients. Example values * (asterisk)All file types are prohibited. Empty string ("")All file types are allowed. List of file types separated by semi-colons. For example, "txt;xml;pdf". Microsoft Dynamics NAV Server will not store files of any of the specified types when requested to do so by clients.
Client Services	Protection Level	Specifies the security services for protecting the data stream between RoleTailored clients and Microsoft Dynamics NAV Server. All RoleTailored clients connecting to the Microsoft Dynamics NAV Server instance must have the same ProtectionLevel value in their ClientUserSettings.config files. See Configuring the Windows Client. For background information on transport security, see Understanding Protection Level (links to MSDN Library). Default: EncryptAndSign Values: EncryptAndSign, Sign, None
Client Services	Reconnect Period	The amount of time during which a client can reconnect to a running instance of Microsoft Dynamics NAV Server. Time span format: [dd.]hh:mm:ss[.ff] Where: dd: days hh: hours mm: minutes ss: seconds ff: hundredths of a second Default: 00:10:00 You can also use MaxValue as a value to indicate no time limit.
Client Services	Token Signing Key	Specifies the 256-bit symmetric signing obtained from the Azure Management Portal. This parameter is relevant only when Credential Type, on the General tab, is set to ACS.
SOAP Services	Enable SOAP Services	Specifies whether SOAP web services are enabled for this Microsoft Dynamics NAV Server instance. Default: Enabled
SOAP Services	Max Message Size	The maximum permitted size of a SOAP web services request, in kilobytes. Default: 1024
SOAP Services	Port	The listening HTTP port for Microsoft Dynamics NAV SOAP web services. Default: 7047 Valid range: 1 - 65535
SOAP Services	Enable SSL	Specifies whether SSL (https) is enabled for the SOAP web service port. For more information, see Walkthrough: Configuring Web Services to Use SSL (SOAP and OData). Default: Not enabled
OData Services	Default Company	Specifies the default company that is used if the user has never created a Microsoft Dynamics NAV client connection.
OData Services	Enable OData Services	Specifies whether OData web services are enabled for this Microsoft Dynamics NAV Server instance. Default: Enabled
OData Services	Max Page Size	Specifies the maximum number of entities returned per page of OData results. See Server-Driven Paging in OData Web Services. Default: 1000
OData Services	Port	The listening HTTP port for Microsoft Dynamics NAV OData web services. Default: 7048 Valid range: 1 - 65535
OData Services	Enable SSL	Specifies whether SSL (https) is enabled for the OData web service port. For more information, see Walkthrough: Configuring Web Services to Use SSL (SOAP and OData). Default: Not enabled
NAS Services	Company	Specifies the Microsoft Dynamics NAV company that opens when NAS services start. See Configuring NAS Services.
NAS Services	Enable Debugging	When this setting is enabled, the NAS services session waits 60 seconds before executing the first C/AL statement, to allow time for activating and attaching the NAV Debugger to the NAS services session. Default: Not enabled
NAS Services	Startup Argument	Specifies a string argument to be used when NAS services start. The argument typically specifies an application type, sometimes with additional configuration information. Example values: "OSYNCH" "JOBQUEUE"
NAS Services	Startup Codeunit	Specifies the codeunit that contains the method that will be called by the NASStartupMethod setting. Example values: 0 When NASStartupCodeunit is set to 0, NAS Services do not start. This is the default value. 1 When NAS services start they run the trigger specified by the NAS Startup Method in codeunit 1. 450 When NAS services start they run codeunit 450 (Job Queue – NAS Start Up), and call the method specified by NASStartupMethod. Note When the codeunit specified by NASStartupCodeunit is a single instance codeunit, the NAS service session will remain alive even after executing all code in the specified NASStartupMethod. For information on single instance codeunits, see Using Codeunits.
NAS Services	Startup Method	Specifies the method that will be called in the NASStartupCodeunit. Example values: "" If no start method is specified (null string), the OnRun trigger is called. StartNAS NAS services runs the StartNAS method in the NAS Startup Codeunit.
Management Services	Enable Management Services	Specifies whether Microsoft Dynamics NAV Server Administration tool is enabled for this Microsoft Dynamics NAV Server instance. Default: Enabled
Management Services	Port	The listening TCP port for the Microsoft Dynamics NAV Server Administration tool. Default: 7045 Valid range: 1 - 65535

Using the Microsoft Dynamics NAV PowerShell Cmdlets to Modify Settings

Use the Set- cmdlets to modify a setting with the Microsoft Dynamics NAV PowerShell API. For example, you can change the value for DatabaseServer to DatabaseServer.Domain.Com for the server instance named MyInstance by executing this cmdlet:

Set-NAVServerConfiguration MyInstance -KeyName DatabaseServer -KeyValue DatabaseServer.Domain.Com

To display all the Set- cmdlets on the Windows PowerShell console, use the following command:

Get-Help Set-NAVServer*

See Also

Concepts

Microsoft Dynamics NAV Server Administration Tool
Enhancing Microsoft Dynamics NAV Server Security