module Netcgi_ajp:sig
..end
See the Setup section at the end of this file to know
how to configure your web server.
val arg_parse : (Arg.key * Arg.spec * Arg.doc) list ->
Arg.anon_fun -> Arg.usage_msg -> (string * string) list
arg_parse speclist anon_fun usage_msg
parses the command line
and return an associative list describing the content of the
property file (see Netcgi_ajp.props_of_file
). This function
allows to fakes the "java" command (JVM startup):
-classpath <path>
is ignored;speclist
.Failure
and prints a usage message if the property file
cannot be read.val props_of_file : string -> (string * string) list
props_of_file fname
parses the property file fname
and
returns it as an associative list. The following properties are
used:
Invalid_argument
if the file does not exist or is not readable.val run : ?props:(string * string) list ->
?config:Netcgi.config ->
?script_name:string ->
?allow:(Unix.sockaddr -> bool) ->
?output_type:Netcgi.output_type ->
?arg_store:Netcgi.arg_store ->
?exn_handler:Netcgi.exn_handler ->
?socket:Unix.file_descr ->
?sockaddr:Unix.sockaddr -> ?port:int -> (Netcgi.cgi -> unit) -> unit
run f
executes f cgi
for each AJP request.config
: Default: Netcgi.default_config
allow
: Tells whether a connection from the socket is allowed.
Default: allow from all.output_type
: Default: `Direct ""
arg_store
: Default: `Automatic
for all arguments.exn_handler
: See Netcgi.exn_handler
. Default: delegate
all exceptions to the default handler.socket
: is a listening socket to use. Overrides sockaddr
and port
sockaddr
: The sockaddress (overrides port
)port
: The port used by the web server to send the requests
(Default: 8009).val handle_request : ?script_name:string ->
Netcgi.config ->
Netcgi.output_type ->
Netcgi.arg_store ->
Netcgi.exn_handler ->
(Netcgi.cgi -> unit) ->
log:(string -> unit) option -> Unix.file_descr -> Netcgi.connection_directive
handle_request config output_type arg_store eh f ~log fd
: This
is a lower-level interface that processes exactly one request
arriving on the existing connection fd
.
log
is the error logger function or None
, in which case
errors are passed through to the FCGI client.
The other arguments are just like for run
.
The return value indicates whether the connection can be kept
open or must be closed.
val handle_connection : Netcgi.config ->
Netcgi.output_type ->
Netcgi.arg_store ->
Netcgi.exn_handler ->
(Netcgi.cgi -> unit) -> ?script_name:string -> Unix.file_descr -> unit
handle_connection config output_type arg_store eh f ?script_name fd
:
This is a lower-level interface that processes
exactly one connection fd
. The descriptor is closed (even on
error).
The other arguments are just like for run
.
You need to use mod_jk to have support for AJP/1.3. To install it, please see Working with mod_jk.
In httpd.conf or in a file, say mod_jk.conf, in /etc/apache2/conf.d/ (or /etc/apache2/conf.d/ for Apache 1.x), add the following:
# Shared memory file name (Unix only). The parent dir must exist. JkShmFile /var/tmp/jk-runtime-status LoadModule jk_module mod_jk.so # Declare the module for <IfModule> (remove this line on Apache 2.x) AddModule mod_jk.c <IfModule mod_jk.c> # Configure mod_jk # Apache 1.x #JkWorkersFile /etc/libapache-mod-jk/workers.properties #JkLogFile /var/log/apache/mod_jk.log # Apache 2.x JkWorkersFile /etc/libapache2-mod-jk/workers.properties JkLogFile /var/log/apache2/mod_jk.log JkLogLevel info # JkMount [URL prefix] [Worker name] JkMount /*.jsp ajp13_worker JkMount /servlet/* ajp13_worker </IfModule>
Please go to this configuration page. Mail us specific instructions or tips for other web servers so we can include them here.
Here is an example of workers.properties:
# Comma separated list of worker names: worker.list=ajp13_worker # Set properties for ajp13_worker worker.ajp13_worker.type=ajp13 worker.ajp13_worker.host=localhost worker.ajp13_worker.port=8009 worker.ajp13_worker.cachesize=1