Topic: caArray Usage
Release: caArray 2.0 and above
Date entered: 10/27/2011
caArray has its own internal mechanism for setting the timeout delay; this mechanism overrides any timeout setting specified by your JBoss installation. This article explains how to change caArray's timeout delay by editing a setting in the 'web.XML' file found in the 'caarray.EAR' application archive.
The timeout delay, defined as the duration of inactivity before the session times out and the user is logged out, is specified by the value of the <session-timeout> tag in the 'web.XML' file. The default value, in minutes, is '30', as shown below:
<session-timeout>30</session-timeout>
This value can be changed to any positive integer.
The 'web.XML' file must be extracted from the 'caarray.EAR' archive before it can be edited. Once it has been edited, the file must be re-packaged into 'caarray.EAR', and the original 'caarray.EAR' in your caArray installation folder must be overwritten with the modified version.
In order to manage EAR and WAR archives, you will need an archive utility with support for the ZIP format. The utility used in this article is WinZip (www.winzip.com), which is freely available.
JBoss provides its own mechanism for altering the session timeout delay for applications running within a JBoss instance. However, the caArray-specific timeout setting as specified in 'web.XML' overrides the JBoss-general setting. In other words, the JBoss timeout setting is irrelevant in caArray; in order to change the caArray timeout delay, you must follow the procedure outlined in this article. If you do not follow this procedure, your caArray timeout delay will remain at the application's default of 30 minutes regardless of what your JBoss timeout is set to.
\\ *_\[caArray installation folder\]_{*}*\{*{*}_}\[JBoss installation folder\]_{*}*\server\deploy* |
In our example, the caArray installation folder is named 'caarray' and the JBoss installation folder is named 'jboss-4.0.5.GA', so the fully qualified path of the EAR archive is:
caarray\jboss-4.0.5.GA\server\deploy\caarray.ear
\\ *_\[WAR folder path\]_{*}*\WEB-INF* \\ |
In summary, to change the session timeout delay:
Copy the re-created 'caarray.EAR' file to the path *_\[caArray installation folder\]_{*}*\{*{*}_}\[JBoss installation folder\]_{*}*\server\deploy*, overwriting the existing 'caarray.EAR'. |
Please leave your comment in the caArray End User Forum.