Troubleshoot a connection

Important

This content is archived and is not being updated. For the latest documentation, see Microsoft Dynamics 365 product documentation. For the latest release plans, see Dynamics 365 and Microsoft Power Platform release plans.

Applies To: Microsoft Dynamics AX 2012 R3, Microsoft Dynamics AX 2012 R2, Microsoft Dynamics AX 2012 Feature Pack

Connection profiles enable the components of Retail to communicate with each other. When you are setting up a connection profile and test the connection, you may receive an error, such as "Cannot connect to Synch Service," "Cannot connect to database," or "Error getting error message." Use the information in this topic to troubleshoot these errors.

Troubleshoot connections in AX 2012 R3

If you’re using AX 2012 R3, see Troubleshoot issues in Async Server or Async Client for more information about troubleshooting connections.

Troubleshoot connections in AX 2012 R2 or AX 2012 Feature Pack

If you’re using AX 2012 R2 or AX 2012 Feature Pack, use the following troubleshooting steps.

  • Test connections between components. Use the Test connection buttons in the Database profile form, the AOS profile form, and the Synch Service profile form.

  • Use ping, Telnet, or another network utility to verify that the Microsoft Dynamics AX computer at the head office can connect to the location computer. If it cannot, make sure that the firewall on the location computer is open to the required ports or programs. If the firewall is already open, work with the network administrator to correct the network configuration.

  • On the location computer, verify that remote connections to Microsoft SQL Server are enabled, and that SQL Server users and permissions are set up correctly. For more information about these requirements, see Configure SQL Server for the Retail databases.

  • Verify that Commerce Data Exchange: Synch Service is running on the location computer. If it is, see whether the Synch Service log contains errors.

    Note

    If logging is not turned on, turn it on, restart Synch Service, and then check the log. For information about how to set up logging, see Configure settings for Synch Service.

  • Verify that the connection information in the database profile is correct.

  • Bypass Internet Protocol security (IPsec) for the location and in the Synch Service settings on the location computer. For information about how to bypass IPsec, see Configure or bypass IPsec for Synch Service.