Config options


Property name
Default
Description
logger.file
Log jk messages to a file.
Name: 'logger'
level
INFO
Log level. Supported: ERROR, INFO, DEBUG
file
$(server.root)/logs/jk2.log Log file.
XXX you may be able to change this at runtime, to implement rolling
logger.apache2

level
INFO
see logger.file
channel.socket
A communication transport to a remote Engine
Magic: The local part of the name will be the Engine name, to use when defining the uri mappings. For example channel.socket.local_9009 will automatically define an engine named local_9009, and if no other setting is set ajp13/ajp13 will be used for communication.
Magic:  If no channel is defined in the config, a default channel will be constructed with port=8009, engine=DEFAULT, worker=ajp13 - named 'channel.socket.DEFAULT
port
8009
Port where tomcat is listening
host
localhost
Remote host
protocol
ajp13
the protocol to be used to forward the requests. No other value is supported at this moment.
api
ajp13
API to be used when forwarding the requests. No other value is supported at this moment, ajp14 will be used to indicate that the Engine supports additional API methods like autoconfig
secretkey
NULL
Magic: the secret key will be set automatically on the associated worker
lbfactor
1
Load balancing factor to use. At this moment, it'll be set on the worker, but in future it
should be possible to use lb on a channel level.
worker.ajp13

The forwarding worker using the ajp13 RPC protocol. It supports the basic ajp13 API and may support additional functions/APIs in future like ajp14 API
secretkey
NULL
XXX deprecated - set it on channel ( socket needs it, jni doesn't, with unix we can use smarter things ).
Special attribute to be sent with the first request, used to authenticate. Supported by Tomcat3.3 and tomcat4.x if the authentication is configured, leave it NULL for tomcat3.2
lbfactor
1
XXX deprecated - set it on channel.
Load balancing factor to use when



Example

logger.level=DEBUG
# That's created by default if no other channel is defined
channel.socket.DEFAULT.port=8009
channel.socket.local_9009.port=9009

# that defines automatically a worker named
# 'tomcat1' and an 'engine' named tomcat1
channel.socket.tomcat1.host=host1.my.com
channel.socket.tomcat1.lbfactor=0.5

[uri:/examples/*]
# Automatically define the lb worker and sets balanced_workers
# for this particular uri.
engine=DEFAULT,tomcat1

[uri:/examples2/*]
# the /examples2 is only available on tomcat2
engine=tomcat1

Alternatives

logger.level=DEBUG

[channel.socket:tomcat1]
host=host1.foo.com
port=8009
lbfactor=0.5

[channel.socket:DEFAULT]
# no property here, but the channel will be constructed
# with the default properties