2.7.8 Execution environment settings

To use the session management functionality, you must set up a J2EE server.

Also, when you use J2EE applications that do not contain cosminexus.xml, you are not required to set up or change the execution environment properties.

Organization of this subsection
(1) Setting up the J2EE server
(2) Setting up the J2EE application

(1) Setting up the J2EE server

Implement the J2EE server settings in the Easy Setup definition file. Define the session management functionality in the <configuration> tag of the logical J2EE server (j2ee-server) in the Easy Setup definition file.

The following table describes the session management functionality defined in the Easy Setup definition file:

Table 2-30 Definition of the session management functionality in the Easy Setup definition file

ItemsParameter to be specifiedSetting contents
Customizing the session parameterswebserver.session.cookie_config.nameSpecifies the name of HTTP Cookie and the path parameter name of a URL.
webserver.session.cookie_config.http_onlySpecifies whether to add the HttpOnly attribute in HTTP Cookie.
webserver.session.tracking_modeSpecifies the HTTP session management method.
Set maximum number of HttpSession objectswebserver.session.max.throwHttpSessionLimitExceededExceptionSpecify whether to throw com.hitachi.software.web.session.HttpSessionLimitExceededException when the number of HttpSession objects exceeds the upper limit.
To throw java.lang.IllegalStateException, specify false.
webserver.session.max.log_intervalSpecify the output interval for KDJE39225-E.
Adding server ID to the session ID and Cookiewebserver.session.server_id.enabledSpecify whether to add the server ID to the session ID.
webserver.session.server_id.valueSpecify the server ID to be added to the session ID.
webserver.container.server_id.enabledSpecify whether to add the server ID to the Cookie.
webserver.container.server_id.nameSpecify the name of the Cookie to be added to the server ID.
webserver.container.server_id.valueSpecify the server ID to be added to the Cookie.

For details on the Easy Setup definition file and the parameters to be specified, see 4.6 Easy Setup definition file in the uCosminexus Application Server Definition Reference Guide.

(2) Setting up the J2EE application

Set up the J2EE applications in the execution environment using the server management commands and property files. Use the WAR property file to define the session management functionality.

The tags specified in the WAR property file correspond to cosminexus.xml. The definition of the session parameter customization conforms to the standard specifications of Servlet 3.0. For details on the definitions in cosminexus.xml, see 2.7.7 Definition in cosminexus.xml.