The WebObjects.conf configuration file is a text file that you create in your Web server's cgi-bin directory.
Note: If you want to use the WebObjects.conf file with WebObjects' Netscape Interface (NSAPI) Adaptor, then locate WebObjects.conf in your ns-home/http[d/s-port]/config/ directory rather than in your Web server's cgi-bin directory.
The WebObjects Adaptor inspects the WebObjects.conf file to resolve URL information or to autostart a WebObjects application.
The way in which you specify WebObjects applications in the WebObjects.conf file lets you institute load-balanced distribution of WebObjects applications across your network.
The WebObjects.conf configuration file is a line-oriented ASCII file that on each line names an application, host, and maximum number of instances to run on the host, using space character separators.
The format of a line in the configuration file WebObjects.conf is always
[ApplicationDirectory]:[ApplicationNumber]@[hostname] [ApplicationPort]
- [ApplicationDirectory] is the path below the WebObjects directory of your Web server's DocumentRoot which lets the adaptor find the application's resources.
- [ApplicationNumber] lets you identify a particular instance of a WebObjects application.
- @[hostname] lets you identify a particular host computer.
- [ApplicationPort] lets you specify a port for a particular instance of a WebObjects application on a particular host.
Note the following additional rules for creating a WebObjects.conf file.
- The WebObjects Adaptor skips empty lines in the configuration file.
- You can add comment lines. The WebObjects Adaptor will attempt to parse them, then skip them.
- You can specify up to 256 applications with the same name. The WebObjects Adaptor will ignore any more.
- The WebObjects Adaptor will parse the first 256 characters of each line, skipping subsequent characters.
Here are sample contents of a WebObjects.conf file:
Examples/HelloWorld:1@onemachine 3000
Examples/CyberWind:2@twomachine 2002
Examples/CyberWind:1@threemachine 4000
Examples/CyberWind:4@fourmachine 2004