beautypg.com

Apple WebObjects 3.5: Serving User Manual

Page 32

background image

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.