Troubleshooting issues during an installation of the Data Migration Framework

#Issue 1: Error with Windows Installer package
Setup will not install the Data Migration Framework service on a 64-bit computer without Microsoft Visual Studio 2010 installed and running.
The installation fails with the error "There is a problem with this Windows Installer package. A program required for this installation to complete could not be run. Contact your support personnel or package vendor."

ResolutionInstall the Microsoft Windows SDK for Windows 7 and .NET Framework 4 from http://www.microsoft.com/en-us/download/details.aspx?id=8279.

On the Installation Options page, select the following options, and then complete the installation.

• Under .NET Development, select Tools.
• Under Redistributable Packages, select Microsoft Visual C++ 2010.
• Open a command prompt with Run as administrator rights.
• Depending on which version of SQL Server is in your environment, run one of the following commands.
• For SQL Server 2012, run Command
  <System Drive>\Program Files\Microsoft SDKs\Windows\v7.1\bin\NETFX 4.0 Tools\gacutil.exe" -i "C:\Program Files\Microsoft Dynamics AX 2012 Data Migration Framework Service (Beta)\Microsoft.Dynamics.AX.DMF.DMFErrorDescription.dll"
• For SQL Server 2008, run Command
  <System Drive>\Program Files\Microsoft SDKs\Windows\v7.1\bin\gacutil.exe" -i "C:\Program Files\Microsoft Dynamics AX 2012 Data Migration Framework Service (Beta)\Microsoft.Dynamics.AX.DMF.DMFErrorDescription.dll"
• Start the Microsoft Dynamics AX 2012 Data Migration Framework service.

#Issues 2: Data Migration Framework will not compile

If after installing the Data Migration Framework, you cannot compile,

• validate that the Data Migration Framework has installed correctly.
• Verify that the Microsoft Dynamics AX Data Migration Framework Service is running.
• Validate that the Data Migration Framework DLLs have been placed in the appropriate folders. The Data Migration Framework DLLs include:
• Client DLLs
  Microsoft.Dynamics.AX.DMF.Mapper.dll — should be present in the folder C:\Program Files (x86)\Microsoft Dynamics AX\60\Client\Bin
  Microsoft.Dynamics.AX.DMF.PreviewGrid.dll — should be present in the folder C:\Program Files (x86)\Microsoft Dynamics AX\60\Client\Bin
  Microsoft.Dynamics.AX.DMF.ServiceProxy.dll – should be present in the folder C:\Program Files (x86)\Microsoft Dynamics AX\60\Client\Bin
  Microsoft.Dynamics.AX.DMF.DriverHelper.dll — should be present in the folder C:\Program Files (x86)\Microsoft Dynamics AX\60\Client\Bin
  Microsoft.Dynamics.AX.DMF.SSISHelper.dll — should be present in the folder C:\Program Files (x86)\Microsoft Dynamics AX\60\Client\Bin
• Server DLL

• Microsoft.Dynamics.AX.DMF.SSISHelper.dll — should be present in the folder C:\Program Files\Microsoft Dynamics AX\60\Server\<AosInstance>\bin
  Microsoft.Dynamics.AX.DMF.ServiceProxy.dll – should be present in the folder C:\Program Files (x86)\Microsoft Dynamics AX\60\Server\<AosInstance>\Bin
  Microsoft.Dynamics.AX.DMF.DriverHelper.dll — should be present in the folder C:\Program Files (x86)\Microsoft Dynamics AX\60\ Server\<AosInstance>\Bin
  Microsoft.Dynamics.AX.DMF. DMFErrorDescription.dll — should be present in the folder C:\Program Files (x86)\Microsoft Dynamics AX\60\ Server\<AosInstance>\Bin

Resolution
The following is how to proceed if the DLLs are not present for each installation type.

1. For Installation type : Client
   Copy the DLLs from the installation location (C:\Program Files\Microsoft Dynamics AX 2012 Data Migration Framework Client Components(Beta)) to the folder indicated.
2. For Installation type : Server
Copy the Microsoft.Dynamics.AX.DMF.SSISHelper.dll from the installation location (C:\Program Files\Microsoft Dynamics AX 2012 Data Migration Framework Server Components(Beta)\ ) to the folder indicated.

Use the Assembly Registration Tool (Regasm.exe) to register the DLL. At a command line, run the following two commands:

1. regasm Microsoft.Dynamics.AX.DMF.SSISHelper.dll /tlb: Microsoft.Dynamics.AX.DMF.SSISHelper.tlb
2. regasm Microsoft.Dynamics.AX.DMF.ServiceProxy.dll /tlb: Microsoft.Dynamics.AX.DMF.ServiceProxy.tlb

Issue 3: Data Migration Framework service location changes
If you need to update the location where you are running Integration Services and the Data Migration Framework service, you can update the configuration information with correct computer name in the following files:
http://<<DMF Service ComputerName>>:7000/DMFService/DMFServiceHelper.svc

This file can be found in the following locations:

1. For Client, C:\Program Files (x86)\Microsoft Dynamics AX\60\Client\Bin\ Microsoft.Dynamics.AX.DMF.ServiceProxy.dll.config
2. For Server, C:\Program Files\Microsoft Dynamics AX\60\ServerAosInstance\Bin\ Microsoft.Dynamics.AX.DMF.ServiceProxy.dll.config
3. For Service, C:\Program Files\Microsoft Dynamics AX 2012 Data Migration Framework Service (Beta)\ Microsoft.Dynamics.AX.DMF.SSISHelperService.exe.config

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