Microsoft Dynamics AX 2012 Server Configuration (form) [AX 2012]

Updated: October 10, 2016

Applies To: Microsoft Dynamics AX 2012 R3, Microsoft Dynamics AX 2012 R2, Microsoft Dynamics AX 2012 Feature Pack, Microsoft Dynamics AX 2012

Click Start > Administrative Tools > Microsoft Dynamics AX 2012 Server Configuration.

Use the Microsoft Dynamics AX 2012 Server Configuration utility to change security, performance, database, and connection settings for an instance of Application Object Server (AOS).


Only members of the Administrators group on the local computer can change configurations.

The following tables provide descriptions for the controls in this form.



Application Object Server instance

Select the AOS instance that you want to configure. You cannot change settings for the original configuration. If you want to change any settings, you must create a new configuration.


Specify the name of the current group of settings for the AOS instance.


Select the task that you want to perform:

  • Open configuration file – Open a file that contains configuration settings.


    Although you can use the Open command to view a saved configuration, Microsoft Dynamics AX does not store the settings from the file that you open in the registry. To save the settings from a configuration file to the registry, you must use the Import command.

  • Close configuration file – Close a configuration file after you have finished reviewing or changing settings.

  • Save configuration file – Save the changes that you have made to the active configuration file.

  • Save configuration as file – Save the current configuration to a file. Use this command to store an offline copy of the settings that you have been using.

  • Import configuration from file – Import configurations from a stored file into the registry.

  • Export configuration to file – Export the configuration that is currently active to a file. Use this command when you want to copy the configuration to an AOS instance on another computer.

  • Export all – Export all configurations to a file. You can then copy all configurations from one AOS instance to another computer.

  • Create configuration – Create a new configuration by using the Create Configuration dialog box. The new configuration can be based on either the configuration that is currently selected or the default configuration.

  • Delete configuration – Delete the current configuration.

  • Rename configuration – Rename the current configuration.



Application Object Server

Specify startup, port, and development options for an AOS instance.

Database Connection

Specify information about server and database connections.

Database Tuning

Specify database settings to adjust performance.


Specify settings for compression and processor affinity to adjust performance.



Alternate bin directory

Specify the location of a directory that contains an alternate kernel text data file. This file is one of the Microsoft Dynamics AX label files.

Configuration command to run at kernel startup

Enter the configuration commands that are run when the AOS instance starts. For more information, see Execute configuration commands.

TCP/IP port

Specify the TCP/IP port that the AOS instance uses to connect to clients.

Services WSDL port

The port that is used by AOS services. You cannot change the services port. If you want to specify different services ports, you must install a new instance of AOS and specify the port numbers of the services ports in Setup.

Allow clients to connect to printers on this server

Select this option to enable client computers to print from the active AOS instance. The print option in the Microsoft Dynamics AX 2012 Configuration utility must also be enabled. For more information about how to print from an AOS instance, see Configure an AOS instance to print.

Enable breakpoints to debug X++ code running on this server

Select this option to enable clients to trace their interactions with the AOS instance. For more information about how to debug Microsoft Dynamics AX, see Microsoft Dynamics AX Debugger.

Enable global breakpoints

Select this option to debug X++ code that is invoked by using Query Services. Query Services use Query Builder, which is a set of X++ classes that are invoked by services. Query Services and Query Builder use the interpreted mode for remote procedure call (RPC). All other Microsoft Dynamics AX services use the common integrated language (CIL). The infrastructure of Microsoft SQL Server Reporting Services is the largest consumer of Query Builder's X++ classes. The Reporting Services Report Data Provider (RDP) is based on Query Builder and requires that this option be enabled. Otherwise, debugging cannot be performed.

Enable the hot-swapping of assemblies for each development session

Select this option if you want to deploy assemblies to the server without restarting the AOS instance. For more information, see How to: Enable Hot Swapping of Assemblies.

Server name

Specify the computer that is running an instance of Microsoft SQL Server. Specify a connection in the format Servername\instancename.

Database name

Specify the name of the database that the AOS instance connects to.

Baseline database name

Specify the baseline model database. The baseline database was either specified during installation or created manually. The baseline database is used to perform code analysis.

Statement cache

Specify the number of statements in the cache. If you must increase the value in this field, validate that the value is appropriate, based on your data composition and query patterns. For more information about how to tune data access, see Tune data access settings.

Maximum buffer size

Adjust this value when queries that return a large number or rows are executing slowly. The default value is 24 kb. Increase the maximum buffer size value in small increments. If this adjustment has worked, the number of round trips to the database, as measured in Performance Monitor by the SQL Server statistics: batchrequestsPerSecond value should decrease. Stop increasing the value when the rate of improvement starts to diminish. For more information about how to tune data access, see Tune data access settings.

Local ODBC log file location

Specify the location of the ODBC log file.

Number of connection retries

Specify the number of times that the AOS instance tries to connect to the database before the connection fails.

Connection retry interval

Specify the interval in milliseconds between attempts to connect to the database.

Limit the number of inactive connections

Select this option if you want the AOS instance to limit the number of inactive connections to the database.

Maximum number of inactive connections

The maximum number of inactive connections to the database that the AOS instance retains. The default value is 20.

Generate ORDER BY clauses from WHERE clauses

Select this option to override the order of columns that is specified by the index on the data source. Instead, the order of columns that is specified in the WHERE clause is used.

Minimum packet size to compress (in KB)

Specify the minimum size of the data packets when data that is sent between the AOS instance and its clients is compressed. Data compression accelerates client-server communications. Use this field in low-bandwidth or high-latency network environments. Specify the smallest packet size that is useful. The amount of acceleration that you achieve decreases as the size of the packets increases.


Select this option if you want Microsoft Windows to determine the processor that hosts the AOS instance.


Select this option if you want to specify the processor that hosts the AOS instance.

Announcements: To see known issues and recent fixes, use Issue search in Microsoft Dynamics Lifecycle Services (LCS).