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