Session

Web Application WAR file -> General tabbed pane -> Sun-specific Settings button -> Sun-specific Settings dialog box -> Select Session from the View drop-down list

In the Sun-specific Settings - Session dialog box, you can change some of the WAR file's session properties:

Select the Persistence type session manager to use.

To add a session property parameter:
  1. Click Add.
  2. Select the name of the session property as it appears in the code of your web component in the Name column.
  3. Enter a value for the parameter in the Value column.
To delete a session property parameter:
  1. Select the row containing the session parameter.
  2. Click Delete.

Define the Session Properties

In the Session Properties section of the screen, you can add or delete the predefined properties for the session.

The Session Manager Properties specifies the default session manager.

The following table lists the session manager parameters. The first column lists the name of the property and the second column provides a description of the property and the default value for the property wherever applicable.
Name Value
className The Java class name of the implementation to use. One of the possible values for this parameter is com.iplanet.ias.servlet.session.StandardManager.
reapIntervalSeconds The number of seconds between checks for expired sessions.
maxSessions The maximum number of active sessions, or -1 for no limit.
sessionFilename The absolute or relative pathname of the file in which the session state is preserved between application restarts, if preserving the state is possible. A relative pathname is relative to the temporary directory for this web module.
The Session Store Properties specifies how the sessions are stored in the Application Server. The following table lists the session store parameters. The first column lists the session store parameters, the second column provides a description of the parameter and the default value for the parameter wherever applicable.
Name Value
className The Java class name for the type of storage. Set this parameter only if the Persistence Type property is custom. One of the possible values for this parameter is com.iplanet.ias.servlet.session.JDBCStore.
reapIntervalSeconds The number of seconds between checks for expired sessions for those sessions that are currently swapped out.
directory The absolute or relative pathname of the directory into which individual session files are written. A relative path is relative to the temporary work directory for this web module.
jndiDatasourceName The name of the JDBC datasource or connection pool representing the JDBC session store. (only applicable to the JDBCStore session manager).
connectionTimeoutSeconds The time, in seconds, to wait before timing out a JDBC connection. (only applicable to the JDBCStore session manager).
sessionDataCol The name of the database column, contained in the specified session table, that contains the serialized form of all session attributes for a swapped out session. The column type must accept a binary object (typically called a BLOB). (only applicable to the JDBCStore session manager)
sessionIdCol The name of the database column, contained in the specified session table, that contains the session identifier of the swapped out session. The column type must accept character string data of at least as many characters as are contained in session identifiers. (only applicable to the JDBCStore session manager)
sessionLastAccessCol The name of the database column, contained in the specified session table, that contains the lastAccessedTime property of this session. The column type must accept a Java long (64 bits). (only applicable to the JDBCStore session manager)
sessionMaxInactiveCol The name of the database column, contained in the specified session table, that contains the maxInactiveInterval property of this session. The column type must accept a Java integer (32 bits). (only applicable to the JDBCStore session manager)
sessionTable The name of the database table to be used for storing swapped out sessions. This table must contain, at least, the database columns that are configured by the other attributes of this element. (only applicable to the JDBCStore session manager)
sessionValidCol The name of the database column, contained in the specified session table, that contains a flag indicating whether this swapped out session is still valid or not. The column type must accept a single character. (only applicable to the JDBCStore session manager)
The Session Properties specifies how the sessions behave in the Application Server. The following table lists the session properties. The first column lists the name of the property and the second column provides a description of the property and the default value for the property wherever applicable.
Name Value
timeoutSeconds The default maximum inactive interval, in seconds, for all sessions created in this web module. If set to 0 or less, sessions, this web module never expire.
enableCookies If this property is set to true, cookies are used for session tracking.
enableURLRewriting If this property is set to true, URL rewriting is enabled. This provides session tracking via URL rewriting when the browser does not accept cookies. You must also use an encodeURL or encodeRedirectURL call in the servlet or JSP.
idLengthBytes The number of bytes in this web module’s session ID.
The Cookie Properties specifies the cookies generated by the Application Server.

The following table lists the session cookie properties. The first column lists the name of the property and the second column provides a description of the property and the default value for the property wherever applicable.
Name Value
cookieName The name of the cookie used for session tracking.
cookiePath The pathname that is set when the cookie is created. The browser sends the cookie if the pathname for the request contains this pathname. If set to / (slash), the browser sends cookies to all URLs served by the Application Server. You can set the path to a narrower mapping to limit the request URLs to which the browser sends cookies.
cookieMaxAgeSeconds The expiration time, in seconds, after which the browser expires the cookie.
cookieDomain The domain for which the cookie is valid.
cookieComment The comment that identifies the session tracking cookie in the cookie file. Applications can provide a more specific comment for the cookie.


Legal Notices