Main -> Documentation -> WebZ System Administration -> Configuring the WebZ Extension -> Configuring Microsoft Internet Information Server (IIS) to Use the WebZ Extension

Configuring Microsoft Internet Information Server (IIS) to Use the WebZ Extension

 

Contents

Introduction
Document Conventions
Requirements
IIS Configuration Procedure for SiteSearch 4.1.2/4.1.2a – WebZ
IIS Configuration Procedure for SiteSearch 4.1.2/4.1.2a– Record Builder
IIS Configuration Procedure for SiteSearch 4.1.1 and 4.1.0


Introduction

You must configure the Microsoft Internet Information Server (IIS) WebZ Extension for WebZ access after you complete the WebZ Extension installation. This document describes several additional configuration steps required to allow the extension to access the WebZ system and (optionally) Record Builder.

This document contains three configuration procedures – one each for IIS and SiteSearch 4.1.2/4.1.2a WebZ, IIS and SiteSearch 4.1.2/4.1.2a Record Builder, and IIS and SiteSearch 4.1.0 and 4.1.1.

Note:

The OCLC SiteSearch suite supports IIS for only the Windows NT operating system.


Document Conventions

  • <WebZ_root> refers to the location of your WebZ environment.
  • SiteSearch 4.1.x refers to SiteSearch 4.1.0, 4.1.1, 4.1.2, or 4.1.2a.
  • SiteSearch 4.0.x refers to SiteSearch 4.0.0, 4.0.0a, 4.0.1, or 4.0.2.

Requirements

You must complete the following tasks before configuring the IIS WebZ Extension:

  • Install your IIS server.
  • Set up a Web server for WebZ and Record Builder (if applicable) on IIS.
  • Review the Open SiteSearch suite system requirements for Web servers. Note that with IIS as your Web server, it is not possible to run WebZ and Record Builder simultaneously on a single machine. Your options are to:
    • Use Netscape as your Web server, which will allow you to run WebZ and Record Builder simultaneously on the same machine.
    • Use IIS as the Web server for a WebZ-only environment and Netscape as the Web server for a Record Builder-only environment or a WebZ/Record Builder environment.
    • Use Netscape as the Web server for a WebZ-only environment and IIS as the Web server for a Record Builder-only environment.
    • Use IIS as the Web server for a WebZ-only environment on one machine and IIS as the Web server for a Record Builder-only environment on another machine.

    (A Record Builder-only environment refers to a SiteSearch environment where you run only Record Builder. Record Builder still requires both WebZ and Database Builder in its SiteSearch environment.)

  • Install the IIS WebZ Extension for SiteSearch 4.0.x, 4.1.0, or 4.1.1. For SiteSearch 4.1.2/4.1.2a, the WebZ installation includes the IIS WebZ Extension.
  • Install WebZ and (optionally) Database Builder.

You must also have complete system root access to your Windows NT server to ensure that you can make the registry changes needed for the IIS WebZ Extension configuration.

Important Note: Refer to the IIS documentation for information regarding server administration and operation.

Return to Contents


IIS Configuration Procedure for SiteSearch 4.1.2/4.1.2a – WebZ

Complete the following steps to configure IIS to work with the WebZ Extension and WebZ. In this procedure, you:

  • Add the WebZ extension as an ISAPI filter for the IIS master server and the Web server for WebZ.
  • Add the SSPI filter as an ISAPI filter for the IIS master server.
  • Set the document root for WebZ in its IIS Web server.
  • Add information about the WebZ extension to the Windows registry.

1. Open the IIS Internet Service Manager.

2. Add the WebZ extension for IIS as an ISAPI filter for the IIS master server:

  • Right-click the icon for the master server.
  • Select Properties from the context menu.
  • On the Internet Information Server dialog tab, click the Edit button beside Master Properties.
  • Click the ISAPI Filters tab.
  • Click the Add button.
  • On the Filter Properties dialog box, enter a name for the WebZ extension and the name and location of its executable file (<WebZ_root>/isapi/isapiwebz.dll). Click OK.
  • On the ISAPI Filters tab, click Apply.

