Sun GlassFish Enterprise Server v2.1.1 Administration Reference

ejb-container-availability

Enables availability in the EJB container, including stateful session bean (SFSB) state persistence. If HADB is installed and you have selected the enterprise profile, session state is persisted to the HADB. For additional replicated session persistence properties you can set, see availability-service.

Superelements

availability-service

Subelements

The following table describes subelements for the ejb-container-availability element.

Table 1–51 ejb-container-availability Subelements

Element 

Required 

Description 

property

zero or more 

Specifies a property or a variable. 

Attributes

The following table describes attributes for the ejb-container-availability element.

Table 1–52 ejb-container-availability Attributes

Attribute 

Default 

Description 

availability-enabled

true

(optional) If set to true, and if availability is enabled for the server instance (see availability-service), high-availability features apply to all SFSBs deployed to the server instance that do not have availability disabled. All instances in a cluster should have the same availability value to ensure consistent behavior.

sfsb-ha-persistence-type

ha

(optional) Specifies the session persistence and passivation mechanism for SFSBs that have availability enabled. Allowed values are file (the file system) and replicated (other servers). If HADB is installed and you have selected the enterprise profile, you can also specify ha. For production environments that require session persistence, use ha.

If set to file, the ejb-container element’s session-store attribute specifies the file system location where the passivated session bean state is stored. Checkpointing to the file system is useful for internal testing but is not supported for production environments.

sfsb-persistence-type

file

(optional) Specifies the passivation mechanism for SFSBs that do not have availability enabled. Allowed values are file and replicated. If HADB is installed and you have selected the enterprise profile, you can also specify ha.

sfsb-store-pool-name

availability-service store-pool-name attribute value

(optional) Specifies the jndi-name of the jdbc-resource used for connections to the HADB for session persistence. Applicable if HADB is installed and you have selected the enterprise profile.

For more information about setting up a connection pool and JDBC resource for the HADB, see the description of the configure-ha-cluster command in the Sun GlassFish Enterprise Server v2.1.1 Reference Manual.