<Listener className="org.jboss.modcluster.catalina.ModClusterListener"/>
Plugin Implementation
The following operations, configuration settings, and metrics are supported by RHQ for JBoss 4.2.x mod_cluster module:
Catalina Service
|
Operation |
Description |
|
reset |
Move the node out of an error state |
|
refresh |
Refresh node configuration |
|
enable |
Enable all webapps for all virtual hosts of the managed server. |
|
disable |
Disable all webapps for all virtual hosts of the managed server. |
|
stop |
Gracefully stops all webapps for all virtual hosts of the managed server. |
|
addProxy |
Add a proxy |
|
removeProxy |
Remove a proxy |
|
Property Name |
Description |
|
workerTimeout |
Timeout to wait for an available worker (default is no wait) |
|
stickySession |
Enables sticky sessions |
|
stickySessionRemove |
Remove session when the request cannot be routed to the right node |
|
smax |
Maximum time on seconds for idle connections above smax |
|
proxyList |
Comma delimited list of proxy servers |
|
maxAttempts |
Maximum number of attempts to send the request to the backend server |
|
advertiseSecurityKey |
Security key for discovery |
|
stickySessionForce |
Return an error when the request cannot be routed to the right node |
|
balancer |
Name of the balancer |
|
flushPackets |
Allows controlling flushing of packets |
|
socketTimeout |
Connection timeout for communication with the proxy |
|
containerName |
View MBean Object name of the container |
|
advertisePort |
Multicast port for discovery |
|
advertiseGroupAddress |
Multicast address for discovery |
|
flushWait |
Time in ms to wait before flushing packets |
|
ping |
Time in s to wait for a pong answer to a ping |
|
Metric Name |
Description |
|
proxyConfiguration |
Get the mod_cluster configuration, per proxy |
|
proxyInfo |
Get information about what is registered with each mod_cluster, per proxy |
|
modelerType |
Type of the modeled resource. Can be set only once |
|
className |
Fully qualified class name of the managed object |
Webapp Context Service
|
Operation |
Description |
|
enableContext |
Enable a single webapp |
|
disableContext |
Disable a single webapp |
|
stopContext |
Gracefully stops a single webapp |
Limitations
-
Load metrics are not exposed by the mod_cluster module and they are not available in RHQ.
-
advertise mode cannot be configured through RHQ. Please see the installation section for instructions on how to enable advertise.
Installation Instructions for mod_cluster 1.1.2 with JBoss 4.2.x
-
Download mod_cluster 1.1.2 (java bundles)
-
Unzip mod_cluster archive
-
Copy /JBossWeb-Tomcat/lib/mod_cluster.jar from the downloaded bundle into $JBoss_AS42_HOME/server/all/deploy/jboss_web.deployer/
-
Add the following tag as a child of <Server> tag in
$JBoss_AS42_HOME/server/all/deploy/jboss_web.deployer/server.xml
To enable advertise mode add the following tag instead
<Listener className="org.jboss.modcluster.catalina.ModClusterListener" advertise="true"/>
Screenshots
