The JBoss application server may need to be configured to match the settings of the Apache web server and mod_proxy load balancer, depending on the settings you chose in those components. To configure JBoss, follow these steps:
JBoss can be configured to communicate with the front-end web server via the mod_proxy load balancer using HTTP or HTTPS protocols. This section provides instructions for configuring JBoss to communicate via mod_proxy using HTTP; for instructions on how to configure JBoss to communicate via mod_proxy using HTTPS, please consult the JBoss and mod_proxy documentation.
To configure JBoss to communicate via mod_proxy using HTTP, follow these steps:
Edit the JBoss configuration (see JBoss Domain Mode and Configuration).
Find the undertow element, and find its server child element. Under the server element, you will see two elements defining "listeners". Edit the http-listener and set proxy-address-forwarding to true:
<subsystem xmlns="urn:jboss:domain:undertow:1.2" instance-id="${jboss.server.name}">
<buffer-cache name="default"/>
<server name="default-server">
<http-listener name="default" socket-binding="http"
max-post-size="0" max-parameters="5000" proxy-address-forwarding="true"/>JBoss web services must be configured to match the configuration of the front-end web server. To configure JBoss web services, follow these steps:
Edit the JBoss configuration (see JBoss Domain Mode and Configuration).
Find the webservices subsystem
element:
<subsystem xmlns="urn:jboss:domain:webservices:1.2">
Configure the following elements: wsdl-host, wsdl-port, and wsdl-secure-port. The values of these elements must be configured to match the hostname
and HTTP and/or HTTPS port of the front-end web server. These values
control how URLs are written in the WSDL contracts of web services
that are provided by EKM.
<wsdl-host>jbossws.undefined.host</wsdl-host> <wsdl-port>80</wsdl-port> <wsdl-secure-port>443</wsdl-secure-port>
wsdl-host:Set the value of this element to the hostname or IP
address of the front-end web server. The special value jbossws.undefined.host is set by default, which substitutes
the hostname from the request when a web service WSDL is accessed.
It is usually not necessary to change this value. Alternatively, you
may specify the hostname or IP address of the front-end web server
here.
Examples: jbossws.undefined.host, ekm.yourdomain.com, 192.168.1.2
wsdl-port:Set the value of this element to the HTTP port of
the front-end web server. Examples: 80, 8080
wsdl-secure-port:Set the value of this element to the HTTPS port of
the front-end web server. Examples: 443, 8443
Undertow is the name of the web server subsystem within JBoss. This subsystem listens for incoming connections on both AJP and HTTP protocols by default. Depending on your desired configuration, you may want to disable one of these listeners if you are not using it. For example, if mod_proxy will be using AJP, you may want to disable the HTTP listener, or vice-versa.
To disable a listener, follow these steps:
Edit the JBoss configuration (see JBoss Domain Mode and Configuration).
Find the undertow element, and
find its server child element. Under the server element, you will see two elements defining “listeners”: http-listener and ajp-listener:
<subsystem xmlns="urn:jboss:domain:undertow:1.2" instance-id="${jboss.server.name}">
<buffer-cache name="default"/>
<server name="default-server">
<http-listener name="default" socket-binding="http" max-post-size="0" max-parameters="5000"/>
<ajp-listener name="ajp" socket-binding="ajp" max-post-size="0" max-parameters="5000"/>To disable a listener, set the enabled attribute on the listener element to false. For example, to disable the AJP listener:
<subsystem xmlns="urn:jboss:domain:undertow:1.2" instance-id="${jboss.server.name}">
<buffer-cache name="default"/>
<server name="default-server">
<http-listener name="default" socket-binding="http" max-post-size="0" max-parameters="5000"/>
<ajp-listener name="ajp" socket-binding="ajp" max-post-size="0" max-parameters="5000"
enabled="false"/>To enable a listener, reverse these steps.