Microsoft IIS Web Server ISAPI Adaptor for WebObjects


Please familiarize yourself with your WebServer's documentation here.

To install this adaptor, copy the file WebObjects.dll to your web server's scripts directory. The adaptor will be loaded into the server the first time a request of the form http://.../scripts/WebObjects.dll is made. It will remain active in the server until you stop the server.

ISAPI doesn't provide any specific way to pass information into the adaptor, so the Registry is used. Modifying the Registry should only be done by an experienced Windows NT/2000 Adminstrator. To do so, from the Start Menu, choose Run ... and type in "regedit" and return.

Look for the panel titled HKEY_LOCAL_MACHINE.

All WebObjects adaptor entries are found in: SOFTWARE\Apple\WebObjects\Configuration

To change the configuration URL, you need to add the following entry:

  CONF_URL <URL>

Choose New->String Value from the edit menu. Type in "CONF_URL" for the name. Enter the URL you want to use for the value. This might, for example, be file:///Apple/Local/Library/WebObjects/Configuration/WebObjects.conf, if you want to use the old-style configuration. The default is http://localhost:1085.

The URL entered will depend on how you wish to retrieve adaptor configuration:

  1. to read configuration from a static URL:
     
    file:///Local/Library/WebObjects/Configuration/WebObjects.xml
    http://www.company.com/private/woappconfig.xml
    
  2. to find applications running on known hosts:
     
    http://woserv1:1085,http://woserv2:1085,http://woserv2:1085
    
  3. to discover hosts using multicast:
     
    webobjects://239.128.14.2:1085 
    
To set the re-read interval for either the host list or multicast mechanisms, set a separate registry entry named "CONF_INTERVAL" to the desired re-read interval in seconds.

Here are some other registry entries recognized by the ISAPI adaptor. The values are as described in the .xml configuration example or the DTD for the adaptor:

	"WOUSERNAME",
	"WOPASSWORD",
	"CONF_INTERVAL",
	"CONF_URL",
	"SEND_TIMEOUT",
	"RECV_TIMEOUT",
	"CONNECT_TIMEOUT",
	"TIMEOUT",
	"POOL_SIZE",
	"RETRIES",
	"DORMANT_INTERVAL",
	"ERROR_REDIRECT",
	"LOG_PATH",
	"SCHEDULER",
	"DOCUMENT_ROOT".
Setting WOUSERNAME to "public" allows anyone to see the WOAdaptorInfo page.