Configuring Web Container Sessions

This section describes the HTTP session settings in the Web container. HTTP sessions are unique web sessions that have their state data written to a persistent store.

• Configuring Session Timeout Value

• Configuring Manager Properties

• Configuring Store Properties

Configuring Session Timeout Value

Use the Administration Console to set the HTTP session timeout value. The session timeout value represents the duration for which an HTTP session is valid.

In the Administration Console, go to Configuration > Web Container > Session Properties. In the Session Timeout field, enter the number of seconds that a session is valid.

For detailed instructions on setting the session timeout value, Click Help in the Administration Console.

Configuring Manager Properties

The session manager provides the means to configure how sessions are created and destroyed, where session state is stored, and the maximum number of sessions.

To change the session manager settings in the Administration Console, go to Configuration > Web Container > Manager Properties.

• Select the instance to configure:

  To configure a particular instance, select the instance’s config node. For example, the default instance, server, select the server-config node.

  To configure the default settings for all instances, select the default-config node.

In the Manager Properties tab, set the following properties:

• Reap Interval value. The Reap Interval field is the number of seconds before the inactive session data is deleted from the store.

• Max Sessions value. The Max Sessions field is the maximum number of sessions allowed.

• Set the Session Filename value. The Session Filename field is the file that contains the session data.

• Session ID Generator Classname value.

  The Session ID Generator Classname field allows you to specify a custom class for generating unique session IDs. Only one session ID generator class per server instance is permitted, and all instances in a cluster must use the same session ID generator to prevent session key collision.

  Custom session ID generator classes must implement the com.sun.enterprise.util.uuid.UuidGenerator interface:

  package com.sun.enterprise.util.uuid;
  
  public interface UuidGenerator {
  
      public String generateUuid();
      public String generateUuid(Object obj);  //obj is the session object
  }

  The class must be in the Application Server classpath.

For detailed instructions on setting the manager properties, Click Help in the Administration Console.

Configuring Store Properties

To specify where the session store data will be saved, in the Administration Console, go to Configuration > Web Container > Store Properties.

• Select the instance to configure:

  To configure a particular instance, select the instance’s config node. For example, the default instance, server, select the server-config node.

  To configure the default settings for all instances, select the default-config node.

• Set the Reap Interval field

  The Reap Interval field is the number of seconds before the inactive session data is deleted from the store.

• Specify the directory where session data will be stored.

For detailed instructions on setting the session store properties, Click Help in the Administration Console.