Apple WebObjects 3.5: Serving - Manual (Page 20)

Administrative Tasks
21
-d DocumentRoot
The document root of the server, which can be different from the document
root specified for a given web server. If you use this option, you must also
specify the ApplicationName option. If you don’t specify a document root, it
is taken from the configuration file NeXT_ROOT
/NextLibrary/WOAdaptors/Configura-
tion/WebServerConfig.plist .
-a AdaptorClass
The class of an adaptor that the application will use to communicate with
the server. You can specify multiple adaptors, as long as they are of different
types. (For example, you could have a separate adaptor with its own port for
communicating directly with Java applets on the browser.) If you specify
multiple HTTP adaptors, only the last one specified will be made the active
one.
The subsequent three arguments belong to the adaptor specified in
AdaptorClass; the first two of these are used in load balancing: You cannot
specify adaptor arguments unless you specify an adaptor class.
-n InstanceNumber
A positive integer that uniquely identifies an application instance with
which the adaptor will communicate. If you do not specify an instance num-
ber, the adaptor specified in AdaptorClass creates one using random number
generation. If a URL does not specify the instance number, the application
is presumed to run on the server machine as a single instance application, as
if it had been autostarted. If you specify AdaptorClass for the purpose of load
balancing, you must specify an instance number.
Note that if you intend to use Monitor to administer the application, you
must use the
-n option. Monitor always assigns instances to the applications
it knows about. If you start up an application without the -n option, its
instance number is nil , and Monitor is not able to connect to it.
-p PortNumber
Specifies the socket port used to communicate with an application instance.
Port numbers must be over 1024 since numbers between 0 and 1024 are
reserved. If you specify AdaptorClass for the purpose of load balancing, you
must specify a port number.
-q ListenQueueDepth
Specifies the queue depth on a TCP/IP socket at the entrance of the appli-
cation. The default listen queue depth is 4, meaning that while the applica-
tion process is handling a request, up to four other requests can be in the
socket buffer before the socket starts refusing them. If the application is
expected to experience “spikes” in its processing load, it might be a good
idea to increase the listen queue depth. Increasing this default does not nec-