Hosting the transaction service in SCpbMD

Perform the following on all CM & CD servers:

  1. If you have not already done so, install Sitecore.Commerce.DynamicsIntegration.TransactionService.

    • Using the Sitecore.Commerce.DynamicsIntegration.TransactionService update package (Sitecore.Commerce.DynamicsIntegration.TransactionService.8.*.*.*.update) you downloaded previously.

    • Navigate to http://<your site>/sitecore/admin/UpdateInstallationWizard.aspx, and then follow the steps in the wizard.

  2. Go to the Sitecore instance folder on disk and open \Website\TransactionService\web.config. Change the CommerceRuntimeConnectionString connection string to your Dynamics AX for Retail Channel Database.

  3. Go to the Sitecore instance folder on disk and open \Website\TransactionService\commerceRuntime.config. Fill in the defaultOperatingUnitNumber with the operation unit number of your Dynamics AX Channel. For retail server the defaultOperatingUnitNumber should be empty.

  4. Go to the Sitecore instance folder on disk and open \Website \App_Config\DynamicsRetail.Connectors.Services.config, then configure the Transaction service endpoints to reflect the URI of service endpoints and identity that will be used.

  5. In IIS Manager, locate the "TransactionService" directory in your Sitecore instance, and then click Convert to Application. Optionally you can create a separate application pool and user account for the TransactionService application.

  6. You may need to update your Windows hosts file to ensure that the computer running TransactionService is able to access the URL returned by your Microsoft Dynamics service.

  7. SCpbMD expects communication with the Transaction Service to be done over SSL, so make sure to set up the hosting Sitecore site with a HTTPS binding and certificate

  8. The certificate that is used by the reference storefront for HTTPS must be added to the Trusted Root Certification Authorities on the machine that the transaction service is hosted on. The certificate can be exported by using IIS (https://technet.microsoft.com/en-us/library/cc731386(v=ws.10).aspx ).

    Note

    The endpoint address URI in DynamicsRetail.Connectors.Services.config must match the URL associated to the certificate. You can validate that the transaction service is working by checking if you can navigate to https://ax.reference.storefront.com/transactionservice/ without any certificate errors or warnings.