WebObjects Server Adaptor Installation
WebObjects provides several alternative adaptors, depending upon your WebServer and platform.
There are plugin-style adaptors (Apache, ISAPI, NSAPI) and a generic CGI executable.
We generally recommend using a server plugin for deployment in preference to the generic CGI adaptor
simply because they offer significant performance benefits and more control over
load-balancing/scheduling.
For more detail on the pros and cons see the WebObjects Adaptors reference in WOInfoCenter.
The 4.5.1 adaptors are an evolution of the 4.0 adaptors.
Among the features which differentiate them from the 4.0 WebObjects adaptor:
- Many aspects runtime configurable, including:
- Load balancing strategy
- App-adaptor communication transport
- Socket Timeouts
- App URL version (supports 3.5, 4.0 and 4.5 app URLs)
- Error redirect URLs
- Scheduling improvements: added Instance load based scheduling
- XML based configuration file format
- Simpler, automatic configuration for multiple web servers - no more config files
- Radically improved performance
In order to get the optimum performance and availability from your deployed web apps,
you may want to experiment with the various settings for connection pools, timeouts and
buffer sizes.
Installation and Configuration
This document describes only the general aspects of installing and configuring the WebObjects WebServer adaptors. For information on installing specific adaptors,
see the installation files for
CGI,
Apache,
Microsoft ISAPI,
Netscape NSAPI.
CGI
The CGI adaptor should be installed automatically in the correct location when you
installed WebObjects 5.0 on a platform that is supported. If you are installing on a separate WebServer you need to
copy the CGI executable into the cgi-bin or Scripts directory on your WebServer(s).
You may need to enable CGI programs for that directory if you haven't already done so.
How this is done varies from server to server so please consult your WebServer
administration documentation.
Server Plugin Adaptors
For supported platforms, we have a list of server plugin adaptors that will be installed together with WebObjects. Depending on the platform, you will need to configure the installed adaptor or move it to the correct directory as well.
Platform |
|
Installed adaptors |
Mac OS X |
|
Apache |
Solaris |
|
Apache, NSAPI |
Windows NT/2000 |
|
Apache, IIS |
It is possible to build other plugin adaptors for a platform (for example, NSAPI for Windows) but it will be unsupported by Apple. Please consult the adaptor-specific installation files and your webserver adminstration documentation.