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:

valid|LB-hostname

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:

• Override Request URL Protocol (Tab: Advanced, Name: com.sun.identity.agents.config.override.protocol)

• Override Request URL Host (Tab: Advanced, Name: com.sun.identity.agents.config.override.host)

• Override Request URL Port (Tab: Advanced, Name: com.sun.identity.agents.config.override.port)

• Override Notification URL (Tab: Advanced, Name: com.sun.identity.agents.config.agenturi.prefix)

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.