Installing JRun
Connecting JRun to External Web Servers

Connecting an IIS web server

You can configure JRun to work with Internet Information Server 4.0, 5.0, on Windows NT, 2000, and XP systems.

This section describes the following:

• "Connecting JRun to IIS"
• "Configuring the JRun ISAPI filter"

For more information about advanced web server connection techniques, see JRun Administrator's Guide.

Connecting JRun to IIS

Before configuring IIS, use the following procedure to ensure that the IIS Admin Service startup type is set to automatic or manual, and not disabled:

1. Open the Windows Services utility.
   • (Windows 2000) Select Start > Programs > Administrative Tools > Services.
   • (Windows NT) Select Start > Settings > Control Panel > Administrative Tools > Services.

     The Services control panel appears.

2. Right-click IIS Admin Service, and select Properties.

   The Properties window appears.

3. Select the General tab.
4. In the Startup type drop-down list box, select automatic or manual.
5. Click OK.

Use the following procedure for connecting JRun to an IIS web server.

To connect JRun and IIS:

1. Run the Web Server Configuration tool and connect to a JRun server.

   For details, see "Running the Web Server Configuration tool".

2. In the Web Server Properties section of the Web Server Configuration tool, select Internet Information Server (IIS), as the following figure shows:

   

3. Select the IIS website that you want to configure.

   The IIS website specifies the location of the filter or application mappings.

   Note:   All means install the filter and application mappings at the global level so that they apply to all websites that currently exist. For more information, see .

4. To enable the following connector settings, click Advanced:
   • Verbose logging in the connector log
   • The native OS memory allocator, not the web server memory allocator

     

5. In IIS Settings section, specify Use ISAPI filter or Use Application Mappings.

   ISAPI filter  JRun installs an ISAPI filter module, which IIS invokes to handle events during HTTP request processing.

   Application mappings  An application mapping connects a filename extension with the application that processes the file. For example, if you select .jsp, when the web server receives a request for a .jsp file, it uses the mapping to the JRun web server connector to process the page. By selecting application mappings, you turn off the ISAPI filter and gain the use of IIS security in JSP pages.

   • To add an application mapping, enter the file extension in the text box next to the Add button, and click Add.
   • To delete an application mapping, select it in the list box and click Delete.

     You cannot delete a mapping if it is the only one specified. You must have at least one mapping specified in the list box.

   Note:   In Web Server Properties, if you selected a website, the filter or application mappings are applied at the website level. If you selected All, the filter or application mappings are applied at the global level.

6. Click OK.

   JRun connects to the web server.

7. Ensure that your web server is running.
8. To verify the JRun connection to your IIS web server, open a web browser on the IIS web server to the following URL: http://web-server-hostname.

   Note:   This step assumes that IIS is listening for connections on the default port 80. If not, use http://web-server-hostname:webserver-port-number.

   The default page for the web server to which you connected appears, showing that you successfully configured the connection between JRun and your external web server.

Note:   JRun creates an IIS virtual directory, called JRunScripts, for each website that you configure. If you install IIS at the global level, the Web Server Configuration tool creates a JRunScripts directory for each existing website. If you configure a website after you installed JRun, you must run the Web Server Configuration tool again to create a JRunScripts directory for the new website.

Removing the JRun connection to IIS

You can remove the web server configuration in one of two ways:

• Using the Web Server Configuration tool:

  

  Select the IIS web server configuration, and click Remove.

• Using the following command:

  java -jar jrun_root\lib\wsconfig.jar -ws iis -site sitename -r
  

Configuring the JRun ISAPI filter

ISAPI filters can respond to events when IIS receives an HTTP request. If you select Use ISAPI Filter while running the Web Server Configuration tool, JRun installs a DLL that is added to the other ISAPI filters in the web server memory. The location of the jrun.dll file is in a subdirectory under jrun_root\lib\wsconfig.

The instructions in this section are optional. The default configuration of JRun does not require you to make any changes to the JRun ISAPI filter. However, if you install other ISAPI filters, you might have to make changes.

Prioritizing the JRun ISAPI filter

When several ISAPI filters register for the same event (or notification), IIS calls them sequentially. Filters with a higher priority are run before filters with a lower priority. The priority levels High, Medium, and Low are read-only properties that you cannot change using the Internet Services Manager or other metabase editor. The JRun priority level is High.

While you cannot change a filter's priority level, you can determine which filter responds to an event first if it shares the same priority level as another filter. Use the following procedure to change the JRun ISAPI filter's priority.

To change the priority of the JRun ISAPI filter:

1. Open the Internet Service Manager:
   • (Windows NT) Select Start > Programs > NT 4.0 Option Pack > Microsoft Internet Information Server > Internet Service Manager.

     The Microsoft Management Console (MMC) appears and opens the iis.msc Snap-In.

   • (Windows 2000) Select Start > Programs > Administrative Tools > Internet Services Manager.

     The Internet Services Manager appears.

2. Right-click the website name and select Properties.

   The Properties window appears.

   If you installed a global filter, right-click the system name and select Properties or click the system name to expand the list of websites.

3. Select the ISAPI Filters tab.
4. Select JRun Connector Filter from the list of available ISAPI filters.
5. To move the JRun filter ahead of the other filters in the list, click the up arrow.
6. Click OK.

   Your changes are applied.

7. Restart your web server.