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.
On IIS6 take care to register WebObjects.dll as registered WebServer extension.
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:
file:///Local/Library/WebObjects/Configuration/WebObjects.xml http://www.company.com/private/woappconfig.xml
http://woserv1:1085,http://woserv2:1085,http://woserv2:1085
webobjects://239.128.14.2:1085
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.
Additionally to the tasks mentioned above, you have to take care that ISAPI-extensions are installed. WebObjects.dll has to be registered unter CGI-/ISAPI-Restrictions. Unter Handler-Mappings, enable DLL-Exection.
By using MINGW you can build WebObjects-Adaptor as 32bit and as 64bit-DLL.
The 32-Bit-DLL will run fine on 32-Bit IIS and 64-Bit-DLL will run fine on 64-Bit IIS.
When you intend to use the 32-Bit-DLL with an 64-Bit IIS, take care to configure the application pool to run in 32 bit mode and configure all registry keys named above in the Wow6432Node.