Professional Documents
Culture Documents
02-Ax 2012 Admin Wkshp-Installation and Configuration
02-Ax 2012 Admin Wkshp-Installation and Configuration
Administration and
troubleshooting WorkshopPLUS
Chapter 2: Installation and Configuration
Student Lab Manual
Conditions and Terms of Use
Microsoft Confidential - For Internal Use Only
This training package is proprietary and confidential, and is intended only for uses described in the
training materials. Content and software is provided to you under a Non-Disclosure Agreement and
cannot be distributed. Copying or disclosing all or any portion of the content and/or software included
in such packages is strictly prohibited.
The contents of this package are for informational and training purposes only and are provided "as is"
without warranty of any kind, whether express or implied, including but not limited to the implied
warranties of merchantability, fitness for a particular purpose, and non-infringement.
Training package content, including URLs and other Internet Web site references, is subject to change
without notice. Because Microsoft must respond to changing market conditions, the content should not
be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the
accuracy of any information presented after the date of publication. Unless otherwise noted, the
companies, organizations, products, domain names, e-mail addresses, logos, people, places, and events
depicted herein are fictitious, and no association with any real company, organization, product, domain
name, e-mail address, logo, person, place, or event is intended or should be inferred.
Active Directory, Bing, Microsoft, Microsoft Dynamics, SQL Server, Visual studio, Windows PowerShell,
Windows Server, and Windows are either registered trademarks or trademarks of Microsoft Corporation
in the United States and/or other countries. Other Microsoft products mentioned herein may be either
registered trademarks or trademarks of Microsoft Corporation in the United States and/or other
countries. All other trademarks are property of their respective owners.
OBJECTIVES............................................................................................................................................ 1
INTRODUCTION........................................................................................................................................1
OVERVIEW..............................................................................................................................................2
Installation Types......................................................................................................................... 2
TROUBLESHOOTING..................................................................................................................................4
Install Preparation........................................................................................................................ 5
Install Clients.............................................................................................................................. 16
Initialization Checklist................................................................................................................. 19
Version Numbers........................................................................................................................ 25
Registry or File............................................................................................................................ 36
Hotfixes...................................................................................................................................... 38
Cumulative Updates................................................................................................................... 39
Service Packs.............................................................................................................................. 39
Microsoft Confidential
Installation and configuration 1
Objectives
The objectives are:
Introduction
Successfully installing Microsoft Dynamics AX requires more than running the Setup
program. It is important to complete all the required tasks to prepare the Microsoft
Dynamics AX environment, in addition to all post-installation tasks. A solid
installation is important to a successful implementation.
Scenario
Contoso is a mid-sized manufacturer of various audio products. Although their
customer base spans multiple countries, their target is mainly North America. They
plan to use much of the functionality within Microsoft Dynamics AX 2012 plus many
of the additional modules.
After a successful fiscal year, Contoso wants to broaden its market share by:
Challenge
The implementation consultant leading the implementation completed the needs
analysis, the necessary hardware and infrastructure is ready for the installation, and
Contoso is ready to start the installation of Microsoft Dynamics AX 2012.
Goal
The implementation consultant will install Microsoft Dynamics AX 2012 on Microsoft
Windows Server 2008 R2 with 25 clients. The implementation consultant must create
a database, AOS, and clients, each on their own computer.
Solution
The implementation consultant must follow these steps:
1. Start the Microsoft Dynamics AX 2012 Setup Wizard.
2. Complete the setup steps for each Microsoft Dynamics AX
components.
3. Use information that is collected from the planning steps to setup
the necessary information in the setup fields.
4. After finishing all the setup steps, make sure Microsoft Dynamics
AX will successfully start.
Overview
Installation Types
Two types of installation are available from the Setup wizard:
1. Custom installation.
5. Single-computer installation.
Custom installation
Select Custom installation to install specific Microsoft Dynamics AX components on
multiple computers. Use this type of installation in a production environment.
Single-computer installation
Select Single-computer installation to install a complete Microsoft Dynamics AX
system on one computer. Setup uses default settings to configure all components,
and new Microsoft Dynamics AX databases are created. User names and passwords
are the only input that is required. If you want to connect to an existing database or
specify other custom settings, you must perform a custom installation.
A single-computer installation includes the following components:
Databases
Microsoft Confidential
Installation and configuration 3
AOS
Enterprise Portal
Help server
Client
Debugger
Trace Parser
Management utilities
Database server
A Microsoft SQL Server database server hosts the database that stores Microsoft
Dynamics AX transaction data and application elements. These application elements
include customizations.
Report server
A report server is a server that runs Microsoft SQL Server Reporting Services (SSRS).
Analysis server
An analysis server enhances the reporting functionality in Microsoft Dynamics AX by
linking to Microsoft SQL Server Analysis Services (SSAS).
Microsoft Confidential
Installation and configuration 5
Web server
A web server hosts the websites that are required for some Microsoft Dynamics AX
features. These features include Enterprise Portal for Microsoft Dynamics AX, Help
server, Enterprise Search, and web services on Internet Information Services (IIS).
Domain controller
A domain controller in an Active Directory network manages user logons and access
to network and shared resources.
Messaging server
A messaging server enables email messages and instant messages to be sent and
received. The Microsoft Dynamics AX can use an email to send alerts to users. The
Microsoft Dynamics AX requires that the messaging server support SMTP.
Troubleshooting
In Microsoft Dynamics AX 2012, it is easier to troubleshoot problems with installation,
because log files and reports are easier to find. Because log files and reports are
saved to a single location, you do not spend time searching in multiple places.
In addition, a new Setup summary report is added. This report lists the components
that you installed, their installation status, and next steps, if applicable. You can
access the Setup log files and reports from links in the Setup wizard, or you can
navigate to the Setup Logs location in the folder where you installed Microsoft
Dynamics AX 2012.
Install Preparation
This section describes the preparation for installing Microsoft Dynamics AX.
Note: As a security best practice, we recommend that you prevent users from
making changes to this directory. Only read access is required to perform an
installation from the directory.
Note: Only Cumulative Updates for Microsoft Dynamics AX 2012 are supported
for slipstream, other type of hotfixes will need to be installed manually as per the
fix instructions.
Microsoft Confidential
Installation and configuration 7
Check Prerequisites
Run the prerequisite validation utility for Microsoft Dynamics AX to determine
whether a computer meets the requirements to install a Microsoft Dynamics AX
component. You can run the utility before you install any components in your
environment. If requirements are not met, the utility helps you to install or configure
most prerequisites.
Prerequisite validation is also built into Setup. Therefore, the same prerequisites are
validated when you install a component by using the Setup wizard.
Note: The prerequisite validation utility validates the software prerequisites that
Microsoft Dynamics AX depends upon. However, the utility does not verify
whether Microsoft Dynamics AX components that are also required are installed
or configured. For example, the utility verifies whether a supported version of
Windows is installed, but does not verify whether an AOS is running in the
environment. Prerequisite Microsoft Dynamics AX components are validated
when you run Setup.
a. Databases
b. Application Object Server (AOS)
c. Client
Microsoft Confidential
Installation and configuration 9
16. For information about all the prerequisites that were validated, click View report
to display the Microsoft Dynamics AX Prerequisite check report.
17. Resolve prerequisite issues. For many errors and warnings, the prerequisite
validation utility can attempt to resolve the issue for you:
18. After you have resolved the prerequisite issues, click Revalidate to run the
prerequisite validation again.
19. When you have finished validating prerequisites, click Close.
recommend that you run Windows Update to identify and install the latest
updates before you continue with the installation of Microsoft Dynamics AX.
On the computer where you plan to install the databases, run the prerequisite
validation utility to verify that system requirements have been met.
For more information on how to run the prerequisite validation utility, see:
https://technet.microsoft.com/en-us/library/gg731884.aspx
Make sure that you have the required permissions to install the database.
For more information on Verify that you have the
required permissions for installation, see:
https://technet.microsoft.com/en-
us/library/aa496457.aspx
Make sure that TCP / IP is enabled in SQL Server, and that you can connect to the
server.
Microsoft Confidential
Installation and configuration 11
However, it is possible to include your own models during the installation. Use the
following steps to include your models during the installation.
Best Practice: It is recommended that you create a different folder to store the
models received from different sources. For example, create a folder for each
independent software vendor (ISV) or each value-added reseller (VAR). Store the
model files received from the ISVs and VARs in their respective subfolders.
Warning: Do not copy your model files to the Standard folder. The Standard
folder must be used for models that are mandatory such as the axsys.axmodel
file.
27. Select the name of the computer that is running SQL Server from the Server
name list.
a. Accept the default database name of MicrosoftDynamicsAX, and then click
Next.
b. Accept the default baseline database name of MicrosoftDynamicsAXBaseline
and then click Next.
Important: Setup will create a new database using the name that you provide on
this page. Setup will display an error message if the database name that you
provided already exists.
28. On the Select additional models page, select the following models from the
Available Models grid and then click Next:
a. Foundation
b. Foundation Labels
Note: Setup lists all the models in the Model folder and all its subfolders. Setup
automatically selects the models from the Standard folder, such as the
Foundation model, and you cannot clear the selection. Select additional models
that need to be installed, if any.
Microsoft Confidential
Installation and configuration 13
Warning: It is possible to have models, or the .axmodel files, that are not
electronically signed. The Setup program cannot verify the publisher of an
unsigned model file. Importing an unsigned model file to the model store is a
security risk. Setup will display an error message if a selected model files does
not have a digital signature. Carefully review the models that you have selected
before you decide to continue with or cancel the installation.
29. On the Prerequisite Validation page, resolve any errors. When all errors are
resolved, click Next.
30. On the Ready to install page, click Install.
31. Confirm that the Setup installed the Microsoft Dynamics AX database
successfully. In case of errors, click View log file and review the installation log
for the Microsoft Dynamics AX database. Click Finish to close Setup.
32. Review the Setup Summary Report
On the computer where you will install the AOS instance, run the prerequisite
validation utility to verify that system requirements have been met.
For more information on how to run the prerequisite
validation utility, see Prerequisites article:
https://technet.microsoft.com/en-
us/library/gg731884.aspx
Verify that you have the appropriate permissions to install the AOS instance.
For more information on Verify that you have the
required permissions for installation, see:
https://technet.microsoft.com/en-
us/library/aa496457.aspx
Select a service account for the AOS service. Before you install an AOS instance,
you must determine which account you want the AOS service to run as. The AOS
Microsoft Confidential
Installation and configuration 15
For more information on how to set up an account for the AOS service, see
Create service accounts article: https://technet.microsoft.com/en-
us/library/dd362055.aspx
Choose a name for the AOS instance. We recommend that you use a uniform
naming convention for all aspects of the installation, such as the database name
and the name of the AOS instance. Because Microsoft Dynamics AX installations
typically include one database and multiple AOS instances, make sure that the
name of each AOS instance is unique but consistent with the naming convention.
For example, you can use a name such as CONTOSO_AX6_Live_AOS1, which
includes a shortened form of your business name, the Microsoft Dynamics AX
version, a code that describes the purpose of the installation, and an identifier for
the AOS instance.
Note: The instance name must not include any blank characters or any of the
following characters: ampersand (&), backslash (\), slash (/), colon (:), brackets ([]),
parentheses (()), angle brackets (<>), quotation marks (“”), question mark (?),
exclamation point (!), asterisk (*), percent (%), caret (^), or pipe (|).
You must install an initial AOS instance and complete the Initialization checklist
on that instance before you install additional AOS instances. If you install
additional AOS instances before you have completed the Initialization checklist,
those AOS instances will not start.
For more information on how to install additional AOS
instances, see Install multiple AOS instances article:
https://technet.microsoft.com/en-
us/library/ee355067.aspx
34. If the Setup Support files have not yet been installed on this computer, then
Select a file location page is displayed. The Setup Support files are required for
installation. Provide a file location or accept the default location and then click
Next. On the Ready to install page, click Install.
35. On the Select installation type page, click Custom installation, and then click
Next.
36. On the Select components page, select Application Object Server, and then
click Next.
37. On the Prerequisite Validation page, resolve any errors. When all errors are
resolved, click Next.
38. On the Select a file location page, select the location where 32-bit versions of
Microsoft Dynamics AX files should be installed.
39. On the Connect to a Microsoft SQL Server database page, in the Server name
box, type or select the name of the SQL Server computer. In the Database name
box, type or select the name of the Microsoft Dynamics AX database.
40. On the Configure an AOS instance page, assign a name to the AOS instance.
Optionally, you can specify the following ports:
Port Purpose Default
TCP / IP port Used by other Microsoft Dynamics AX 2712
components to communicate with the AOS.
Services Web Used by external applications to access the 8101
Services WSDL for AOS-based Microsoft Dynamics AX
Description web services.
Language
(WSDL) port
Services Used by external applications to access AOS- 8202
endpoint port based Microsoft Dynamics AX web services.
41. If you are installing a second AOS instance on a server, you must specify unique
port numbers. By default, each time that you install an additional AOS instance
on a computer, the port numbers increment by one. For example, the second
AOS instance on a computer would be assigned to TCP / IP port 2713 by default.
Port conflicts can cause one AOS to stop.
Note: It is recommended that you use a uniform naming convention for all
aspects of the installation, including the database name, the AOS name, and the
application file instance name. Because Microsoft Dynamics AX installations
typically include one database, one set of application files, and multiple AOS
instances, make sure that AOS instance names are consistent with the naming
convention, yet unique. For example, you might use a name like
CONTOSO_DYNAX6_Live_AOS1, which includes a shortened form of your
Microsoft Confidential
Installation and configuration 17
business name, the Microsoft Dynamics AX version, a code for the purpose of the
installation, and an identifier for the AOS instance.
42. On the Specify an AOS account page, select either the Network Service account
of the local computer or a domain account for the AOS service. If you select to
use a managed service account, make sure to specify the account in the format
Domain\AccountName$.
43. On the Prerequisite validation results page, resolve any errors. When there are
no errors, click Next.
44. On the Ready to install page, click Install.
45. The AOS Windows service might take several minutes to start the first time after
it is installed. To determine whether it has started, open Administrative tools>
Services, and review the status of the Microsoft Dynamics AX Object Server
service.
46. Setup grants the following permissions to the AOS account:
a. Adds the AOS account to the Microsoft Dynamics AX database as a user,
makes it a member of the db_ddladmin, db_datareader, and db_datawriter
database roles.
b. Grants the AOS account execute permissions to the stored procedures in the
Microsoft Dynamics AX database.
c. Adds the AOS account to the TempDB database as a user and makes it a
member of the db_ddladmin, db_datareader, and db_datawriter database
roles.
Note: If you change the AOS service account later, permissions will need to be
granted manually.
Warning: This section contains steps that tell you how to modify the registry. Be
aware that serious problems might occur if you modify the registry incorrectly. It
is recommended that you back up the registry before you modify it. If a problem
occurs, you can restore it.
Figure 3: Registry
If the AOS fails to start after you implement this registry key, verify in the Microsoft
Dynamics AX Server Configuration utility that the AOS is using a unique port. Port
conflicts prevent the AOS from starting.
Microsoft Confidential
Installation and configuration 19
Note: For most production environments, you will install multiple AOS instances,
each on a different server. You can use multiple AOS instances to support batch
processing and load balancing. If you plan to install multiple AOS on the same
computer, you must specify a unique port for each AOS otherwise port conflicts
will cause one or more AOS to stop.
Install Clients
This topic describes installation of the Microsoft Dynamics AX 2012 client.
When you install a Microsoft Dynamics AX client, the following components are
included:
For more information on deployment best practices that can help secure the
Microsoft Dynamics AX client, see: https://technet.microsoft.com/en-
us/library/hh202063.aspx
On the computer where you plan to install the client, run the prerequisite
validation utility to verify that system requirements have been met.
For more information on how to run the prerequisite
validation utility, see:
https://technet.microsoft.com/en-
us/library/gg731884.aspx
Installation Types
There are three different client installation types:
1. Business user
52. Developer
53. Administrator
Business user: The basic client is installed. This type of client installation is
appropriate for most users.
Developer: The client, the developer workspace, and additional files that are
required for development tasks such as compiling the application are installed.
Also, the debug settings are enabled by default for this type of install.
Administrator: The client, the developer workspace, and additional files that are
required for development tasks such as compiling the application are installed.
Microsoft Confidential
Installation and configuration 21
56. On the Modify Microsoft Dynamics AX installation page, click Add or modify
components, and then click Next.
57. On the Select components page, select Client and then click Next.
58. On the Prerequisite Validation results page, resolve any errors. When all errors
are resolved, click Next.
59. On the Select client preferences page, select the display language that is used
in the client, and specify whether you want Setup to create a desktop shortcut for
the client as well as the installation type and click Next.
Note: If you choose the Use a shared configuration file option, client
configuration settings will not be stored locally, and the Microsoft Dynamics AX
Configuration utility will not be installed on the client computer. If a
configuration file does not exist at the network location that you specify, a new
configuration file will be created.
Note: A configuration file includes the location of the client application. If the
Microsoft Dynamics AX client location differs between the computer generating
the configuration file and the computer using the configuration file, the client
using the file will not start. It is recommended that you create multiple
configuration files if the client is installed in different locations on different
computers. For example, the default location of the Microsoft Dynamics AX client
application differs between 32-bit and 64-bit operating systems. On a 64-bit
system, the default path is \Program files (x86)\Microsoft Dynamics AX. On a 32-
bit system, the default path is \Program Files\Microsoft Dynamics AX. If you have
clients on both operating systems, it is recommended that you create a
configuration file for each version of the operating system, and then specify the
appropriate file when installing clients.
61. On the Connect to an AOS instance page enter the following information and
choose Next.
a. The name of the computer running the AOS instance to connect to.
b. Accept the default TCP / IP port number
c. Accept the default Services WSDL port number
62. On the Prerequisite validation results page, resolve any errors.
63. When there are no errors, click Next.
64. On the Ready to install page, click Install.
65. After the installation is completed, click Finish to close the wizard.
Initialization Checklist
When users launch the Microsoft Dynamics AX client after a new installation, the
client will detect if this is a brand new installation or an upgrade by checking the
SYSSETUPLOG table and determine if it should display the initialization checklist or
the upgrade checklist.
The initialization checklist is intended for environments that are brand new to
Microsoft Dynamics AX when users have no data stored in the system.
Microsoft Confidential
Installation and configuration 23
Figure 5:
Initialization checklist
Note: If the goal were to install the software into a new environment such as a
test system using a restored copy of the production database, then the steps
would be different and may not require the initialization checklist.
The checklist will be displayed as soon as the client opens Microsoft Dynamics AX
client. To access the checklists manually click System
administration>Setup>Checklists>Initialization checklist. As each task is
completed, it is checked off by the system. Many of the tasks are one-time setup
options.
Users must be a member of the SYSADMIN role in Microsoft Dynamics AX to use the
initialization checklist. The person who installed Microsoft Dynamics AX automatically
becomes a member of the SYSADMIN role.
The initialization checklist has three main sections:
1. Prepare initialization
66. Synchronize database
67. Initialize system.
Some tasks are required and others are optional. If users would like to skip an
optional task, click the Mark as complete link and the step will change to a green
check mark.
For a new installation of a production environment, users might not want to skip any
of the optional tasks. However, if the installation is for demonstration or
development, skipping a task might save time.
Prepare Initialization
Compile application: Checks the layers and models installed, updates the
references, and makes sure that the application has no code conflicts and is ready
for use. This task is optional if users only have the SYS layer installed, but it must
be completed if there is more than one layer in your system. When the
application is compiled, the application source code is translated into binary code
that can be interpreted by the kernel. The binary code is stored in the database.
Note: If users do not have a license, they can set up Microsoft Dynamics AX in
demonstration mode. Demonstration mode provides all the functionality of
Microsoft Dynamics AX, and enables all configuration keys by default, but the
keys will expire. Always use customer license codes for production, User
Acceptance Testing (UAT), or a test environment.
Note: When a configuration key is disabled, the feature is removed from the user
interface. Unlike previous versions, the underlying tables are not removed.
Modify data types: Change the properties for data types without accessing the
Application Object Tree (AOT). You must be an administrator to make these
changes. All changes must be made before data is entered into the system. A
common example might be to change the number of decimal places on the
Amount data type, other changes are to the length of the Extended Data Type
(EDT) and the justification, which by default is left, justified.
Microsoft Confidential
Installation and configuration 25
Synchronize Database
Synchronize database (Required): Modifies the database
schema to match the most recent version of the
application code from the AOT.
The synchronization process creates all the tables and indexes Microsoft
Dynamics AX needs to operate. Since most SQL Server objects do not exist until
this task is complete, this is required in the new installation, when users do not
intend to restore an existing database. If errors are encountered during the
synchronization process, review the application event logs on the AOS server the
current client is connected to.
Initialize System
The Initialize system tasks cannot be accessed until the Synchronize database task is
complete.
Create legal entities: Identify the legal entities that must be represented in
Microsoft Dynamics AX database. This can be a single company or multiple
companies in your organization.
Set up system parameters: Specify shared system settings, including the system
language. The system language is the default language that is used by the
application for text translations of the menus, reports, and other content using
labels information.
o Workflow execution account: Used for running application business logic and
accessing Microsoft Dynamics AX data.
Import data: Enables users to import demonstration data or data that was
originally exported from Microsoft Dynamics AX (*.dat files). If users will be
working with a restored database this step is not required.
Initialize user profiles: Select the default user profiles to enable for Role Centers.
Role Centers are customizable home pages that deliver content relevant to your
role. This step can be completed outside of the checklist once the Role Centers
are installed.
Default user profiles are available for various roles in the organization, such as
chief financial officer and accounting manager. These profiles contain role specific
information, and determine the content that is displayed on Role Center pages.
Users must select the profiles that they want to use in their Microsoft Dynamics
AX system.
To complete this task outside of the checklist click Organization administration,
click Setup, click Role Center, and then click Initialize role center profiles.
Microsoft Confidential
Installation and configuration 27
Next steps
Install additional components or setup module specific parameters. See help for
those modules you are licensed for and which you plan to implement first. In this
course, additional components will be installed in later chapters.
Version Numbers
How to check the build numbers
There are a few ways to check the build numbers of your Microsoft Dynamics AX
2012 system:
The Kernel is the component executing the X++ Application code. So the Kernel
version is the version of the executable (Client, Server, and Business Connector).
Best practice
Kernel and application versions should be at the same service pack level.
Microsoft Confidential
Installation and configuration 29
Microsoft Dynamics AX Client and AOS Kernel Version should be the same build
Having multiple environments, one instance for the live environment, one
instance for development, and one instance for testing.
Change the application directory that an AOS instance points to, the database,
and whether a system allows for debugging.
Tuning Microsoft Dynamics AX 2012, save a configuration with the defaults, and
then change compression, database tuning, and tracing settings one at a time,
and save them as different configurations. Run Microsoft Dynamics AX 2012 with
each different configuration, and evaluate how it performs.
Note: The computer that is running the AOS, only members of the local
Microsoft Windows Power User group or Administrators group can change
configuration settings. Restrict membership in these groups, to reduce the
potential for malicious mischief.
Database
Connection ports
Note: After you make changes in the server configuration utility, the system
prompts you to restart the AOS instance. The restart affects all client and
database connections to the AOS instance. If you perform one or more of these
procedures on a production server, we recommend that you perform the
procedures during off-peak hours to prevent dropped connections for clients
and databases.
Microsoft Confidential
Installation and configuration 31
98. On the Application Object Server tab, in the TCP/IP port field, note which port
the AOS is running on. This information is needed to connect to the AOS.
99. On the Application Object Server tab, in the Services WSDL port field, note
which port is used for Services and Web Services in IIS.
100. On the Database Connection tab, validate that the AOS is connected to the
correct database. If not, change it.
101. Click OK to exit the configuration utility.
102. Click Yes on the dialog asking "The data for the AOS service has changed. Do
you want to restart the service?"
Tabs
Tab Description
AOS Specify startup, port, and development options for an AOS
instance.
Database Specify information about server and database connections.
Connection
Fields
Field Description
Alternate bin Specify the location of a directory that contains an alternate
directory kernel text data file. This file is one of the Microsoft
Dynamics AX label files.
Configuration Enter the configuration commands that are run when the
command to run at AOS instance starts.
kernel startup For more information on Execute configuration commands, see:
https://technet.microsoft.com/en-us/library/aa569627.aspx
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.
Enables clients to Select this option to enable client computers to print from
connect to printers the active AOS instance. The print option in the Microsoft
on this server Dynamics AX 2012 Configuration utility must also be
enabled.
For more information on Configure an AOS instance to print,
see: https://technet.microsoft.com/en-us/library/aa569633.aspx
Enable breakpoints Select this option to enable clients to trace their interactions
to debug X++ code with the AOS instance.
running on this For more information on how Microsoft Dynamics AX Debugger,
server see: https://technet.microsoft.com/en-us/library/aa569668.aspx
Enable global Select this option to debug X++ code that is invoked by
breakpoints 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 CIL. The infrastructure of SSRS
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- Select this option if you want to deploy assemblies to the
swapping of server without restarting the AOS instance.
assemblies for each For more information, on How to: Enable Hot Swapping of
development Assemblies, see: https://technet.microsoft.com/en-
session us/library/gg889279.aspx
Server name Specify the computer that is running an instance of SQL Server.
Specify a connection in the format Servername\instancename.
Database name Specify the name of the database that the AOS instance
connects to.
Microsoft Confidential
Installation and configuration 33
Baseline database Specify the baseline model database. The baseline database
name was either specified during installation or created manually.
The baseline database is used to perform code analysis.
Statement cache Specify the size of the statement cache. The recommended
size is less than 256 kilobytes (KB). A value that is larger
than 256 KB can cause memory issues on the server. If you
increase the value in this field, validate that the value is
appropriate, based on your data composition and query
patterns.
For more information on Tune data access settings, see:
https://technet.microsoft.com/en-us/library/aa569634.aspx
Maximum buffer Specify the maximum size of the buffer. The recommended
size size is less than 24 KB. A value that is larger than 24 KB can
cause memory issues on the server. If you increase the value
in this field, validate that the value is appropriate, based on
your data composition and query patterns.
For more information on Tune data access settings, see:
https://technet.microsoft.com/en-us/library/aa569634.aspx
Local Microsoft Specify the location of the ODBC log file.
Open database
Connectivity (ODBC)
log file location
Number of Specify the number of times that the AOS instance tries to
connection retries connect to the database before the connection fails.
Connection retry Specify the interval between attempts to connect to the
interval (in seconds) database.
Limit the number of Select this option if you want the AOS instance to limit the
inactive connections number of inactive connections to the database.
Maximum number The maximum number of inactive connections to the
of inactive database that the AOS instance retains. The default value is
connections 20.
Generate ORDER BY Select this option to override the order of columns that is
clauses from specified by the index on the data source. Instead, the order of
WHERE clauses columns that is specified in the WHERE clause is used.
Minimum packet Specify the minimum size of the data packets when data
size to compress (in that is sent between the AOS instance and its clients is
KB) 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.
Default Select this option if you want Microsoft Windows to
determine the processor that hosts the AOS instance.
Custom Select this option if you want to specify the processor that
hosts the AOS instance.
Microsoft Confidential
Installation and configuration 35
Note: The registration information for the server configuration is stored in the
following location:
HKEY_LOCAL_MACHINE\System\CurrentControlSet\services\Dynamics
Server\6.0\01\<configuration>
Logon company
Startup message
Startup commands
Debugging settings
Layer
Performance settings
Microsoft Confidential
Installation and configuration 37
Note: Only members of the Administrator or Power User group on the computer
can use the Microsoft Dynamics AX Configuration utility.
Note: 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.
Microsoft Confidential
Installation and configuration 39
Tabs
Tab Description
General Set startup options for a client. The options specify the location of
the log directory, the company that opens, the commands that
run on startup, and the messages that are displayed.
Connection Specify the AOS instance that the client connects to, and set
connection options for that AOS instance.
Developer Set development options. The options specify whether
debugging is enabled in the client or .NET Business Connector,
the default application layer that opens for the developer, and
license information for development.
Performance Specify cache settings to adjust Microsoft Dynamics AX
performance.
Buttons
Button Description
Add Open the Add Application Object Server instance dialog box,
where you can add an AOS instance to the list of available
instances.
Edit Edit an AOS instance.
Delete Delete an AOS instance from the list of available instances.
Configure Open the Windows Communication Foundation (WCF)
Services Configuration Editor tool, SvcConfigEditor.exe, if the tool is
installed. This tool is installed as a component of some
versions of the Windows SDK. This tool is also installed by
Microsoft Visual Studio 2010. The tool provides a graphical
user interface (GUI) that you can use to create and modify
configuration settings for services that are based on WCF.
For more information on Configuration Editor Tool, see:
https://msdn.microsoft.com/en-us/library/ms732009.aspx
Fields
Field Description
Microsoft Confidential
Installation and configuration 41
Registry or File
By default, the Microsoft Dynamics AX client reads configuration information from
the registry on the local computer. If you deploy many Microsoft Dynamics AX
clients, it can be difficult to maintain or troubleshoot configurations.
To enhance security and simplify client administration, we recommend that large
deployments must run the Microsoft Dynamics AX client as a remote application,
which means to use a common configuration file.
Note: The registration information for the client configuration is stored in the
following location:
HKEY_CURRENT_USER\Software\Microsoft\Dynamics\6.0\Configuration\<configu
ration>
Microsoft Confidential
Installation and configuration 43
Hotfixes
A hotfix is code that resolves selected bugs that affect key features or a significant
number of Microsoft Dynamics AX installations. A hotfix can address either a single
issue or a cumulative set of issues.
Microsoft publishes a corresponding Knowledge Base (KB) article for every hotfix that
is released for every Microsoft product. These KB articles describe the changes that
the hotfix makes to objects, database tables, or files, or other code.
Microsoft Dynamics AX has the following standard types of hotfix:
Application hotfixes
Application hotfixes are those that are provided by using application model
(.axmodel) files to any of the Microsoft application patch layers (SYP, GLP, FPP, SLP).
Unlike binary hotfixes, application hotfixes target a specific fix and are not cumulative
in nature.
Pre-processing hotfixes
Pre-processing hotfixes are applied to data upgrade scripts (for example,
DatabaseUpgrade) that are run on Microsoft Dynamics AX 4.0 and Microsoft
Dynamics AX 2009 systems before upgrading to Microsoft Dynamics AX 2012.
Cumulative Updates
A cumulative update (CU) is an update that contains all previous hotfixes to date.
Additionally, a CU contains fixes for issues that meet the criteria for hotfix
acceptance. These criteria may include the availability of a workaround, the effect on
the customer, the reproducibility of the problem, and the complexity of the code that
must be changed.
Service Packs
A service pack is a tested, cumulative set of all hotfixes and updates. Service packs
may also contain additional fixes for problems that have been found internally since
the release of the product, and a limited number of design changes or features that
were requested by customers.
Microsoft Confidential
Installation and configuration 45
u
p
d
a
t
e
t
h
a
t
t
h
e
f
i
l
e
o
r
f
o
l
d
e
r
i
s
u
s
e
d
f
o
r
AXUpdate.exe Binary and The Update wizard that you can run to
application install MSP and model files that are
updates required for the update.
Microsoft Confidential
Installation and configuration 47
Note: If you have customized your environment before you received a hotfix,
thoroughly review the KB article that describes the hotfix. Investigate any objects
that are affected by the hotfix to determine whether the changes that are
implemented by the hotfix should be merged with customizations in a higher
layer, such as BUS, VAR, USR, or CUS.
Back up the database that is being updated. By backing up the database, you can
roll back to a known, reliable version if you have to. In this manner, you can
reduce downtime if an unexpected error occurs.
Schedule a time when the fewest system users, or no users, are affected. As a best
practice, announce the time of the update in advance, to make sure that users are
aware of the pending update and the expected downtime. By notifying all users
of the time of the update, you can minimize data loss, data corruption, and loss
of productivity.
Make sure that the system runs in single-user mode while the hotfix is installed,
and that only the administrator is designated to perform the update. Because
changes to the code can affect AOS, the changes can affect users who are
currently on the system.
Microsoft Confidential
Installation and configuration 49
Troubleshooting
If errors or issues occur during or after installation of a hotfix, the hotfix must be
uninstalled, and the system must be rolled back. Follow these steps to restore your
system to the last known, reliable version:
1. If the hotfix installed any binary files, uninstall the hotfix by using the Add or
Remove Programs item in Control Panel.
122. Restore the database backups.
123. Synchronize the database, if synchronization is required, to return the
implementation to pre-update conditions.
124. Optional: If you require help troubleshooting the installation errors or issues,
open a support request by contacting your partner or VAR. Alternatively, if you
are enrolled in a support plan directly with Microsoft, you can log on to
CustomerSource and submit a new support request.
Note: Because the Microsoft Dynamics AX 2012 model store is part of the
Microsoft Dynamics AX database, when you update the database, you also
import all code updates.
125. Apply the database updates to any additional databases by exporting and
importing the model store.
126. Apply the AOS updates to any additional AOS instances.
127. Deploy changes to SSRS, and then to Enterprise Portal for Microsoft
Dynamics AX.
128. Mass deploy the updates to your clients.
For more information on Run AXUpdate in silent mode,
see: https://technet.microsoft.com/en-
us/library/hh538439.aspx
Important: Before you can run the Impact Analysis tool, you must install
KB974255. If you have installed Cumulative Update 1 for Microsoft Dynamics AX
2012, KB974255 is already installed. Otherwise, you must install KB974255 first.
Run AXImpactAnalysis.exe
1. Browse to the location where you extracted the files for the service pack, right-
click AXImpactAnalysis.exe, and then click Run as Administrator.
131. On the Welcome to Microsoft Dynamics AX Update Setup, Impact Analysis
Mode page, click Next.
132. On the License terms page, review the license terms. Select the option to
accept the license terms, and then click Next.
Microsoft Confidential
Installation and configuration 51
a. The model store that you select must be the same model store that is used
by the client configuration that you selected.
135. On the Select baseline model store page, select a baseline model store to
use for the impact analysis, and then click Next.
a. The model store that you select must be the same model store that is used
by the client configuration that you selected.
136. A list of affected objects is displayed. Click Impact Analysis to open the
Microsoft Dynamics AX client and view detailed results of the impact analysis.
You can use the Impact Analysis form to view details about the objects that are
affected by the update, and to export the results. You can perform the following
actions:
o Compare code: Click Compare to open the Comparison Results form. From
this form, the changes that were made to an object that was loaded during
the impact analysis can be compared with the same object in two other
layers.
o Review cross-references: The bottom pane of the tool loads the cross-
reference data for the selected object. The data that is presented resembles
the data that is presented in the Cross References Used By view. If cross-
reference data is not available, this pane provides an option to update the
cross-reference data. For new objects that do not exist in the AOT, no cross-
reference data is available.
8. Export the results of the impact analysis, so that you can quickly make changes
after you install the update. The following options are available. We recommend
that you select Impact Analysis State:
o Summary: Save the information about the objects that are loaded in the
form to an XML file that you select. Also save information about the layers
where the objects exist, and the number of cross-references.
o Cross Reference Data: Save more detailed information about the cross-
references of the objects by using Resource Description Format (RDF).
For more information on RDF, see:
http://www.w3.org/RDF/.
o Impact Analysis State (IAS): Save the objects that are loaded in the form to
an XML file. This file has an .ias file extension. After you save the objects to an
.ias file, you can load the same list of objects into the Impact Analysis form
later. This capability is helpful when you install a hotfix, because you might
want to save the list of objects before you start the installation. After the
installation is completed, you can reload the objects for additional analysis.
Microsoft Confidential
Installation and configuration 53
1. Start the Microsoft Dynamics AX client. When you launch the client, you receive
the following message: "The model store has been modified."
144. Click Start the software update checklist.
145. Complete the items on the checklist, in the order in which they are listed.
Checklist section Option and description
Upgrade Restart Application Object Server
preparation We recommend that you restart the AOS instance before you
start the client. However, if you did not restart the AOS
instance, restart it now by using this option.
Code upgrade Compile application
This option compiles X++ code for the application.
Compilation might require an hour or longer.
Detect code upgrade conflicts
This option creates upgrade projects that contain conflicting
model elements.
Compile into .NET CIL
After you have resolved any conflicts for the code upgrade,
you can use this option to compile the application into CIL
code for the Microsoft .NET Framework.
Data upgrade Detect update scripts (Required)
This option finds and registers update scripts that require
additional processing.
The appearance of the checklist varies, depending on
whether update scripts are detected.
Presynchronize
This option only appears if upgrade scripts were detected.
Synchronize database
This option is required even if update scripts were not
detected.
Launch data upgrade (required)
This option only appears if upgrade scripts were detected.
This option opens the data upgrade checklist.
Upgrade additional features
This option only appears if upgrade scripts were detected. This
option opens the Data upgrade cockpit form.
For more information on see Data upgrade cockpit (form), see:
https://technet.microsoft.com/en-us/library/aa572565.aspx
Microsoft Confidential