Configuring Microsoft IIS 6

In this section:

This section only applies when using Microsoft IIS as your web server.

IIS is a web server and does not process Java on its own. Therefore, to run the WebFOCUS Servlet, IIS should be used with Apache Tomcat or another application server. This document assumes you are using Apache Tomcat.

Configuration steps are the following:

  1. Configure Tomcat, as explained in Configuring Apache Tomcat.
  2. Define aliases that map directories containing App Studio files to directories the web server can reference, as explained in How to Confirm or Create Virtual Directories (Aliases). IIS calls these mappings Virtual Directories.
  3. Configure communications between IIS and Tomcat, as explained in Configuring Microsoft IIS to Use the Tomcat Connector (Plug-in).

Top of page

Configuring IIS Virtual Directories (Aliases)

How to:

App Studio connectivity components and other web-based features sometimes run as part of the web server. Therefore, IIS must be told the locations of App Studio files and have sufficient access to those files.

Before configuring IIS, it is a good idea to restart it. You can start and stop IIS from the Services Window, as explained in How to Start Apache Tomcat or Microsoft IIS.

Procedure: How to Confirm or Create Virtual Directories (Aliases)
  1. Open the Internet Services Manager. You can access this from the Start menu by selecting Run and entering the following:

    The Internet Information Services window appears when you press Enter.

  2. Expand and select your host name on the left side.
  3. Expand Web Sites and then select Default Web Site or the site you are using.
  4. Confirm that the Name and Path columns of the following table appear on the right of the window:







    Read Only

    Directory where you store application files.

    • If the above name and path appear, proceed to Setting Permissions.
    • If approot does not appear, you should add it.
  5. To add approot, select the Default Web Site or site you are using for WebFOCUS, and then use the menu bar to select Action, New, and then Virtual Directory.

    This launches the New Virtual Directory Wizard. Go through the wizard one time for each virtual directory you wish to create.

  6. Click Next at the first panel.
  7. Specify the alias name (approot) and click Next.
  8. For the directory, browse to and select the directory for the alias. For example:


    Directory Path



    The window for setting permissions displays.

  9. Leave the defaults when defining approot and click Next.
  10. Click Finish.
  11. Select the Default Web Site or site you are using for WebFOCUS, and then use the menu bar to select Action, New, and then Virtual Directory.

    Repeat the steps if you need to define another virtual directory. Your website must be selected so that the virtual directories become its subdirectories. After creating a virtual directory, ensure that your site is selected and not the virtual directory you just created.

  12. Restart IIS from the Services window.

Top of page

Setting Permissions

Two kinds of permissions issues are involved when using IIS:

If you need to set NTFS permissions, determine which user IDs require access to App Studio directories. Then set NTFS permissions to allow those user IDs full access.