File System on WebSphere Commerce server is filling

up with dynacache .htod files
 Technote (troubleshooting)
Problem(Abstract)
You notice the file system on your WebSphere Commerce server is filling up with dynacache .htod files.
Cause
There are Java™ Virtual Machine properties that can be used to define the clean up procedure for the .htod files in question. Depending on the nature of the WebSphere Commerce site, these properties need to be set in order to prevent the file system from filling up with these files.
Resolving the problem
If the estimated total size of all cached objects is bigger than the available memory, you can enable the disk offload option in WAS. The files that get created on the file system for the disk offload option are the .htod files in question, and these contain the cache entries that were offloaded. Over time, the file system will fill up with these .htod files, and they need to be cleaned out. The following two Java Virtual Machine properties can be used to configure the clean up procedure.
com.ibm.ws.cache.CacheConfig.diskCacheSizeInGB:

This property can be used to specify the maximum size (in GB) of the disk cache. By setting this, you are limiting the number of .htod files that get created. You must first install PK13460 if you want to use this property.

com.ibm.ws.cache.CacheConfig.htodCleanupFrequency:

By default, the disk cache cleanup is scheduled to run every 24 hours at midnight to remove expired cache entries and cache entries that have not been accessed in the past 24 hours. The JVM property com.ibm.ws.cache.CacheConfig.htodCleanupFrequency can be used to change the time interval between disk cache cleanups. The WebSphere Commerce Recommended fixes and settings Technote recommend a value of 60 (1 hour) for this property. Note that this property also helps performance, because a big clean up job that runs at midnight could cause extremely heavy disk I/O.


To set the above two properties in a WAS 6.0.2.x environment, follow these steps:

  1. Login to the WebSphere Administration Console.

  2. Click Servers > Application servers

  3. Select the Commerce Server.

  4. Under Server Infrastructure, select Java and Process Management > Process Definition

  5. Under Additional Properties, select Java Virtual Machine

  6. Under Additional Properties, select Custom Properties

  7. Click the New button

  8. In the Name field, type the name of the Java Virtual Machine property you wish to set, such ascom.ibm.ws.cache.CacheConfig.diskCacheSizeInGB

  9. In the Value field, type the desired value for the JVM property, such as 2.

  10. Click OK and save the changes - this setting will take effect when the server is restarted.


To set the above two properties in a WAS 5.1.1.x environment, follow these steps:

  1. Log in to the WebSphere Administration Console.

  2. Click Servers > Application Servers

  3. Select the Commerce Server.

  4. Under Additional Properties, select Process Definition.

  5. Under Additional Properties, select Java Virtual Machine.

  6. Under Additional Properties, select Custom Properties.

  7. Click on the New button.

  8. In the Name field, type the name of the JVM property you wish to set, such as com.ibm.ws.cache.CacheConfig.diskCacheSizeInGB

  9. In the Value field, type the desired value for the JVM property, such as 2.

  10. Click OK and save the changes - this setting will take effect when the server is restarted.


Like any tuning parameters, careful consideration must be given prior to making any modifications. For more information about these JVM properties, and about general DynaCache configuration, reference the following links:

Redbooks - Mastering DynaCache in WebSphere Commerce
Information Center - Java Virtual Machine cache settings

Cross Reference information
Segment Product Component Platform Version Edition
Commerce WebSphere Commerce Business Edition Performance AIX, i5/OS, Linux, Solaris, Windows 5.6, 5.6.1 Business Edition
Commerce WebSphere Commerce - Express Performance AIX, i5/OS, Linux, Solaris, Windows 5.6, 5.6.1, 6.0 Express
Commerce WebSphere Commerce Professional Edition Performance AIX, i5/OS, Linux, Solaris, Windows 5.6, 5.6.1, 6.0 Professional Edition
   

Document Information

Current web document: http://www.ibm.com/support/docview.wss?uid=swg21272122