Installation guide

Chapter 6. Install proxy server components
Read this chapter to install the JBoss HTT P Connector, mod_cluster, on a JBoss Enterprise Web
Server proxy server.
6.1. Apache modules
Read this section for expanded definitions of the Apache proxy server modules discussed in Section 5.2,
“Components”. You specify these modules as part of Task: Install Proxy Server Components.
6.1.1. mod_manage r.so
The Cluster Manager module, mod_manager, receives and acknowledges messages from nodes,
including worker node registrations, worker node load data, and worker node application life-cycle
events.
LoadModule manager_module modules/mod_manager.so
You can also define the following related directives in the <VirtualHost> element:
Me mMa nagerFile
Defines the location for the files in which mod_manager stores configuration details.
mod_manager also uses this location to store generated keys for shared memory and lock files.
This must be an absolute path name. It is recommended that this path be on a local drive, not
an NFS share. T he default value is /logs/.
Ma xcontext
The maximum number of contexts JBoss mod_cluster will use. T he default value is 100.
Ma xnode
The maximum number of worker nodes JBoss mod_cluster will use. T he default value is 20.
Ma xhost
The maximum number of hosts (aliases) JBoss mod_cluster will use. This is also the maximum
number of load balancers. T he default value is 10.
Ma xsessionid
The maximum number of active session identifiers stored. A session is considered inactive
when no information is received from that session within five minutes. T he default value is 0,
which disables this logic.
Ma nagerBalancerName
The name of the load balancer to use when the worker node does not provide a load balancer
name. The default value is mycluster.
Persist Slots
When set to on, nodes, aliases and contexts are persisted in files. T he default value is off.
Che ckNonce
When set to on, session identifiers are checked to ensure that they are unique, and have not
occurred before. The default is on.
Warning
Setting this directive to off can leave your server vulnerable to replay attacks.
SetHa ndler
Defines a handler to display information about worker nodes in the cluster. T his is defined in
the Location element:
24 Chapter 6. Install proxy server components