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.

Dd355055.Important(en-us,NAV.70).gifImportant
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.

    Dd355055.note(en-us,NAV.70).gifNote
    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