|
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:
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
|