Deploy Commerce Data Exchange: Real-time Service

Artikkeli
08/03/2018

Applies To: Microsoft Dynamics AX 2012 R2

In Microsoft Dynamics AX 2012 R2, Commerce Data Exchange: Real-time Service is a Windows Communication Foundation (WCF) service that uses .NET Business Connector to communicate with Microsoft Dynamics AX. When you install the Real-time Service component by using the Setup wizard, the following resources are installed:

A folder that contains the binaries and configuration files for the WCF service
A folder that contains sample Windows PowerShell scripts

Use these resources to manually deploy and configure the WCF service that is used by Real-time Service.

Request and install a server certificate for the website

Real-time Service uses Secure Sockets Layer (SSL) to help secure communication. Therefore, you must install a server certificate that was issued by a trusted certification authority.

Request and install a certificate by using IIS

You can request and install a server certificate by using Internet Information Services (IIS). For more information, see the IIS documentation on TechNet.

Huomautus

For test environments, IIS provides the option to create a self-signed certificate.

Install a certificate by using Windows PowerShell

If you have already received a certificate from your provider, or if you are migrating a certificate from a different server, the file may be in .pfx format. In this case, you can use a sample Windows PowerShell script to install the certificate.

Open a Windows PowerShell session that has Administrator permissions.

At the Windows PowerShell command prompt, run the InstallServerCertificate.ps1 script. For example, enter the following command:

& "C:\Program Files (x86)\Microsoft Dynamics AX\60\Commerce Data Exchange\Real-time Services\6.2\Sample Deployment Scripts\InstallServerCertificate.ps1"

When you are prompted, enter the path of the .pfx file and the private key password.

Deploy the web service by using Windows PowerShell

A sample Windows PowerShell script is provided to help you deploy the WCF service for Real-time Service .

Open a Windows PowerShell session that has Administrator permissions.

At the Windows PowerShell command prompt, run the InstallCommerceDataExchangeRealtimeService.ps1 script. For example, enter the following command:

& "C:\Program Files (x86)\Microsoft Dynamics AX\60\Commerce Data Exchange\Real-time Services\6.2\Sample Deployment Scripts\ InstallCommerceDataExchangeRealtimeService.ps1"

When you are prompted, enter the following information:
- User account – The user account to run the service as. Enter the user account in the following format: domain\user. This user account must be a Microsoft Dynamics AX user who has the appropriate permissions.
- Password – The password for the user account.
- Service binary source folder path – The location of the .dll files for Real-time Service. By default, the path is C:\Program Files (x86)\Microsoft Dynamics AX\60\Commerce Data Exchange\Real-time Services\6.2\. The .dll files are copied to the website that is created.
  
  Vihje
  
  Do not include the bin subfolder in the path.
- Server certificate thumbprint – The thumbprint of the certificate that is installed on the IIS server. Enter only the characters that are included in the thumbprint value. Omit all spaces.
  
  To obtain the thumbprint, in IIS Manager, double-click IIS > Server Certificates. Double-click the certificate, and then select Details.

Test and troubleshoot Real-time Service

For more information about how to configure, test, and troubleshoot the installation of Real-time Service, see the following posts on the AX Support Blog:

Jaa