TechNote (Archived)

JRun 4 Updater 6 : Hot fix 56259

Issue

This TechNote provides a hot fix for the following JRun defect:

56259 “ User-timeout property provided for a JRun data source does not work any more with JRun 4 Updater 3. If a query takes more than the value provided for the user-timeout, JRun does not stop processing the query.

Reason

The user timeout functionality is implemented in JRun using the lifeguard thread. This thread was removed in JRun 4 Updater 3 as it caused JRun/ColdFusion to hang under certain conditions. Removing usertimeout caused the number of database connections to increase if the applications did not close the connections properly in their applications. Customers were able to fix the problem by changing their code to close all the connections, which is the best thing to do.

Customers who cannot fix their code to close all the connections can apply the hot fix provided in this TechNote so that the connections are closed by the JRun pool after the amount of time set for the user-timeout. This hot fix is enabled only when the usertimeout is set to a certain value. If the usertimeout value is set to 0, then JRun connections will be moved to the connection pool only if the application closes the connection. If the usertimeout value is set to a specific value, for example 20 seconds, JRun will move the active or inactive connection to the connection pool once the connection is outside the pool for 20 seconds. Usertimeout needs to be set properly so JRun can remove an active connection to the pool.

Solution

Note: Macromedia strongly recommends installing and testing hot fixes in your test/staging environment prior to deployment on live production systems.

Follow the instructions below to install the hot fix build:

Download the hot fix JAR file. (18K)
Copy the JAR file into the servers\lib directory (or "servers/lib" on Unix and Linux).
This hot fix is compatible with JRun4 Updater 6 (build 106363) and greater. You can verify your build number by one of the following options:
- Open the JRun Management Console. Select the Settings, then Version links to display the build number.
- Run the following command at the command prompt:
  
  On Windows 2000, NT and Win9x:
  
  cd "{jrun-base-dir}\bin"
  jrun -info
  
  On Unix and Linux:
  
  cd $JRUN_HOME/bin
  jrun -info
Restart JRun server and test your application.