Search through blog..

Saturday, December 29, 2012

Step by Step installation procedure of Ax2012 Data Migration Framework (Beta 2)



This topic describes how to install the Data Migration Framework for Microsoft Dynamics AX 2012, Beta 2 version.

Before you begin, your environment must include the following components:




  1. A running version of Microsoft Dynamics AX 2012 that has been configured for your business.
  2. A running version of Microsoft SQL Server Integration Services that is running the same version of SQL Server that is hosting the Microsoft Dynamics AX business and model store database.
Important: Because the staging environment is highly normalized and may require significant processing bandwidth, we recommend that you increase the Maximum buffer size setting for your environment while you migrate data. Use the Server configuration utility to set the value.

Data Migration Framework components should be installed on: (You must run the installer locally on each computer)




  1. computers running Integration Services,
  2. on a computer running an Application Object Server (AOS) instance,
  3. and on a computer running the Microsoft Dynamics AX client.
You can Download the installation package for the Data Migration Framework, DataMigrationFrameworkSetup.zip, and extract it to a local folder
(from InformationSource which requires valid Partner source ID)


#1: Install the Data Migration Framework on Integration Services

On the computer running Integration Services, right-click DmfSetup.exe, and click Run as administrator.


Important: If you do not run Setup as an administrator, the Data Migration Framework DLLs will not be copied to the correct locations, nor registered.

In the Setup wizard, accept the license terms, and on the Select components to install page, click Data Migration Framework service.

The Prerequisite validation screen appears. If the computer passes the validations required, click Next. (And If the computer does not pass the validation, install the prerequisites, and then re-launch Setup)

On the Specify a service account page, enter the same account used for the AOS service, and then click Next.

On the Select version of Microsoft SQL Server page, select the appropriate version, and click Next.

On the Ready to install page, click Install.

On the Installation completed page, select Show logs to display the log files, and then click Finish. (The log file is stored in the same location that Setup was run from)


It is always good to check in the Log files that no errors occurred.



#2: Install the Data Migration Framework on an AOS instance

On a computer that is running an AOS instance, right-click DmfSetup.exe, and click Run as administrator.

In the Setup wizard, accept the license terms, and on the Select components to install page, click Application Object Server (AOS) component.

The Prerequisite validation screen appears. If the computer passes the validations required, click Next.

On the Select an AOS instance page, select an AOS instance, and then click Next.



On the Specify SQL Server Integration Services location page, select the computer running Integration Services, on which you installed the Data Migration Framework service, and click Next.



On the Ready to install page, click Install.

On the Installation completed page, select Show logs to display the log files, and then click Finish.


#3: Install the Data Migration Framework on a client

On a computer that is running a Microsoft Dynamics AX client, right-click DmfSetup.exe, and click Run as administrator.

In the Setup wizard, accept the license terms, and on the Select components to install page, click Client component.

The Prerequisite validation screen appears. If the computer passes the validations required, click Next.

On the Ready to install page, click Install.

On the Installation completed page, select Show logs to display the log files, and then click Finish.


#4: Install the Data Migration Framework model

After all of the components have been installed, you must install the Data Migration Framework model. This should be done on the client computer. Import the DataMigrationFramework.axmodel file from the location to which you installed the Data Migration Framework.

Note: Verify that the Microsoft Dynamics AX Management Shell is pointing to the database that you want to install the model in.

Drain client connections to the AOS instance that you are working with.

Stop the AOS.

Use one of the following command-line tools to import the model.

Windows PowerShell command:
Install-AXModel -File "C:\Program Files\Microsoft Dynamics AX 2012 Data Migration Framework Client Components(Beta)\DataMigrationFramework.axmodel"

From Command prompt - AXUtil:
axutil import /file:"C:\Program Files\Microsoft Dynamics AX 2012 Data Migration Framework Client Components(Beta)\DataMigrationFramework.axmodel"


Restart the AOS service.

Start the client.

In the Model store has been modified dialog box, click Compile and synchronize.

When the synchronization is completed, click Compile into .Net Framework CIL.

Note: If the dialog box does not open by itself, follow these steps.
Compile the application from System administration > Periodic > Compile.
Click System administration > Periodic > Database > SQL administration. On the Table actions menu, click Synchronize database.
Compile into .NET CIL from System administration > Periodic > Compile.

After the model has been compiled into .NET CIL, the Data Migration Framework button is added to the navigation pane. This means that Installation is successful.

Internal Links:
Simplified briefing about Ax 2012 DMF
Step by Step DMF Installation process
Simple example of DMF usage
For Troubleshooting DMF installation issues
Known Issue with DMF #1
Known Issue with DMF #2 
Best practises for DMF usage  

Post a Comment