3. Add the SSPI filter as an ISAPI filter for the IIS master server. From its ISAPI Filters tab (the tab open at the end of step 2):

  • Click the Add button.
  • On the Filter Properties dialog box, enter a name for the SSPI filter and the name and location of its executable file (C:\Winnt\System32\inetbay\sspifilt.dll). Click OK.
  • On the ISAPI Filters tab, click Apply. Then click OK.
4. Click OK to close the master server's Properties tabs.

5. Add the WebZ extension for IIS as an ISAPI filter for WebZ.

  • Click the + sign beside the master server to display the Web servers defined for Web sites and FTP sites.
  • Right-click the icon for the Web server you are using for WebZ.
  • Select Properties from the context menu.
  • Click the ISAPI Filters tab.
  • Click the Add button.
  • On the Filter Properties dialog box, enter a name for the WebZ extension and the name and location of its executable file (<WebZ_root>\isapi\isapiwebz.dll). Click OK.
  • On the ISAPI Filters tab, click Apply.
  • Click OK.

6. Add information about the WebZ extension to the Windows registry:

  • Use Windows Explorer to go to the <WebZ_root>\scripts directory.
  • Double-click the webz.reg file.
  • You receive a message confirming that information from webz.reg has been entered into the registry. Click OK.
Note: This script adds information about the WebZ extension to HKEY_LOCAL_MACHINE\SOFTWARE\OCLC in the registry.
7. Set the document root for the WebZ's Web server as <WebZ_root>\htdocs\obiv1 (or the directory under <WebZ_root>\htdocs that contains your customized HTML files, if applicable).

8. Restart your NT system and IIS to read in the configuration changes you made to the registry.

9. Verify that the IIS Administrative Service and the World Wide Web Publishing Service are running.
10. Open the <WebZ_root>\ini\WebSvrExt.ini file in a text editor. Review the values defined in this file to ensure that they are accurate. Make any necessary changes, although it is not likely that you need to change anything. Save and close the file.
11. Use the IIS Internet Service Manager to start the Web server for WebZ if it is not already running.

12. Start the WebZ System and test access to the system through IIS using a Web browser.

Return to Contents


IIS Configuration Procedure for SiteSearch 4.1.2/4.1.2a – Record Builder

Complete the following steps to configure IIS to work with the WebZ Extension and Record Builder. In this procedure, you:

  • Verify that you can run WebZ with IIS on the machine you plan to use for running Record Builder with IIS.
  • Add the WebZ extension as an ISAPI filter for the Web server for Record Builder.
  • Set the document root for Record Builder in its IIS Web server.
  • Edit <WebZ_root>\ini\WebSvrExt.ini so that it points to Record Builder's JaSSIRB server rather than WebZ's JaSSI server.
  • Prevent WebZ's servers from starting when you start Record Builder (optional).

1. Follow the IIS configuration procedure for SiteSearch 4.1.2/4.1.2a for WebZ on the machine on which you plan to run IIS with Record Builder. Verify that WebZ functions properly under IIS.

2. Shut down WebZ.
3. Open the IIS Internet Service Manager.
4. Set up a Web server for Record Builder in IIS if you have not already done so. Set its document root as <WebZ_root>\htdocs\rbv0.
5. Shut down the Web server for WebZ.

6. Add the WebZ extension for IIS as an ISAPI filter for Record Builder.

  • Click the + sign beside the master server to display the Web servers defined for Web sites and FTP sites.
  • Right-click the icon for the Web server you are using for Record Builder.
  • Select Properties from the context menu.
  • Click the ISAPI Filters tab.
  • Click the Add button.
  • On the Filter Properties dialog box, enter a name for the WebZ extension and the name and location of its executable file (<WebZ_root>\isapi\isapiwebz.dll). Click OK.
  • On the ISAPI Filters tab, click Apply.
  • Click OK.

