Installation guide
Reference: workers.properties
Apache httpd Server worker nodes are Servlet containers that are mapped to the mod_jk load balancer.
The worker nodes are defined in HTTPD_DIST/conf/workers.properties. This file specifies where
the different Servlet containers are located, and how calls should be load-balanced across them.
The workers.properties file contains two sections:
Global Properties
This section contains directives that apply to all workers.
Worker Prope rties
This section contains directives that apply to each individual worker.
Each node is defined using the Worker Properties naming convention. The worker name can only
contain alphanumeric characters, limited to [a-z][A-Z ][0-9][_\-].
The structure of a Worker Property is worker.worker_name.directive.
worker
The constant prefix for all worker properties.
worker_name
The arbitrary name given to the worker. For example: node1, node_01, Node_1.
directive
The specific directive required.
The main directives required to configure worker nodes are described below.
Note
For the full list of worker.properties configuration directives, refer directly to the Apache
Tomcat Connector - Reference Guide
worker.propert ies Global Directives
worker.list
Specifies the list of worker names used by mod_jk. T he workers in this list are available to map
requests to.
Note
A single node configuration, which is not managed by a load balancer, must be set to
worker.list=[worker name].
workers.propert ies Mandatory Directives
type
Specifies the type of worker, which determines the directives applicable to the worker. The
default value is ajp13, which is the preferred worker type to select for communication between
the web server and Apache httpd Server.
Other values include ajp14, lb, status.
For detailed information about ajp13, refer to T he Apache T omcat Connector - AJP Protocol
Reference
workers.propert ies Connect ion Directives
host
The hostname or IP address of the worker. The worker node must support the ajp13 protocol
stack. T he default value is localhost.
80 Reference: workers.properties