Sun OpenSSO Enterprise Policy Agent 3.0 User's Guide for Web Agents

Load Balancer in Front of the Web Agent

In many cases, when a load balancer is deployed in front of the web agent only the property labeled FQDN Virtual Host Map (Tab: Global, Name: com.sun.identity.agents.config.fqdn.mapping) is required.

Assign the following value to the FQDN Virtual Host Map property:


where LB-hostname represents the name of the machine on which the load balancer is located.

However, if SSL-termination or a proxy server is used in the deployment, all the following web agent properties should be set in addition to the preceding property:

This example illustrates how properties can be set to enable load balancing when the protocol, hostname, and port number of the load balancer differ from that of the web agent. However, if the load balancer and the web agent share one of these characteristics, such as the protocol or hostname, then the respective property would not be enabled.

Property (name or label) 


Override Request URL Protocol 


Override Request URL Host 


Override Request URL Port 


Override Notification URL