JBoss.orgCommunity Documentation

Chapter 7. AS7 modcluster subsystem Configuration

7.1. ModCluster Subsystem in JBoss AS7
7.2. ModCluster Subsystem minimal configuration
7.3. ModCluster Subsystem configuration
7.3.1. mod-cluster-config Attributes
7.3.2. simple-load-provider Attributes
7.3.3. dynamic-load-provider Attributes
7.3.4. load-metric Configuration
7.3.5. custom-load-metric Configuration
7.3.6. load-metric Configuration with the jboss admin console

The mod_cluster integration is done via the modcluster subsystem. In AS7 only 1.1.x and later is supported.

The minimal configuration is having the modcluster schemaLocation in the schemaLocation list:

urn:jboss:domain:modcluster:1.0 jboss-mod-cluster.xsd

and the extension module in the extensions list:

<extension module="org.jboss.as.modcluster"/>

and subsystem declaration like:

<subsystem xmlns="urn:jboss:domain:modcluster:1.0"/>

With that configuration modcluster will listen for advertise on 224.0.1.105:23364 use the simple-load-provider with a load factor of 1.

The attributs correspond to the properties

Proxy Discovery Configuration

AttributePropertyDefault
proxy-listproxyListNone
proxy-urlproxyURLNone
advertiseadvertisetrue
advertise-security-keyadvertiseSecurityKeyNone
excluded-contextsexcludedContextsNone
auto-enable-contextsautoEnableContextstrue
stop-context-timeoutstopContextTimeout10 seconds (in seconds)
socket-timeoutnodeTimeout20 seconds (in milli seconds)

Proxy Configuration

AttributePropertyDefault
sticky-sessionstickySessiontrue
sticky-session-removestickySessionRemovefalse
sticky-session-forcestickySessionForcetrue
node-timeoutworkerTimeout-1
max-attemptsmaxAttempts1
flush-packetsflushPacketsfalse
flush-waitflushWait-1
pingping10
smaxsmax-1 it uses default value
ttlttl-1 it uses default value
domainloadBalancingGroupNone
load-balancing-grouploadBalancingGroupNone

SSL Configuration

SSL configuration part needs to be added here too

The load-metric are the "classes" collecting information to allow computation of the load factor sent to httpd

AttributePropertyDefault
typeA Server-Side Load MetricsMandatory
weightweight9
capacitycapacity512
typeCorresponding Server-Side Load Metric
cpuAverageSystemLoadMetric
memSystemMemoryUsageLoadMetric
heapHeapMemoryUsageLoadMetric
sessionsActiveSessionsLoadMetric
requestsRequestCountLoadMetric
send-trafficSendTrafficLoadMetric
receive-trafficReceiveTrafficLoadMetric
busynessBusyConnectorsLoadMetric
connection-poolConnectionPoolUsageLoadMetric