Configure IIS

To configure IIS:

  1. IIS must be configured to use a local user account or a network user account. The best practice is for this user account to be named ewservice. These instructions will refer to the account as ewservice, but that does not have to be the name of the account.
    If you need to create the ewservice account:

    • If you wish to create ewservice as a network account, do so. You may need to specify the network domain.

    • Or, if you wish to create ewservice as a local account, you can do so in the following manner:

      1. Open the server's Start Menu, search for User Accounts, and open it.
      2. The User Accounts page will open. Click Manage Another Account.
      3. The Manage Accounts page will open. Click Add a user account. It appears at the bottom of the list of users.
      4. If the following user does not exist, create it.

        • user account: ewservice

        • password: <ewservice-password>

  2. Ensure that the ewservice user has the necessary permissions:
    1. Ensure that the ewservice user has the necessary permissions for the <drive>:\Enterworks folder:
      1. Right-click the <drive>:\Enterworks folder and select Properties.
      2. Open the Security tab.
      3. If ewservice does not appear in the list titled Group or user names, add it:
        1. Click Edit.
        2. Click Add.
        3. In the Enter the object names to select box, type ewservice.
        4. Click Check Names.
        5. Click OK.
      4. In the Group or user names box, click ewservice.
      5. In the Permissions for ewservice list, see if ewservice has the checkbox for Full control permission checked. If it doesn't:
        1. Click Edit.
        2. Select ewservice.
        3. In the Permissions for ewservice list, check the checkbox for Full control.
        4. Click Apply.
    2. Using the same process, ensure that the ewservice user has Modify permission for the folders:

      • C:\Windows\Microsoft.NET\Framework\v4.0.30319\Temporary ASP.NET Files

      • C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Temporary ASP.NET Files

  3. Open IIS Manager: From the Start Menu, select Administrative Tools, then select Internet Information Services (IIS) Manager.
  4. Configure the IIS application pools.
  5. Set the Default Document file.
    1. In the left navigation tree, click Default Web Site.
    2. In the center screen, double-click the Default Document icon. The Default Document list will appear.
    3. If default.aspx does not appear in the list of files, add it.
      1. In the Actions menu on the right, click Add.
      2. The Add Default Document window will appear. In the Name field, enter default.aspx.
      3. Click the OK button to save the filename and return to the Default Document window.
    4. If default.aspx does not appear at the top of the list of files, select it, then use the Move Up button in the Actions menu to move default.aspx to the top of the list.
  6. Configure the IIS virtual directories.
  7. Give the isapi_redirect.dll file the ability to be executed:
    1. In the IIS Manager’s left navigation tree, click the server's node.
    2. In the center pane, double-click ISAPI/CGI Restrictions.
    3. The ISAPI and CGI Restrictions page will open. It displays a list of the already allowed ISAPI’s and CGI’s. In the Actions menu on the right, click Add.
    4. The Add ISAPI or CGI Restriction window will open. Enter the following configuration settings:

      • ISAPI or CGI path: <drive>:\Enterworks\IISProxy\isapi_redirect.dll

      • Description: Jakarta

      • Allow extension path to execute: Check this box.

    5. Click OK to return to the ISAPI and CGI Restrictions page.
  8. Add a new filter for the IIS Proxy:
    1. In the IIS Manager’s left navigation tree, select Default Web Site.
    2. In the center pane, double-click ISAPI Filters.
    3. The ISAPI Filters page will open. It displays a list of the already configured filters. In the Actions menu on the right, click Add.
    4. The Add ISAPI Filter window will open. Enter the following configuration settings:

      • Filter name: Jakarta

      • Executable: <drive>:\Enterworks\IISProxy\isapi_redirect.dll

    5. Click OK to return to the ISAPI Filters page.
  9. Set handler mappings:
    1. In the IIS Manager’s left navigation tree, double-click Default Web Site.
    2. In the center pane, double-click Handler Mappings.
    3. The list of mapped handlers will appear. The list is separated into two sections, one for disabled handlers and one for enabled handlers. In the Disabled section, select ISAPI-dll.
    4. In the Actions menu on the right, click Edit Feature Permissions…
    5. The Edit Feature Permissions window will appear. Check the following checkboxes to set the permissions:

      • Read

      • Script

      • Execute

    6. Click OK to exit the Edit Feature Permissions window.

You have finished configuring IIS.