Install the Data import/export framework (DIXF, DMF) [AX 2012]

Note
The procedure for completing this task has changed for cumulative update 7 or later for Microsoft Dynamics AX 2012 R2. For more information, see the section later in this topic.

This topic describes how to install the Microsoft Dynamics AX 2012 Data Import/Export Framework.
Before you begin, your environment must include the following components:

• A running version of AX 2012 that has been configured for your business
  
• 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 might 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. For more information, see Tune data access settings.

Install the version of the Data Import/Export Framework that is available in AX 2012 R3

---

Components of the Data Import/Export Framework must be installed on computers that are running Integration Services, a computer that is running an instance of Microsoft Dynamics AX Application Object Server (AOS), and a computer that is running the Microsoft Dynamics AX client. You must run the installer locally on each computer.

Caution

If you have previously installed the Data Import/Export Framework from InformationSource, you must fully uninstall it and then reinstall it for cumulative update 7 for Microsoft Dynamics AX 2012 R2. As part of this full uninstallation, you must remove all binary files by using Add/Remove Programs and uninstall the Data Import/Export Framework model. For more information, see How to: Remove (Uninstall) a Model.

1. Start Microsoft Dynamics AX Setup. Under Install, select Microsoft Dynamics AX components.
   
2. Advance through the first wizard pages.
   
3. If the Setup Support files have not yet been installed on the computer, the Select a file location page is displayed. The Setup Support files are required for installation. Enter a file location or accept the default location, and then click Next.
   
4. On the Ready to install page, click Install.
   
5. On the Select components page, select the appropriate component for the computer that you are installing to, in the following order: server, AOS component, client component.
   
   1. The prerequisite validation check runs. Address any issues that the prerequisite check finds outside the installer, and then restart the validation check. When all prerequisites have been found, click Next.
      
   2. On the computer that is running SQL Server Integration Services, install the Data Import/Export Framework (DIXF) service.
      Specify a service account and the version of SQL Server that is running. We recommend that you use the AOS service account.
      
   3. On the AOS instance, specify the name of the server that is running SQL Server Integration Services.
      

Install the version of the Data Import/Export Framework that is available in cumulative update 7 for Microsoft Dynamics AX 2012 R2

---

Important
If you are running Microsoft Dynamics AX 2012 R2, we strongly recommend that you use the version of the Data Import/Export Framework that is available in cumulative update 7.

Components of the Data Import/Export Framework must be installed on computers that are running Integration Services, on a computer that is running an instance of Microsoft Dynamics AX Application Object Server (AOS), and on a computer that is running the Microsoft Dynamics AX client. You must run the installer locally on each computer.
The Data Import/Export Framework has been released as part of cumulative update 7. Therefore, detailed installation instructions are included in the Apply updates to database, AOS, and clients section of the Apply updates to database, AOS, and clients topic.

Caution

If you have previously installed the Data Import/Export Framework from InformationSource, you must fully uninstall it and then reinstall it for cumulative update 7 for Microsoft Dynamics AX 2012 R2. As part of this full uninstallation, you must remove all binary files by using Add/Remove Programs and uninstall the Data Import/Export Framework model. For more information, see How to: Remove (Uninstall) a Model.

Install the Data Import/Export Framework from InformationSource

---

Note
We recommend that you use the version of the Data Import/Export Framework that is available from InformationSource only with AX 2012 or Microsoft Dynamics AX 2012 Feature Pack.

Components of the Data Import/Export Framework must be installed on computers that are running Integration Services, on a computer that is running an AOS instance, and on a computer that is running the Microsoft Dynamics AX client. You must run the installer locally on each computer.
Download the installation package for the Data Import/Export Framework, DataImportExportFramework.zip, and extract the package to a local folder.

Install the Data Import/Export Framework on the computer that is running Integration Services

---

1. On the computer that is running Integration Services, right-click Setup.exe, and then click Run as administrator.
   

   Important
   If you do not run Setup as an administrator, the Data Import/Export Framework DLLs will not be copied to the correct locations or registered.

2. In the Setup wizard, accept the license terms, and then, on the Select components to install page, click Data Import/Export Framework service.
   
3. On the Prerequisite validation page, if the computer passes the validations that are required, click Next.
   If the computer does not pass the validations, install the prerequisites, and then restart Setup.
   
4. On the Specify a service account page, enter the same account that is used for the AOS service, and then click Next.
   
5. On the Select version of Microsoft SQL Server page, select the appropriate version, and then click Next.
   

   Caution
   This page appears only if Setup detects that versions of Integration Services for both SQL Server 2008 and SQL Server 2012 are installed on the computer.

6. On the Ready to install page, click Install.
   
7. 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.
   

Install the Data Import/Export Framework on an AOS instance

---

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

   Important
   If you do not run Setup as an administrator, the Data Import/Export Framework DLLs will not be copied to the correct locations or registered.

2. In the Setup wizard, accept the license terms, and then, on the Select components to install page, click Application Object Server (AOS) component.
   
3. On the Prerequisite validation page, if the computer passes the validations that are required, click Next.
   If the computer does not pass the validations, install the prerequisites, and then restart Setup.
   
4. On the Specify SQL Server Integration Services location page, select the computer that is running the version of SQL Server Integration Services that you installed the Data Import/Export Framework service on, and then click Next.
   
5. On the Ready to install page, click Install.
   
6. 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.
   

Install the Data Import/Export Framework on a client

---

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

   Important
   If you do not run Setup as an administrator, the Data Import/Export Framework DLLs will not be copied to the correct locations or registered.

