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:
Note:
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.
To start, stop, or restart IIS, do the following:
Both IIS Admin Service and World Wide Web Publishing Service must be restarted when you make changes to your web server or WebFOCUS configuration.
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.
inetmgr
Press Enter. The Internet Information Services window opens.
Name |
Path |
Purpose |
---|---|---|
approot |
drive:\ibi\apps |
Directory for accessing self-service WebFOCUS applications. |
jakarta |
C:\Program Files\Apache Software Foundation\Jakarta Isapi Redirector\bin\ |
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.
This launches the New Virtual Directory Wizard. Go through the wizard one time for each virtual directory that you want to create.
Name |
Path |
---|---|
approot |
drive:\ibi\apps |
jakarta |
C:\Program Files\Apache Software Foundation\ Jakarta Isapi Redirector\bin\ |
The window for setting permissions displays.
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.
Two kinds of permissions issues are involved when using IIS:
IIS permissions determine what IIS is allowed to do. You can set this through the Internet Services Manager for the WebFOCUS aliases (virtual directories).
If the WebFOCUS installation configures IIS for you, they should default correctly. The jakarta alias should have Scripts and Executables permissions.
NTFS permissions determine what each user ID is allowed to do through the file system. You can set this in Windows Explorer or My Computer by right-clicking a folder, choosing Properties, and clicking the Security tab. NTFS permissions take precedence over IIS permissions. If the user ID that IIS runs under does not have NTFS permissions to write to a directory, then IIS cannot write to that directory.
IIS and Tomcat need access to the WebFOCUS directories. However, when using IIS with Apache Tomcat, you normally do not need to set NTFS permissions. IIS needs only Read NTFS permissions, which it should have by default. Tomcat runs as the Local System account, which automatically has full access. These defaults can be changed, as explained in Tomcat Security Tips.
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.
WebFOCUS |