availability-service

Configures the availability service. Enables high-availability
features, such as session state and stateful session bean state persistence. If
the Sun Java System high-availability database (HADB) is installed
and you have selected the enterprise profile, session state is persisted
to the HADB.

For availability to be enabled at a given level, it must be
enabled at all higher levels, as well. For example, to enable availability
at the application level, you must also enable it at the server instance
and container levels.

If the HADB is
installed and the enterprise profile is selected, availability can
also be enabled in the Java Message Service (attribute of jms-availability). The default is false (disabled). JMS availability is disabled if server instance
availability is disabled. JMS availability neither affects nor is
affected by any other availability levels.

Attributes

The following table describes attributes for the availability-service element.

Table 1–20 availability-service Attributes

Attribute

Default

Description

availability-enabled

true

(optional) If set to true, high-availability
features apply to all applications 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.

ha-agent-hosts

none

Specifies a comma-separated list of server host names or IP
addresses where management agents for the high availability store
are running. Applicable if HADB is installed and you have selected
the enterprise profile.

ha-agent-port

none

Specifies the port number where management agents for the high
availability store can be contacted. Applicable if HADB is installed
and you have selected the enterprise profile.

ha-agent-password

asadmin password

Specifies the password for access to management agents for the
high availability store. Applicable if HADB is installed and you have
selected the enterprise profile.

ha-store-name

cluster name

(optional) Specifies the HADB database name. Applicable if HADB
is installed and you have selected the enterprise profile.

auto-manage-ha-store

true

(optional) If true, the life cycle of the
highly available store is matched with the life cycle of the highly
available cluster. The store is started or stopped with the cluster.
It is removed when the cluster is deleted. If false,
the store life cycle must be manually managed by the administrator.
Applicable if HADB is installed and you have selected the enterprise
profile.

store-pool-name

jdbc/hastore

(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.

(optional) If true, periodic checking is
done to detect if the HADB has become available again after a failure.
If the health check succeeds, persistence to the HADB is resumed.
Applicable if HADB is installed and you have selected the enterprise
profile.

ha-store-healthcheck-interval-in-seconds

5

(optional) Specifies the interval at which the HADB's health
is checked. The checking begins only after a failure is detected.
Applicable if HADB is installed and you have selected the enterprise
profile.

Specifies the frequency of measurement of replication. It must
be a positive integer: 1 means every replication, 2 means once every
2 replications, 3 means once every 3 replications, and so on. Applicable
only if replication_measurement_enabled is set to true.

rolling-upgrade-backup-directory

instance-dir/rollingupgrade

Specifies
where the asadmin backup-session-store command
backs up active and replica sessions.