Red Hat JBoss Web Server 2 HTTP Connectors Load Balancing Guide HTTP load balancing for JBoss Enterprise Application Platform and Red Hat JBoss Web Server 2.0.1 Edition 2 Last Updated: 2017-10-19 Red Hat JBoss Web Server 2 HTTP Connectors Load Balancing Guide HTTP load balancing for JBoss Enterprise Application Platform and Red Hat JBoss Web Server 2.0.1 Edition 2 Joshua Wulf Red Hat Engineering Content Services [email protected] Samuel Mendenhall Red Hat Global Support Services James Livingston Red Hat Global Support Services Jim Tyrell Red Hat JBoss Solutions Architect Laura Bailey Red Hat, Inc. Engineering Content Services [email protected] Misha Husnain Ali Red Hat Engineering Content Services [email protected] Mandar Joshi Red Hat Engineering Content Services [email protected] Legal Notice Copyright © 2011 Red Hat, Inc. This document is licensed by Red Hat under the Creative Commons Attribution-ShareAlike 3.0 Unported License. If you distribute this document, or a modified version of it, you must provide attribution to Red Hat, Inc. and provide a link to the original. If the document is modified, all Red Hat trademarks must be removed. Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law. Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries. Linux ® is the registered trademark of Linus Torvalds in the United States and other countries. Java ® is a registered trademark of Oracle and/or its affiliates. XFS ® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries. MySQL ® is a registered trademark of MySQL AB in the United States, the European Union and other countries. Node.js ® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project. The OpenStack ® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community. All other trademarks are the property of their respective owners. Abstract Read this guide to install and configure JBoss Enterprise Application Platform and Red Hat JBoss Web Server HTTP connectors: mod_jk, mod_cluster, ISAPI, and NSAPI. This guide also discusses clustering and load-balancing using these connectors. Table of Contents Table of Contents .P .R . E. .F . A. .C . E. .3 . 1. FILE NAME CONVENTIONS 3 .P .A . .R . T. .I . .A . P. .A . C. .H . E. .T . O. .M . .C . A. .T . C. .O . N. .N . .E .C . T. .O . R. .4 . .C .H . A. P. T. .E . R. 1. .. O. .V . E. .R . V. .I E. .W . .5 . .C .H . A. P. T. .E . R. 2. D. O. .W . N. L. O. .A . D. A. N. .D . .I N. .S . T. .A . L. L. .6 . .C .H . A. P. T. .E . R. 3. C. .O . N. F. I.G . U. .R . .E . L. .O . A. .D . .B . A. .L . A. .N . C. .I N. .G . .U . S. .I .N . G. A. .P . A. .C . H. .E . A. N. .D . .M . O. .D . ._ .J .K . .7 . 3.1. CONFIGURING WORKER NODES IN MOD_JK 9 3.2. CONFIGURING JBOSS ENTERPRISE APPLICATION PLATFORM TO WORK WITH MOD_JK 9 3.2.1. Configuring the Web Subsystem 9 3.2.1.1. Basic Configuration 10 3.2.1.2. Configuring Connectors 10 3.2.1.2.1. Configuring HTTP Connectors 11 3.2.1.2.2. Configuring HTTPS Connectors 11 3.2.1.2.3. Further Information About mod_jk 12 3.2.1.2.4. Configuring AJP Connectors 12 3.2.1.2.5. Configuring Native Connectors 13 3.2.1.3. Configuring Virtual Servers 14 3.2.1.4. Querying Connectors 14 3.3. CONFIGURING APACHE TOMCAT TO WORK WITH MOD_JK 15 .P .A . .R . T. .I .I .. J. B. .O . .S .S . .H . T. .T .P . .C . O. .N . N. E. C. .T . O. .R . .1 .6 . .C .H . A. P. T. .E . R. 4. .O . V. .E . R. .V . I.E . W. .1 .7 . 4.1. KEY FEATURES 17 4.2. COMPONENTS 17 4.3. LIMITATIONS 18 .C .H . A. P. T. .E . R. 5. P. .R . O. .X . .Y . .S .E . R. .V . E. .R . .C . O. .M . P. .O . N. .E . N. .T . S. 2. .0 . 5.1. APACHE MODULES 20 5.1.1. mod_manager.so 20 5.1.2. mod_proxy_cluster.so 22 5.1.3. mod_advertise.so 23 5.1.4. mod_proxy.so 24 5.1.5. mod_proxy_ajp.so 24 5.1.6. mod_slotmem.so 24 5.2. PROXY SERVER COMPONENTS INSTALLATION AND DEFAULT CONFIGURATION 25 .C .H . A. P. T. .E . R. 6. C. .O . N. F. I.G . U. R. .E . B. .A . .S .I .C . P. .R . O. .X . Y. S. .E . R. .V . E. .R . 2. .6 . 6.1. BASIC PROXY CONFIGURATION OVERVIEW 26 6.2. CONFIGURE A LOAD-BALANCING PROXY USING THE HTTP CONNECTOR 26 .C .H . A. P. T. .E . R. 7. .. I. N. .S .T . A. .L . L. .N . O. .D . .E . W. I.T . H. B. .A . S. .I C. C. .O . N. .F . I.G . U. .R . A. .T . I.O . .N . 2. .8 . 7.1. WORKER NODE REQUIREMENTS 28 7.2. INSTALL AND CONFIGURE A WORKER NODE 28 7.2.1. Configure a JBoss Enterprise Application Server 6 Worker Node 28 7.2.2. Configure a Tomcat Worker Node 31 .C .H . A. P. T. .E . R. 8. .A . D. .V . A. .N . C. .E . D. C. .O . N. .F .I .G . U. .R . A. .T . I.O . N. 3. .3 . ..