Jump to: navigation, search

Configuring Apache Load Balancer

The following is an example of how to configure Apache load balancer that can be positioned in front of GMS nodes for API requests distribution. For configuration of other load balancing solutions, please refer to their documentation.

You cannot change the /genesys path used for the Genesys Mobile Services applications. The base URL must remain /genesys.

See also the Configuration Sample Chat API v2 CometD page for some load-balancer/proxy configuration examples that show how to make a load-balancer proxy work with GMS WebSockets.

Configuration of mod_proxy_balancer

Install Apache 2.2 or higher, starting from this version mod_proxy is able to use the extension mod_proxy_balancer. Make sure the following modules are present in your Apache "modules\" folder, upload them in case they are absent:

  • mod_proxy.so
  • mod_proxy_balancer.so

Add the following strings to your Apache configuration "httpd.conf" file in order to load the modules:

  • LoadModule proxy_module modules/mod_proxy.so
  • LoadModule proxy_balancer_module modules/mod_proxy_balancer.so
  • LoadModule proxy_http_module modules/mod_proxy_http.so

Basically you need to add node based configuration, for this add the following to the httpd.conf file:

ProxyPass / balancer://my_cluster/ stickysession=JSESSIONID nofailover=On

<Proxy balancer://my_cluster>
   BalancerMember http://yourjetty1:8080 route=jetty1
   BalancerMember http://yourjetty2:8080 route=jetty2

Proxy balancer:// - defines the nodes (workers) in the cluster. Each member may be a http:// or ajp:// URL or another balancer:// URL for cascaded load balancing configuration. If the worker name is not set for the Jetty servers, then session affinity (sticky sessions) will not work. The JSESSIONID cookie must have the format <sessionID>.<worker name>, in which worker name has the same value as the route specified in the BalancerMember above (in this case "jetty1" and "jetty2").

As an example, add the following to the start.ini file to set the worker name in case you need session affinity (sticky sessions):


Load Balancer Management Page

Apache provides balancer manager support so that the status of balancer can be viewed on a web page. The following configuration enables this UI at /balancer URL:

<Location /balancer>
SetHandler balancer-manager

 Order Deny,Allow
 Deny from all
 Allow from all
This page was last edited on April 25, 2022, at 09:43.
Comments or questions about this documentation? Contact us for support!