7. Use the Windows Control Panel to stop the IIS Administrative Service and the World Wide Publishing service.

8. Edit <WebZ_root>\ini\WebSvrExt.ini file:

  • Review the values defined in this file to ensure that they are accurate and edit them if necessary.
  • Add this line to the end of the file. Remember to add a carriage return at the end of the line.

    ServerType1 = jassirb

9. Do you want to prevent WebZ's servers (JaSSI, ZBase, and Access) from starting when you start Record Builder? Since you cannot run WebZ and Record Builder simultaneously on the same machine with IIS, there is no need for them to start when you are running Record Builder.

  • Yes. Edit the [ServerType] section of <WebZ_root>\ini\OpServe_rb.ini.
    • Comment out or remove the JaSSI, ZBase, and Access lines.
    • Renumber the remaining lines so that the section looks like this:

      [ServerType]
      ServerType1 = OpServe
      ServerType2 = Lock
      ServerType3 = JaSSIRB
      ServerType4 = ZBaseRB
      ServerType5 = AccessRB

  • No. Go directly to step 10.
10. Use the Windows Control Panel to restart the IIS Administrative Service and the World Wide Publishing service.
11. Use the IIS Internet Service Manager to start the Web server for Record Builder.

12. Start Record Builder and test access to Record Builder through IIS using a Web browser.

Return to Contents


IIS Configuration Procedure for SiteSearch 4.1.0 and 4.1.1

Complete the following steps to configure IIS to work with the WebZ Extension.

1. From the Start menu, select Run.

2. Type "regedt32" in the Run window and click OK. The Registry Editor window will appear.

3. From the HKEY_LOCAL_MACHINE on Local Machine screen, open the following directories and subdirectories on the left portion of the screen: HKEY_LOCAL_MACHINE -> SYSTEM -> CurrentControlSet -> Services -> W3SVC -> Parameters.

4. Review the variables contained in the Parameters subdirectory listed on the right-hand side of the screen. Double click on the Filter DLLs variable and add the following line of text below to the value of the variable in the String Editor:

    <WebZ_root>\isapi\isapiWebZ.dll
    Note:

    If the Filter DLLs variable does not exist in the Parameters subdirectory, you will need to add the variable. From the Edit menu, select Add Key. In the Add Key window, type "Filter DLLs" in the Key Name field and add the value shown above. Click OK and check to see if the variable now shows up in the list with the correct value.

    Make sure to separate multiple paths with a comma (","). For example, after you make the changes above, the value of Filter DLLs may look similar to the following:

    D:\WINNT\System32\inetsrv\sspifilt.dll,
    D:\Inetpub\wwwroot\scripts\isapiWebZ.dll

The second value reflects the location of the WebZ Extension DLL. Notice that the path names included above are separated by a comma.

5. Click OK to close the String Editor. Make sure that the changes you made are now visible in the right-hand portion of the HKEY_LOCAL_MACHINE screen.

6. Exit the Registry Editor.

7. Open the <WebZ_root>\ini\WebSvrExt.ini file in a text editor. Review the values defined in this file to ensure that they are accurate. Make any necessary changes. Save and close the file.

8. In your IIS configuration, define the <WebZ_root\/htdocs\obiv1 directory (or another directory under <WebZ_root>\htdocs that contains your customized HTML files) under as your document root.

Note: For Record Builder, you need to define your document root as <WebZ_root>\htdocs\rbv0.

9. Restart your NT system and IIS to read in the configuration changes you made to the registry.

10. Start the WebZ System and test access to the system through IIS using a Web browser.

Return to Contents


See Also

Installing and Configuring the Open SiteSearch Suite
Operating the WebZ System for Windows NT
Operating Record Builder for Windows NT
Configuring the WebZ Extension


[Main][Documentation][Support][Technical Reference][Community][Glossary][Search]

Last Modified: