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: In the application pool advanced settings set the value of the 'Enable 32-bit applications' to 'TRUE'.

Step 6: Locate the 'Identity' field under the 'Process Model' tab. Configure the application pool to run under the custom account, which is a Business Connector Proxy account. This user will be also set in the 'web.config' file of the AX web service in 'Step 9'.

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

Website for AX Web Service

Step 8: Configure authentication settings for the website. You should enable Windows Authentication for the website, all other types of authentication should be disabled.

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

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

Step 10: 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 11: 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 basicHttpBinding. Registered base address schemes are [http].' SSL should be configured in IIS.

If you do not use SSL for AX web service, delete 'AX_SSL' binding and endpoint from the 'web.config' file of the AX web service.

If you want to configure AX web service to use SSL, then read 'SSL Certificate for AX Web Services'.