Sun GlassFish Enterprise Server 2.1 Administration Reference

lb-config

Defines a load balancer configuration, which can be referenced by a physical load-balancer.


Note –

Some topics in the documentation pertain to features that are available only in domains that are configured to support clusters. Examples of domains that support clusters are domains that are created with the cluster profile or the enterprise profile. For information about profiles, see Usage Profiles in Sun GlassFish Enterprise Server 2.1 Administration Guide.


Superelements

lb-configs

Subelements

The following table describes subelements for the lb-config element.

Table 1–101 lb-config Subelements

Element 

Required 

Description 

cluster-ref

zero or more; zero if a server-ref is defined

References a cluster. This element contains some attributes related to load balancing. 

server-ref

zero or more; zero if a cluster-ref is defined

References a server instance that does not belong to a cluster. The referenced server element contains some attributes related to load balancing.

property

zero or more 

Specifies a property or a variable. 

Attributes

The following table describes attributes for the lb-config element.

Table 1–102 lb-config Attributes

Attribute 

Default 

Description 

name

none 

Specifies the name of the load balancer configuration. 

response-timeout-in-seconds

60

(optional) Specifies the time within which a server must return a response or it is considered unhealthy. 

https-routing

false

(optional) If true, HTTPS requests to the load balancer result in HTTPS requests to the server. If false, HTTPS requests to the load balancer result in HTTP requests to the server.

reload-poll-interval-in-seconds

60

(optional) Specifies the interval between checks for changes to the load balancer configuration file (loadbalancer.xml). When changes are detected, the file is reloaded. A value of zero disables reloading.

monitoring-enabled

false

(optional) If true, enables monitoring of load balancing.