General Info Template Language WCTL Commands WebX/Chat WebX/Pro
Release Notes Standard Templates URL Codes WebX/Multi NSAPI Config

Visit the Web Crossing Conference to find a wealth of WebX info and a community of WebX experts on the Web!

Web Crossing IISAPI Module

Table of Contents

Revision History
About IIS Web Crossing Interface
Installation

» Revision History

08SEP97

  • Added Instructions for editing NT Registry Settings through new Web Crossing Configuration Program
  • 28AUG97

  • Initial Distribution.
  • » About Web Crossing IIS API Interface

    Web Crossing Internet Information Server (IIS) API Interface is a plug-in module designed exclusively to work with Microsoft's IIS in conjuction with Web Crossing Server. This dynamically loaded library (.dll) provides the interface between the Web Crossing Server and the requests from users through their WWW browers. Initial tests have shown at least a 2X improvement in speed and access of the discussion forums in Web Crossing. It also allows a much larger message to be posted, bypassing the problems in IIS in terms of the length of posted messages.

    The IISAPI version of the script program also acts as a filter for incoming URL requests to your server. This is activated through the NT Registry settings and is designed to allow older saved or cached bookmarks to continue to work without any effort of your users. It takes the old script name and converts it into the new name automatically. You will notice that eventually all of the links in Web Crossing will incorporate the new URL with "webx.dll".

    Installation consists of copying the new file "webx.dll" into the same directory as the previous script file "webx.exe". This effectively replaces the standard method of accessing Web Crossing. Some settings in the NT registry must also be modified to work with Microsoft IIS.

    » Installation

    » Copying WebX.dll to the right location

    The file "webx.dll" that came with this distribution must be copied to the right location in your normal server document directory. If your site URL is something like: http://www.yoursite.com/scripts/webx.exe? then you must copy the file "webx.dll" into the directory specified by your virtual directory "/scripts" on your hard disk. This is probably something like: "c:\inetsrv\scripts\*". This should be the same location as your existing file "webx.exe".

    » Editing NT Registry Settings

    A few changes must be made to the NT registry settings to allow the filter portion of the WebX.dll to work correcly. If you do not require the filter, then you may skip this section and the filter will not be activated.

      Edit NT Registry Settings through Web Crossing Configuration

    1. Run "Web Crossing Configuration" and select the "IISAPI" tab. Note: if you do not see this tab, then you must install the latest version of Web Crossing Configuration.
    2. Edit the "Currently Installed IIS Filters" box to add the FULL path to the "webx.dll" file that was previously installed into your "scripts" directory. Make sure to separate this new path from the others with a comma (,). Don't erase any of the other settings that are already installed.
    3. Edit the "Old Web Crossing Script Name" to match the URL portion of your site which directed users to Web Crossing, usually "/scripts/webx.exe"
    4. Edit the "New Web Crossing Script Name" to match the new URL to your site, usually "/scripts/webx.dll"
    5. Close the Configuration program and move to the next step, Restarting Microsoft IIS.
    6. Edit NT Registry Settings Manually

    1. Run "regedt32.exe" from the command line or from the "Start -> Run" menu. This is usually located in your NT system32 directory.
    2. Open the Registry for the computer on which Web Crossing and your IIS server is running
    3. Open the setting for : System/CurrentControlSet/Services/W3SVC/Parameters
    4. Edit the value "Filter DLLs and edit the list of filters to add the FULL pathname of the location of the "webx.dll" file that was copied in the earlier step. NOTE: All of the installed filters must be separated by a ',' (comma).
    5. Use the "Edit -> Add Key" menu to add a key called "WebX". Leave the "class" box empty.
    6. Open this newly created "WebX" Registry folder
    7. Use the "Edit ->Add Value" menu to add two values called "OldScript" and "NewScript" as the value names and the URL portion of each for the string box. ie. OldScript would be "/scripts/webx.exe" and NewScript would have the value "/scripts/webx.dll"
    8. Verify that these settings are correct and close the Registry Editor.

    » Restart Microsoft IIS

    You must restart Microsoft IIS WWW server so that the settings will be loaded correctly. Use the "Internet Service Manager" or the NT Services Control panel to stop and start the server.


    Copyright © 1996-97 by Lundeen & Associates, Alameda, California.