Apple WebObjects 3.5: Serving User Manual

Serving WebObjects

Setting Up the Monitor Application11Initial Monitor SetupIn normal operation, when you start up Monitor, all of the WebObjects applications on your si

Serving WebObjects12Local host nameThe name of the server Monitor is running on. Admin user nameProtects the Monitor from being used by all users exce

Setting Up the Monitor Application13WebObjects executable nameThe executable that you want to use as the default executable for all appli-cations you

Serving WebObjects14The right frame displays the Add Application Panel, which looks like this:5. For each application that you want to administer usin

Administrative Tasks15d. Click the Add to Declared Apps button.Monitor updates the port number and instance number fields for you. When you use the Add

Serving WebObjects16Load Balancing Increasing the Listen Queue Depth Installing and Configuring NSAPI Adaptors Installing and Configuring the ISAPI Ad

Administrative Tasks17which means that if you install scripted components under the document root, you are exposing source code to outside users. Inst

Serving WebObjects183. Click the On/Off button located in the Instance Status field.Monitor starts an instance of your application by creating a new ta

Administrative Tasks19• If the application is to run on the same host as the Monitor, Monitor looks for a MonitorProxy on its own machine. If a Monito

Serving WebObjects20application’s .woa directory and execute WODefaultApp, which is located in NeXT_ROOT/NextLibrary/Executables.-debug ON|OFFSets whe

3To a large extent, WebObjects needs little attention once it is installed. However, there are certain basic administrative tasks that you’ll need to

Administrative Tasks21-d DocumentRootThe document root of the server, which can be different from the document root specified for a given web server. I

Serving WebObjects22essarily improve performance or allow the application to serve more requests at sustained high loads. For more information, see “I

Administrative Tasks23• The left side of the screen shows you how many WebObjects applications you have on the system and which ones currently have at

Serving WebObjects24more information about when the application died and how many times the application died. • In the Application Inspector, if the n

Administrative Tasks251. Start a command shell window (on NT use the Bourne Shell in the WebObjects program group).2. Change to the temporary director

Serving WebObjects26See the description of WOStats in the WOExtensions Reference for more information about what the page displays. Performance Testin

Administrative Tasks273. Start the application instance you just created. To do so, open a command-shell window and enter the command line as shown in

Serving WebObjects28shell window). It is possible to run several versions of WOPlayback at the same time to put more load on the server. If you want,

Administrative Tasks29The WebObjects Developer’s Guide offers some suggested coding practices to improve performance. • Enable component-definition cac

Serving WebObjects30the number of instances you intend to run on a given machine. The result is the amount of physical memory that should be installed

Serving WebObjects4Installation Guide is printed and included with the WebObjects CD-ROM or can be downloaded from NeXTanswers; it is not online).• Po

Administrative Tasks31If you want all applications to use the same settings, you can change the default shut-down time on Monitor’s Configuration Optio

Serving WebObjects32You can programmatically set up an application to shut down in addition to setting it using the Monitor. If the two settings confli

Administrative Tasks332. 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

Serving WebObjects34instances of MyApp run on host toga and two instances run on host tutu. If you were to set up a WebObjects.conf file by hand, you c

Administrative Tasks35Your application’s state-storage strategy affects load balancing. By default, applications store state in memory in the server.

Serving WebObjects36Installing and Configuring NSAPI AdaptorsIf you have a Netscape server, use one of the NSAPI adaptors. Which NSAPI adaptor to use,

Administrative Tasks374. At the end of obj.conf, add the following text, just as it appears here:<Object name="webobjects">Service fn=

Serving WebObjects382. Set up your site so that the proper URL for the ISAPI adaptor is submitted when users click buttons, images, or hyperlinks that

WebObjects HTTP Adaptors5load the adaptor; servers using CGI adaptors, on the other hand, spawn a new adaptor process for each request and kill the pr

Serving WebObjects6in the private configuration file; if you manually start HelloWorld and it’s already been started, the entry for HelloWorld in the fil

WebObjects HTTP Adaptors7executable, or if the application is compiled, it invokes the executable in the application wrapper itself. This invocation s

Serving WebObjects8Setting Up the Monitor ApplicationYou can perform many essential administrative tasks using a WebObjects application named Monitor.

Setting Up the Monitor Application9Which Copy of Monitor Should I Use?If you have multiple machines running WebObjects, you can administer them all fr

Serving WebObjects10Starting Up MonitorProxy As mentioned in the previous section, if you have a multiple machine configuration, you need to run Monito