Apple WebObjects 3.5: Serving User Manual
Page 32

Administrative Tasks
33
2. Click the Add Instance button to add a new instance of the application.
3. If you want the instance to run on a different host, click the More
button for that instance, scroll down in the bottom frame until you see
the host name field, enter the name of the host you want that instance
to run on, and click the Save Settings button at the bottom of the frame.
4. To start the application instance, click the On/Off switch in the
Instance Status field.
When you create multiple application instances in this manner, you are
creating the public configuration file
NeXT_ROOT
/NextLibrary/WOAdaptors/Configuration/WebObjects.conf
. When the adaptor
receives an HTTP request for an application, it first (in its initial mode)
checks
WebObjects.conf
for an application instance that is accepting
connections and forwards the request to it. The section “WebObjects
HTTP Adaptors” describes in some detail both the public configuration file
and the adaptor modes involved in load balancing.
Note that Monitor always assigns a unique number to each application
instance, even if it is running on a different host. It does this so that it can
recover a crashed instance for you. If an instance dies, Monitor can try to
recover it by launching it on another host. Because of this, instance numbers
must be unique across hosts.
The
WebObjects.conf
file, however, only requires an instance number to be
unique on a given host. Consider the example given previously, where two
Click here to add a new instance.
Click here to start the instance.