Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Chapter 10. Load Balancing Demonstration

The JBoss HTTP Connector includes a load balancing demonstration to show how different server-side scenarios affect the client request routing performed by the load balancing proxy server. The required configuration is located in the jboss-eap-5.1/mod_cluster/demo directory.
The application consists of two primary components:
/server/load-demo.war
A WAR file to be deployed in JBoss Enterprise Application Platform or JBoss Enterprise Web Server. This WAR includes a number of servlets.
/client/lib/mod-cluster-demo.jar
A web application that lets users launch a pool of threads, which send requests through the load balancer to load-demo.war's primary servlet. The application displays information about which servers are handling the requests. It can also send separate requests to load-demo.war's load generation servlets, allowing the user to see how certain load conditions affect request load balancing.
The demo can be used to demonstrate how different worker-side scenarios impact the routing decisions of the proxy server.

Note

The demo does not show the maximum load a cluster configuration can handle.

10.1. Set up the Demonstration
Copy link

The following procedure summarizes how set up and start the demonstration. These steps will then be explained in further detail. Once the demo is running, refer to Section 10.3, “Interact with the Demonstration”.

Task: Start the Demo

Complete this task to set up the base requirements of the demonstration.

Prerequisites

  1. Start the Proxy Server

    Navigate to HTTPD_DIST/sbin and start the proxy server. 
    [sbin]$ apachectl start

  2. Start the Worker Node

    In a terminal, execute the following command:
    • For JBoss Enterprise Web Server: 
      [home]$ ./JBOSS_EWS_DIST/tomcat6/bin/startup.sh
    • For JBoss Enterprise Application Platform: 
      [home]$ ./JBOSS_EAP_DIST/bin/run.sh

  3. Specify the Catalina Service Name

    AWAITING CONFIRMATON ON JBPAPP-6550

  4. Deploy Demo Web Archive to Worker Node

    Copy load-demo.war from JBOSS-EAP_DIST/mod_cluster/demo/server into one of the following directories:
    • For JBoss Enterprise Web Server:
      JBOSS_EWS_DIST/tomcat6/webapps
    • For JBoss Enterprise Application Platform:
      JBOSS_EAP_DIST/jboss-as/server/PROFILE/deploy

  5. Start the Demonstration

    Navigate to JBOSS_EAP_DIST/mod_cluster/demo/client/, and start the demonstration. 
    [client]$ ./run-demo.sh
    Result

    The demonstration starts, and the Load Balancing Demonstration window opens. Proceed to Task: Configure Client Control Tab Fields

Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2026 Red HatBack to top