Configuring Microsoft IIS 6.0

In this section:

This section only applies when using Microsoft IIS as your web server to serve WebFOCUS content.

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. Restart IIS (see Starting and Stopping IIS).
  3. Define aliases that map WebFOCUS directories to directories IIS can reference. IIS calls these mappings Virtual Directories. For details, see Configuring IIS Virtual Directories (Aliases).
  4. Configure communications between IIS and Tomcat. For details, see Configuring IIS to Use the Tomcat Connector (Plug-In).


Top of page

Starting and Stopping IIS

How to:

You should restart IIS to ensure all settings are properly set. You should be aware of how to control IIS because some WebFOCUS components run as part of the web server.

Procedure: How to Start and Stop IIS

To start, stop, or restart IIS, do the following:

  1. Open the services window by selecting Control Panel, Administrative Tools, and then Services.
  2. Right-click IIS Admin Service and choose Start, Stop, or Restart to bring IIS up or down. If you are prompted to start and stop additional services, choose Yes.
  3. Right-click World Wide Web Publishing Service and choose Start or Restart to ensure that all web server components are started. This service always stops, but does not always start, with the IIS Admin Service. When this service does start with the IIS Admin Service, it is not necessary to start it on its own.

Both IIS Admin Service and World Wide Web Publishing Service must be restarted when you make changes to your web server or WebFOCUS configuration.

Top of page

Configuring IIS Virtual Directories (Aliases)

How to:

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

During the WebFOCUS Client installation, if you checked the Configure Aliases on IIS option, aliases are automatically configured for the default IIS website. You should confirm these settings or set them if required. If you want to use a different website, create it at this time. Disabling the default site and creating a new one is a good idea in production environments. Creating additional sites is supported on Windows Server releases, but not Windows Professional releases. For information on creating additional websites, refer to Additional WebFOCUS Configuration Options.

Procedure: How to Confirm or Create Aliases
  1. Restart the IIS Admin and World Wide Web Publishing Services from the Services window to ensure that all settings are refreshed after the install.
  2. Open the Internet Services Manager. To do this from the Start menu, click Run and type:

    Press Enter. The Internet Information Services window opens.

  3. Expand and select your hostname on the left.
  4. On the left, select the website you are using.
  5. Confirm that the first two columns of the following table appear on the right:






    Directory for accessing self-service WebFOCUS applications.


    C:\Program Files\Apache Software Foundation\Jakarta Isapi

    Directory of the Tomcat Connector. This is needed when using Tomcat with IIS.

    If these names and paths appear, then the installation configured them and you can proceed to Setting Permissions.

    If the names do not appear, you must create them.

  6. On the left, select the Default Web Site or the site you are using for WebFOCUS. From the menu bar, select Action, New, and then Virtual Directory.

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

  7. At the first panel, click Next.
  8. Specify the alias name (approot or jakarta) and click Next.
  9. For the directory, browse to and select the directory for the alias. For example:






    C:\Program Files\Apache Software Foundation\
    Jakarta Isapi Redirector\bin\

    The window for setting permissions displays.

  10. For approot, leave the defaults and click Next. If you define the jakarta virtual directory, ensure Run scripts and Execute are checked.
  11. Click Finish.
  12. Select the Default Web Site or the site you are using for WebFOCUS. From the menu bar, 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.

  13. Restart the IIS Admin and World Wide Web Publishing Services from the Services window. Ensure both services restart.

Top of page

Reference: 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 WebFOCUS directories. Then set NTFS permissions to allow those user IDs full access.