Install AIF Web services

Application Integration Framework (AIF) Web services are used to exchange documents between Microsoft Dynamics AX and other systems. External systems can request or create data by calling the Web services that are exposed by Microsoft Dynamics AX. To perform document exchanges with Web services, you must install the AIF Web services on the application integration gateway computer using the Microsoft Dynamics AX Setup program.

We recommend that the application integration server and the Application Object Server (AOS) be installed on different computers.

Prerequisites for installing the AIF Web services

  • Install the following prerequisites on the AIF Web server.

    For more information about the hardware and software requirements for Microsoft Dynamics AX, see the system requirements Web page.


    How to install

    Microsoft .NET Framework 3.5

    Download the .NET Framework from the Microsoft Download Center.

    Windows Installer 3.1

    Download the Windows Installer from the Microsoft Download Center.

    Internet Information Services (IIS)

    The Microsoft Dynamics AX Setup wizard will install IIS for you. If you want to install IIS manually, see the Windows Server documentation.


    The Microsoft Dynamics AX Setup wizard will install ASP.NET for you. If you want to install ASP.NET manually, see the Windows Server documentation.

    Microsoft Dynamics AX .NET Business Connector

    The Microsoft Dynamics AX Setup wizard will install the .NET Business Connector for you.

    If the .NET Business Connector proxy account has not been set up, Setup will prompt you to specify its credentials.

  • Verify that the Microsoft Dynamics AX base components (the database, AOS, and application files) have been installed in the environment, and that the initialization checklist has been completed.

  • Log in with an account that is a member of the Administrators group on the computer on which you are installing AIF Web services.

Install AIF Web services

Use this procedure to install AIF Web services. If you are installing other Microsoft Dynamics AX components at the same time, the installation screens will vary based on the components you are installing.

  1. Start Microsoft Dynamics AX Setup.

  2. Step through the initial wizard pages.

  3. On the Select installation type page, click Custom installation, and then click Next.

  4. On the Select components page, select AIF Web services. Click Next.

  5. On the Install files page, accept the default file location or specify another directory and click Next.

  6. On the .NET Business Connector: Select a display language page, select the initial language.

  7. On the Business Connector: Connect to AOS instance page, in the AOS name field, type the computer name of the AOS to which the application integration computer should connect. If that computer runs more than one AOS, enter the instance name or port number of the AOS.

  8. On the Identify the .NET Business Connector proxy account page, type the domain, user account and password of the Business Connector proxy account.

  9. On the AIF Web services: Configure IIS page, select the following:

    1. In the Web site field, select the Web site in which the AIF IIS application will be created.


      If you select the Default Web Site in IIS—and you later install Windows SharePoint Services or Microsoft Office SharePoint Server—the SharePoint installation program will stop the Default Web Site and create a new site that runs on port 80. This means you will have to configure the Default Web Site to run on a different port and restart the site.

    2. In the Application pool field, accept the default application pool name or type a new application pool name. This is the application pool that IIS will use for the AIF application.

    3. In the Virtual directory field, accept the default IIS virtual directory or type a new name for the virtual directory. This virtual directory points to the content directory that contains the AIF service files.

    4. The read only Content directory field displays the directory where the generated service artifacts are stored including the Web.config file. Setup creates the AIFWebServices folder in the Microsoft Dynamics AX installation path and sets the content directory to this path.

    Click Next.

  10. On the AIF Web services: Specify an AOS account page, enter or select the account the AOS instance is running as. If you have multiple AOS instances, specify the account for each instance.

    If an AOS instance is running as the Network Service account, format the account name in the following way: Domain\ComputerName$.

    Click Next.

  11. On the Ready to install page, click Install. Note that IIS will be restarted after the Web services are installed.

What installing Web services does

When you install AIF Web services on the application integration server, Setup makes changes to IIS and the file system as shown in the following figure.

AIF Web services installation architecture

The AIF Web services installation architecture

When you install AIF Web services, setup makes the following changes on the application integration computer:

  • Creates a virtual directory for AIF under the selected Web site. By default, setup creates this virtual directory under the Default Web Site in IIS. The default virtual directory is MicrosoftDynamicsAXAif50. This virtual directory points to the content directory specified during the setup process.

  • Creates an application pool for the virtual directory. By default, setup names the application pool MicrosoftDynamicsAXAif50.

  • Sets the created application pool to run under the .NET Business Connector proxy user specified during setup.

  • Sets the application pool of the virtual directory to the newly created application pool.

  • Creates a content directory with a path of <Microsoft Dynamics AX installation path>\AifWebServices.

Restrict access to application integration files

When AIF Web services are installed, Setup creates a network share to the content directory where the files reside. We recommend that you restrict access to this share.

  1. Open the Computer Management application (Start > Administrative Tools > Computer Management).

  2. Click the Groups folder under Local Users and Groups.

  3. Right-click the Microsoft Dynamics AX Web Service Administrators local group and select Properties. In the Members field, verify that only AOS accounts are members of the group.

  4. If you are using the default permissions in Microsoft Windows Server 2003, all domain users have Read and Execute permissions to the content directory where the Web services are installed. For details, see the Default local groups article on TechNet. If you are not using default permissions, you may need to grant access to the share using one of the following methods:

    • Create a local Windows group with access to the directory and add users of AIF Web services to it.

    • Add users of AIF Web services to the local Users group of the computer.

Set up AIF Web services

Installing AIF Web services is the first step in setting up document exchanges that use Web services. The next step is to generate the Web services and configure the exchange. For more information, see Configuring document exchanges with Web services.


If you experience issues installing AIF Web services, see Troubleshoot installation issues with AIF.