InstallationPrepare AX Server EnvironmentAX Web Service Installation

Prepare AX Server Environment

Open 'Prepare AX Server Environment' wizard, choose your AX version and service to see more information.

AX Web Service Installation

Step 1: Locate the Microsoft Dynamics AX web service application files, which can be found in the 'Services\AX' folder in the Sana Commerce installation package.

Step 2: Copy the contents of this folder to the new folder (e.g. 'AXService') at the IIS working directory (by default C:\inetpub).

Step 3: Open Internet Information Service (IIS) manager (Start -> Run -> inetmgr).

Step 4: Add new application pool. Select '.NET Framework v4.0.30319' from the dropdown and 'Classic' pipeline mode:


Adding New Application Pool

Step 5: Add new application for Microsoft Dynamics AX web service. Select the newly created application pool and specify physical path to the folder where web service was copied:


Adding New Application for AX Web Service

Step 6: Modify the web service configuration file of Microsoft Dynamics AX ('web.config'). In the <appSettings> section specify the AX user credentials and AX object server:

  • User name;
  • User password;
  • User domain;
  • AX object server.
<appSettings>
    <add key="UserName" value="AXUSERNAME"/>
    <add key="Domain" value="DOMAIN"/>
    <add key="UserPassword" value="PASSWORD"/>
    <add key="objectServer" value="INSTANCENAME@SERVERNAME:PORT"/>
</appSettings>
For more detailed information about the AX user read the next chapter.
To identify object server open Microsoft Dynamics AX Configuration Utility with administrator rights. On the 'Connection' tab you can observe available AOS instances.

Step 7: In the web service configuration file ('web.config') locate the <assemblies> and <runtime> sections and uncomment those lines which relate to your Microsoft Dynamics AX version.

Step 8: In the <bindings> configuration section replace the line <binding name="AX"> by the following two lines:
<binding name="AX" maxBufferPoolSize="924288" maxReceivedMessageSize="955360">
<readerQuotas maxStringContentLength="999999" maxArrayLength="999999" />

Make sure that for the 'maxStringContentLength' and 'maxArrayLength' properties the maximum values (999999) are set.

Step 9: In the <bindings> configuration section replace the line <binding name="AX_SSL"> by the following two lines:

<binding name="AX_SSL" maxBufferPoolSize="924288" maxReceivedMessageSize="955360">
<readerQuotas maxStringContentLength="999999" maxArrayLength="999999" />

Make sure that for the 'maxStringContentLength' and 'maxArrayLength' properties the maximum values (999999) are set.

Step 10: To test the newly created web service, select the created Microsoft Dynamics AX application in IIS and switch to the content view mode. Select the 'AXService.svc' file and click 'Browse'. Web service information page should be displayed in the default browser:


Web Service Testing

If the following error message occured: 'Could not find a base address that matches scheme https for the endpoint with binding WSHttpBinding. Registered base address schemes are [http].' SSL should be configured in IIS.

If you do not use SSL for AX web service, the following SSL binding and endpoint should be deleted from the web service configuration file of Microsoft Dynamics AX ('web.config'):

<binding name="AX_SSL">
<security mode="TransportWithMessageCredential">
<transport clientCredentialType="Windows" proxyCredentialType="None" realm="" />
<message clientCredentialType="Windows" negotiateServiceCredential="true" algorithmSuite="Default" establishSecurityContext="true"/>
</security>
</binding>
<endpoint address="" binding="wsHttpBinding" bindingConfiguration="AX_SSL" contract="Sana.Commerce.AX.Service.IAXDataService">
<identity>
<dns value="localhost" />
</identity>
</endpoint>