Resource Page for CRM Connector in Microsoft Dynamics AX 2012

  • Comments 2

Provides a consolidated list of published documentation, sources of information, known issues, solutions as well as tips and tricks for troubleshooting CRM Connector for Microsoft Dynamics AX 2012.

On this page:


Top Downloads

Top

Critical Hotfixes

Some of the issues described in this page will be corrected in the RU 1 release of the CRM connector for Dynamics AX 2012 due to release at the end of June 2012.

Top

 

Featured Videos

Top

 

Related Resources

Top

 

Common Problems & Solutions

This section lists the most common issues encountered in CRM Connector for Microsoft Dynamics® AX and the solution recommended by the Microsoft Dynamics® AX Support team. Please note that there may be some different security settings depending on your domain policies. You may need to work with WCF resources for WCF related errors or problems.

Issue

The communication object, System.ServiceModel.Channels.ServiceChannel, cannot be used for communication because it is in the Faulted state, when testing the Adapter settings in the CRM connector tool

Solution

This message is usually seen when the Dynamics AX 2012 CIL code and X++ code are not in sync. With no other users in the system and only one AOS instance running, complete the following steps:

Full X++ compile
Synchronize
Full CIL generation

Resolve any errors that occur during the process, before moving on to any of the next steps.
After successfully completing the steps above, restart all AOS instances.
If you receive CIL errors, go back and compile the class in the error, look for any potential compile forward when extending code.

Issue

Unable to connect when trying the use the Refresh Services button in the CRM Connector tool and when checking C:\ProgramData\Microsoft Dynamics\Connector for Microsoft Dynamics\Logs\Microsoft.Dynamics.Integration.Adapters.Ax2012.Configuration.log

You see the error Caught Exception: This operation is not supported for a relative URI near the end of the log file

Solution

There is a conflict with Windows App Fabric SDK that is installed on the CRM connector machine. This issue is resolved in the RU 1 release of Connector, the workaround is to un-install Windows App Fabric SDK from Control Panel | Programs and features

Once you un-install the Windows App Fabric SDK you may encounter an additional error from entries not being fully removed from configuration files. The following blog post addresses this issue:
http://justinlee.sg/2011/04/27/how-to-fix-this-error-configuration-binding-extension-system-servicemodelbindingsnettcprelaybinding-could-not-be-found/

The Windows App Fabric SDK gets installed with CRM, but is only used if you are doing CRM online application development. Windows App Fabric SDK is also installed with Rapid Start and may need to be moved to a different server for that functionality

Note: This issue will be corrected in the RU 1 release of the CRM connector for Dynamics AX 2012 due to release at the end of June 2012

Issue

A call to SSPI failed, see inner exception error message when you test the connection in the CRM connector tool.

When you check C:\ProgramData\Microsoft Dynamics\Connector for Microsoft Dynamics\Logs\Microsoft.Dynamics.Integration.Adapters.Ax2012.Configuration.log you receive the error Caught Exception: Exception occurred on the metadata service on client or server. See exception details below: >A call to SSPI failed, see inner exception. near the end of the log file.

When you check the system event logs on the CRM connector machine you receive the following Kerberos error: The Kerberos client received a KRB_AP_ERR_MODIFIED error from the server axAOSServer. The target name used was host/server. This indicates that the target server failed to decrypt the ticket provided by the client…..

Solution

If you are getting an SSPI error the issue seems to be related to the Microsoft.Dynamics.Integration.Adapters.Ax2012.Configuration.exe.config. This file is located in the following location:
C:\Program Files (x86)\Microsoft Dynamics\Microsoft Dynamics Adapter

This file contains an Identity servicePrincipalName value="host/localhost". These entries could be changed to remove the host/localhost and leave it blank as shown here:
<servicePrincipalName value="" />

The original file has two places where it would to be changed to have the blank entry, below is the original file before any changes are made so you can find and remove the entries:
<client>
<endpoint address="net.tcp://localhost8201/DynamicsAx/Services/MetadataService"
binding="netTcpBinding" bindingConfiguration="MetadataServiceEndpoint"
contract="Microsoft.Dynamics.AX.Framework.Services.Metadata.Service.IAxMetadataService"
name="MetadataServiceEndpoint">
<identity>
<servicePrincipalName value="host/localhost" />
</identity>
</endpoint>
<endpoint address="net.tcp://localhost:8201/DynamicsAx/Services/QueryService"
binding="netTcpBinding" bindingConfiguration="QueryServiceEndpoint"
contract="Microsoft.Dynamics.AX.Framework.Services.QueryService.IQueryService"
name="QueryServiceEndpoint">
<identity>
<servicePrincipalName value="host/localhost" />
</identity>
</endpoint>
</client>

Note: This issue will be corrected in the RU 1 release of the CRM connector for Dynamics AX 2012 due to release at the end of June 2012

 

Top

 

Troubleshooting Tips

  • For problems with the CRM adapter configuration, check the log files located in the following location:
    C:\ProgramData\Microsoft Dynamics\Connector for Microsoft Dynamics\Logs\
  • Check for possible problems in the Dynamics AX client in the following location:
    System Administration | Setup | Services and Application Integration Framework | Inbound ports.
  • WCF Test Client can be used for troubleshooting problems, .NET Framework 4.0 is required. If it is not installed, check to see if the following folder exists:
    C:\Windows\Microsoft.NET\Framework\v4.xxxx.
    The download is available at the following location:
    http://www.microsoft.com/en-us/download/details.aspx?id=17851

 

Top

 

Still having trouble...

If you are experiencing issues downloading the install file or documentation on CustomerSource/PartnerSource, contact ITMBSSUP@microsoft.com

  1. Ask the community of users like yourself through the Microsoft Dynamics AX Community here.
  2. For Technical support questions, contact your partner, or if enrolled in a support plan directly with Microsoft, you can enter a new support request to Microsoft Dynamics Technical Support from CustomerSource or PartnerSource under Support >> New Support Request
  3. You can also contact Microsoft Dynamics Technical Support by phone using these links for country specific phone numbers:
    Partners – Global Support Contacts (requires PartnerSource login)
    Customers – Global Support Contacts (requires CustomerSource login)

Top

  • Can Dynamics CRM online 2013 can be integrated with on-premise Dynamics AX through Connector?

  • @ka - yes it can using version 3.1 of Connector