Export (0) Print
Expand All

Configure IIS to work with Microsoft Dynamics AX Web services

Dynamics AX 4.0

In order to perform document exchanges that expose Web services (that is, enable transfers using inbound Web services), you must install an application integration server using the Microsoft Dynamics AX setup program, as well as Microsoft Internet Information Services (IIS) 6.0. A core Microsoft Dynamics AX installation must also reside in the domain. We recommend that the application integration server and the Application Object Server (AOS) be installed on different computers. For details on installing an application integration server, see Install an application integration server.

Additional steps for configuring IIS and adding a Web site for use by AIF are included below.

To locate your existing installation of IIS Services Manager, click Start > All Programs > Administrative tools > Internet Information Services Manager. For complete instructions on configuring IIS Services Manager, see the IIS documentation on Technet.

AIF requires that IIS 6.0 be running in worker process isolation mode and not IIS 5.0 isolation mode. The application isolation mode applies globally to the IIS service and affects all Web applications on the computer. You cannot apply an application isolation mode to individual applications.

To select worker process isolation mode in IIS 6.0:

  1. Open the IIS management console and expand the local computer by clicking the plus sign.

  2. Right-click the Web Sites folder, click Properties, and then click the Service tab.

  3. Under Isolation mode, clear the Run WWW service in IIS 5.0 isolation mode check box to configure IIS to run in worker process isolation mode.

  1. To open IIS Services Manager, click Start > All Programs > Administrative tools > Internet Information Services Manager.

  2. In IIS Manager, navigate to the virtual root DynamicsWebService.

  3. Click Action > Properties.

  4. On the Directory tab, click Create.

  5. Select the Application Pool created when you set up the application integration server. For additional information, see Install an application integration server.

  6. For Execute permissions, select Scripts only.

  7. Set the local path permissions to read by selecting the Read check box in the Local path section.

  8. Navigate to Directory Security and clear Anonymous. Select Integrated.

  9. On the ASP.NET tab, select ASP Version 2.0. If the ASP.NET tab does not appear, you must uninstall and reinstall ASP.NET in IIS using the following steps:

    1. Click Start > Run.

    2. Type cmd.

    3. In the Command Prompt window, type:

      cd your-system-directory \Microsoft.NET\Framework\v2.0.50727. and press ENTER.

    4. Type aspnet_regiis.exe -u and press ENTER.

    5. Type aspnet_regiis.exe –i -enable and press ENTER.

    6. Type iisreset and press ENTER.

    7. Close the Command Prompt window.

    After uninstalling and reinstalling ASP.NET and resetting IIS, the ASP.NET tab is available, and you can select ASP version 2.0. This allows you to browse the Web services after you create them on the form. See Create Web services for an action.

After you finish configuring IIS, you add a Web site in the Microsoft Dynamics AX client, using the form.

  1. Click > > > .

  2. Press CTRL+N to create a new Web site, or select one of the Web sites from the list.

  3. On the tab, enter a descriptive name for this Web site in the field.

    The name may contain special characters and blanks and may be up to 50 characters long.

  4. In the field, enter the path to the virtual directory to contain the Web service components that are generated from actions. Specify the path to the share created when you installed the application integration server as a Windows share, that is, it should have the format \\computer-name\share-name. Click to check that the share name is correct and that the AOS service account has been given Read and Write access.

© 2014 Microsoft