2. In the Setup wizard, accept the license terms, and then, on the Select components to install page, click Client component.
   
3. On the Prerequisite validation page, if the computer passes the validations that are required, click Next.
   If the computer does not pass the validations, install the prerequisites, and then restart Setup.
   
4. On the Ready to install page, click Install.
   
5. 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.
   

Install the Data Import/Export Framework model

---

After all the components have been installed, you must install the Data Import/Export Framework model.

1. On the client computer, from the location where you installed the Data Import/Export Framework, import the DataImportExportFramework.axmodel file. For more detailed instructions, see How to: Export and Import a Model.
   

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

   1. Drain client connections to the AOS instance that you are working with.
      
   2. Stop the AOS.
      
   3. Use one of the following command-line tools to import the model.
      The version of the model that you import depends on the version of Microsoft Dynamics AX that you are running:
      
      • For AX 2012, install the model from the 2012 directory.
        
      • For AX 2012 Feature Pack, install the model from the 2012 FP directory.
        
      • For AX 2012 R2, install the model from the 2012 R2 directory.
        
      Windows PowerShell
      
      Windows PowerShell

      Copy

      Install-AXModel -File "C:\Program Files\Microsoft Dynamics AX 2012 Data Import Export Framework Client Component\<version number>\model\DataImportExportFramework.axmodel"
      

      AXUtil
      
      Copy

      axutil import /file: "C:\Program Files\ Microsoft Dynamics AX 2012 Data Import Export Framework Client Component \<version number>\model\DataImportExportFramework.axmodel"
      

2. Restart the AOS service.
   
3. Start the client.
   
4. In the Model store has been modified dialog box, click Compile and synchronize.
   
5. When the synchronization is completed, click Compile into .Net Framework CIL.
   
6. If the dialog box does not open by itself, follow these steps:
   
   1. Compile the application from System administration > Periodic > Compile.
      
   2. Click System administration > Periodic > Database > SQL administration. On the Table actions menu, click Synchronize database.
      
7. Compile into .NET CIL from System administration > Periodic > Compile.
   After the model has been compiled into .NET CIL, the Data Import/Export Framework button is added to the navigation pane.
   

Troubleshoot an installation of the Data Import/Export Framework from cumulative update 7 for Microsoft Dynamics AX 2012 R2

---

This section describes how to troubleshoot issues with a Data Import/Export Framework installation from cumulative update 7 for Microsoft Dynamics AX 2012 R2.

You receive an “Assembly containing type Microsoft.Dynamics.AX.DMF.ServiceProxy.DmfEntityProxy is not referenced.” error

---

After you slipstream cumulative update 7 for Microsoft Dynamics AX 2012 R2, the Data Import/Export Framework appears to be installed, but you receive error messages when many forms are opened.
Resolution
When you slipstream install cumulative update 7 for Microsoft Dynamics AX 2012 R2, the Data Import/Export Framework appears to be installed for members of the System Administrators role. However, the binary components of the framework are not present. To fully install the Data Import/Export Framework, you must run the update installer. For more information, see the "Apply updates to database, AOS, and clients" section of the Apply updates to database, AOS, and clients topic.

Troubleshoot an installation of the Data Import/Export Framework from InformationSource

---

This section describes how to troubleshoot issues with a Data Import/Export Framework installation from InformationSource.

The Data Import/Export Framework does not compile

---

After you install the Data Import/Export Framework, if you cannot compile, validate that the Data Import/Export Framework was installed correctly.

1. Verify that the Microsoft Dynamics AX Data Import/Export Framework service is running.
   
2. Verify that the Data Import/Export Framework DLLs are present in C:\Program Files (x86)\Microsoft Dynamics AX\60\Client\Bin folder:
   
   • Microsoft.Dynamics.AX.DMF.Mapper.dll
     
   • Microsoft.Dynamics.AX.DMF.PreviewGrid.
     
   • Microsoft.Dynamics.AX.DMF.ServiceProxy.dll
     
   • DMFConfig.xml
     
   • Microsoft.Dynamics.AX.DMF.DriverHelper.dll
     

Resolution
Copy the DLLs from the installation location (C:\Program Files\Microsoft Dynamics AX 2012 Data Import Export Framework Client Component) to the C:\Program Files (x86)\Microsoft Dynamics AX\60\Client\Bin folder.

Exception message while you use Data Import/Export Framework

---

While you use the Data Import/Export Framework, you might receive the following error message:
System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation. ---> System.InvalidOperationException
Verify that the following files are present in the C:\Program Files (x86)\Microsoft Dynamics AX\60\Server\Bin folder on the server that is running the AOS instance:

• DMFConfig.xml
  
• DMFClientConfig.xml
  
• Microsoft.Dynamics.AX.DMF.ServiceProxy.dll.config
  

Resolution
Copy the .xml and the config files from the installation location (C:\Program Files\Microsoft Dynamics AX 2012 Data Import Export Framework Server Component) to the C:\Program Files (x86)\Microsoft Dynamics AX\60\Server\Bin folder on the server that is running the AOS instance.

Changes to the location of the Data Import/Export Framework service

---

If you have to update the location where you run Integration Services and the Data Import/Export Framework service, you can update the endpoint address in the Microsoft.Dynamics.AX.DMF.ServiceProxy.dll.config file to use the new server name.
<endpoint address="http://<<NEW MACHINE NAME>>:7000/DMFService/DMFServiceHelper.svc"

Note
The Microsoft.Dynamics.AX.DMF.ServiceProxy.dll.config file is located in the C:\Program Files (x86)\Microsoft Dynamics AX\60\Server\Bin folder on the server that is running the AOS instance.