Installation guide

Chapter 8. Install node with basic configuration
Read this chapter to install the JBoss HTT P Connector on a worker node, and implement basic
configuration for the node to begin immediate operation.
8.1. Worker node requirements
Supported Worker Node types
JBoss Enterprise Platform 5 JBoss Web component
JBoss Enterprise Web Server T omcat service
Note
JBoss Enterprise Platform worker nodes support all JBoss HT TP Connector functionality. JBoss
Enterprise Web Server T omcat worker nodes support a subset of JBoss HTT P Connector
functionality.
JBoss HTT P Connector Enterprise Web Server Node Limitations
Non-clustered mode only.
Only one load metric can be used at a time when calculating the load balance factor.
8.2. Install and configure a worker node
This section contains a number of tasks. Follow the appropriate task to install and configure a worker
node on JBoss Enterprise Application Platform, or JBoss Enterprise Web Server.
Character Limitations on Worker Node
Make sure your configuration definition meets the following character limits:
Maximum JVMRoute string length: 80 character (JVMRoute in the <Engine> element)
Maximum hostname length for a node: 64 characters (hostname address in the <Connector>
element)
Maximum port length for a node: 7 characters (8009 is 4 characters, the port property in the
<Connector> element)
Maximum scheme length for a node: 6 characters (possible values are http, https, ajp, the
protocol of the connector)
Task: Insta ll and Configure a JBoss Enterprise Applica t ion Plat form Worker Node
Follow this procedure to install JBoss HT T P Connector on a JBoss Enterprise Application Platform
instance and configure it for non-clustered operation.
Prerequisit es
Install a supported JBoss Enterprise Application Platform.
Understand the Proxy Configuration parameters discussed in Appendix B, Reference: Java
properties
1. Deploy the worker node service
Copy mod-cluster.sar from the JBOSS_EAP_DIST/mod_cluster directory to jboss-
as/server/PROFILE/deploy.
2. Add a Listener t o JBoss Web
Add the following Listener element beneath the other Listeners in JBOSS_EAP_DIST/jboss-
as/server/PROFILE/deploy/jbossweb.sar/server.xml:
<Listener
className="org.jboss.web.tomcat.service.deployers.MicrocontainerIntegration
LifecycleListener" delegateBeanName="ModClusterService"/>
3. Configure t he service de pendency
Add the following depends element beneath the other depends elements in
JBOSS_EAP_DIST/jboss-as/server/PROFILE/deploy/jbossweb.sar/META-INF/jboss-
beans.xml:
<depends>ModClusterService</depends>
30 Chapter 8. Install node with basic configuration