session-replication

The session-replication element configures Servlet session replication
within a server cluster. This element may appear zero or one time within the cluster element, and zero or one time within the instance element.
For more information, see cluster, and instance.

Subelements

The session-replication element can contain the following
subelements:

Table 3–47 List of session-replication Subelements

Element

Occurrences

Description

enabled

0 or 1

Determines whether the session replication is enabled at runtime. The
default value is true.

port

0 or 1

Specifies the port on which the server will listen. The default port
number is 1099.

instance-id

0 or 1

(Only applicable at the instance level.) The value that uniquely identifies
the instance for use in cookies.

key

0 or 1

(Only applicable at the cluster level.) The shared secret which members
of the cluster use to authenticate to each other. The value of this subelement
should be in text format.

encrypted

0 or 1

(Only applicable at the cluster level.) Determines whether the session
data is encrypted prior to replication. The default value is false.

protocol

0 or 1

(Only applicable at the cluster level.) The protocol used for session
replication. The value can be http or jrmp.

getAttribute-triggers-replication

0 or 1

(Only applicable at the cluster level.) Determines whether a call to
the HttpSession.getAttribute method should cause a session
to be backed up. The default value is true.

replica-discovery-max-hops

0 or 1

(Only applicable at the cluster level.) The maximum number of instances
that should be contacted while attempting to find the backup of a session.
The value can be from 1 to 2147483647, or -1 for no limit.

startup-discovery-timeout

0 or 1

(Only applicable at the cluster level.) The maximum time (in seconds)
that an instance spends trying to contact its designated backup instance.
The value can be from 0.001 to 3600.

cookie-name

0 or 1

(Only applicable at the cluster level.) The name of the cookie that
tracks which instance owns a session.

cipher

0 or 1

(Only applicable at the cluster level.) The value of a JCE cipher. JCE
ciphers are specified using the form algorithm/mode/padding.
The value should be in text format. The default value is AES/CBC/PKCS5Padding.