How to: Install and Configure Internet Information Services for Microsoft Dynamics NAV Web Client

  • Article

This topic describes how to install and configure Internet Information Service (IIS) for the Microsoft Dynamics NAV Web client. To deploy the Microsoft Dynamics NAV Web client, you install the Microsoft Dynamics NAV Web Server components on a computer that running IIS 7.5, IIS 8.0, IIS 8.0, or IIS 10.0. A website for Microsoft Dynamics NAV Web client is installed on the IIS.

IIS must have the following features enabled:

  • HTTP Activation

  • NET Extensibility 4.5, .NET Extensibility 4.6, or .NET Extensibility 4.6 (depending on Windows version)

  • ASP.NET 4.5, ASP.NET 4.6, or ASP.NET 4.7 (depending on Windows version)

  • ISAPI Extensions

  • ISAPI Filters

  • Request Filtering

  • Windows Authentication

  • Default Document

  • Directory Browsing

  • HTTP Errors

  • Static Content

Important

If you are hosting the Microsoft Dynamics NAV Web Server components on an IIS server farm that is using Application Request Routing (ARR), see Configure Headers in Application Request Routing (ARR) Rules.

Tip

Instead of manually installing IIS, you can use the Dynamics NAV Setup wizard to install and enable the IIS features. For more information, see Using Microsoft Dynamics NAV Setup to Install IIS Features.

Install IIS on Windows 7, 8, 8.1, and 10

  1. On the Start page, choose Control Panel, and then choose Programs.

  2. Under Programs and Features, choose Turn Windows features on or off.

    The Windows features dialog box appears.

  3. Expand the root-level item .NET Framework 4.5 Advanced Services, .NET Framework 4.6 Advanced Services, or .NET Framework 4.7 Advanced Services, and then do the following:

    • Select ASP.NET 4.5, ASP.NET 4.6, or ASP.NET 4.7.

    • Expand WCF Services, and then select HTTP Activation.

  4. Expand the root-level item Microsoft .NET Framework 3.5 (including .NET 2.0 and 3.0), and then select Windows Communication Foundation HTTP Activation.

    Note

    The Microsoft .NET Framework 3.5 (including .NET 2.0 and 3.0) item is only available if.NET Framework 3.50 is installed. If the item is not shown, then there is no action for this step.

  5. Expand the root-level item Internet Information Services, expand World Wide Web Services, and then do the following:

    1. Expand Application Development Features, and select the following features:

      • .NET Extensibility 3.5 (if .NET Framework 3.5 is installed)

      • .NET Extensibility 4.5, .NET Extensibility 4.6, or .NET Extensibility 4.7 (for Windows 10)

      • ASP.NET 3.5 (if .NET Framework 3.5 is installed)

      • ASP.NET 4.5, ASP.NET 4.6, or ASP.NET 4.7

      • ISAPI Extensions

      • ISAPI Filters

    2. Expand Common HTTP Features, and then select Defau lt Document, Default Browsing, HTTP Errors, and Static Content.

    3. Expand Security, and then select the following features:

      • Request Filtering

      • Windows Authentication

  6. Under Internet Information Services, expand Web Management Tools, and then select IIS Management Console.

    This is an optional step to install Internet Information Service IIS Manager. You use Internet Information Service IIS Manager to manage local and remote web servers and sites.

  7. Choose the OK button to complete the installation.

  8. To verify that the web server has been installed correctly, start your browser, and then type https://localhost in the address.

    The default web site opens and should display an IIS 8 image.

Install IIS on Windows Server 2012 and 2016

  1. On the Start page, choose Server Manager.

  2. In the navigation pane, choose Dashboard, and then choose Add roles and features.

  3. In the Add Roles and Features Wizard, in the Before You Begin page, choose the Next button.

  4. On the Select installation type page, select Role-based or feature-based installation, and then choose the Next button.

  5. On the Select destination server page, select Select a server from the server pool, select your server from Server Pool list, and then choose the Next button.

  6. In the Select Server Roles window, select Web Server (IIS), and then choose the Next button.

  7. If the Add features that are required for Web Server (IIS) dialog box appears, then choose Add Features.

    Note

    If you do not want to install the IIS Management Console, clear the Include management tools check box, and then choose the Continue button.

  8. On the Select features page, expand .NET Framework N.NN, and then select ASP.NET N.NN.

    N.NN indicates the version number, which will vary between 4.50, 4.60, and 4.70 depending on the Windows Server version.

  9. Expand WCF Services, and then select HTTP Activation.

  10. In the Add features that are required for ASP.NET N.NN? dialog box, choose the Add Features button.

    The following additional features are added.

    • ASP.NET 4.50, 4.60, or 4.70

    • ISAPI Extensions

    • ISAPI Filters

    • .NET Extensibility 4.5, 4.60, or 4.70

  11. If .NET Framework 3.5 is installed, then do the following:

    1. Expand the .NET Framework 3.5 Features node.

    2. Select HTTP Activate.

    3. If the Add features that are required for ASP.NET 3.5 dialog box appears, choose the Add Features button.

      The following additional features are added.

      • .NET Framework 3.5 (including .NET 2.0 and 3.0)

      • .NET Extensibility 3.5

  12. On the Select Features page, choose the Next button.

  13. On the Web Server Role (IIS) page, choose the Next button.

  14. On the Select role services page, verify that the following role services are selected at a minimum.

    • Common HTTP Features

      • Default Document
      • Default Browsing
      • HTTP Errors
      • Static Content

    • Security

      • Request Filtering

      • Windows Authentication

    • Application Development

      • .NET Extensibility 3.5 (if .NET Framework 3.5 is installed)

      • .NET Extensibility 4.5, 4.60, or 4.70

      • ASP.NET 3.5 (if .NET Framework 3.5 is installed)

      • ASP.NET 4.5, 4.60, or 4.70

      • ISAPI Extensions

      • ISAPI Filters

    • Management Tools (optional)

      • IIS Management Console (optional)

    Note

    You can leave other role services that are selected by default as selected.

  15. Choose the Next button

  16. On the Confirm installation selections page, choose the Install button.

  17. On the Installation progress page, confirm that your installation completed successfully, and then choose the Close button.

  18. To verify that the web server has been installed correctly, start your browser, and then type https://localhost in the address.

    The default website opens and should display an IIS image.

Configure Headers in Application Request Routing (ARR) Rules

Dynamics NAV Web Server runs on ASP .NET Core, which requires both an X-Forwarded-For header and X-Forwarded-Proto header in ARR routing rules. However, by default, ARR only adds the X-Forwarded-For header; not the X-Forwarded-Proto header. So will have to configure the X-Forwarded-Proto header manually.

On the server farm in IIS, add or edit a routing rule to include a server variable for X-Forwarded-Proto. For example, using IIS Manager, select Routing Rules > URL Rewrite > Edit > Server Variables, and then add a server variable that has the following settings:

Name Value Replace
HTTP_X_FORWARED_PROTO http ot https true

See Also

Deploying the Microsoft Dynamics NAV Web Server Components
How to: Install the Web Server Components