Installation Guide

Internet Information Services (IIS) requirements

On-prem only

The web server hosting your Web App, Self Service Portal, and API instances must have Internet Information Services (IIS), an optional component of Windows, installed and properly configured.

Before installing every Alloy Navigator Express web application, the Alloy Installer checks the state of IIS automatically, along with other prerequisites. The information is shown in the "Internet Information Services state" row of the Check Prerequisites window. If the test fails, the Check Prerequisites window displays a warning message along with a hyperlink. Click the hyperlink to open the Details window, where you can view additional information. Then you must install all listed IIS components manually.

NOTE: The Web App, Self Service Portal, and the API module rely on the same required IIS components.

Depending on the operating system hosting your web server, you can install ISS components as follows:

  • On Windows Server 2008 R2 or later, use the Server Manager to install role services for Web Server (IIS).

  • On Windows 7 or later, use the “Turn Windows features on or off” tool to turn on Windows features for Internet Information Services.

Web Server (IIS) role service Features
Common HTTP Features
  • Static Content
  • Default Document
  • HTTP Errors
  • HTTP Redirection

NOTE: Either HTTP Redirection or Static Content Compression component is required.

Application Development
  • .NET Extensibility
  • ISAPI Extensions
  • ISAPI Filters
  • Request Filtering
  • Windows Authentication

NOTE: The Windows Authentication features are required only if you plan to use Windows Authentication in your web application. For details, see Authentication types.

Management Tools
  • IIS Management Console
  • Static Content Compression

NOTE: Either Static Content Compression or HTTP Redirection component is required.

For example, to install the required IIS components on Windows Server 2019, follow these steps:

  1. In Server Manager, select Dashboard, and click Add roles and features.
  2. In the Add Roles and Features Wizard, on the Before you begin page, click Next.
  3. On the Select installation type page, click Role-based or feature-based installation, and click Next.
  4. On the Select destination server page, click Select a server from the server pool, select your server, and click Next.
  5. On the Select server roles page, select Web Server (IIS).
  6. Under the Web Server (IIS) role, expand the Web Server node and select the required IIS components:
    1. Expand the Common HTTP Features node, and then select the Static Content, Default Document, and HTTP Errors check boxes.
    2. Expand the Application Development node, and then select the ASP.NET, .NET Extensibility, ISAPI Extensions, and ISAPI Filters check boxes.
    3. Expand the Security node, and then select the Request Filtering and optionally the Windows Authentication check boxes.
    4. Expand the Management Tools node, and then select the IIS Management Console check box.
    5. Expand the Performance node, and then select the Static Content Compression check box.
  7. Click Next.
  8. On the Confirmation page, confirm your selections, and then click Install to start the installation process.
  9. Click Close to close the Add Roles and Features Wizard.