Sun Java System Web Server 7.0 Update 3 Administrator's Configuration File Reference

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.

async

0 or 1 

(Only applicable at the cluster level.) Determines whether session replication is asynchronous from HTTP request/response processing. The default value is false.

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.