Use this page to configure and manage the dynamic cache service settings.
To view this administrative console page, click
.The dynamic servlet cache service starts when the server starts.
The dynamic servlet cache service starts when servlet caching is enabled in Web Container panel.
Start the dynamic portlet cache service by enabling servlet caching, then, enabling portlet fragment caching under Portlet Container panel.
Specifies whether to configure the server to use the default dynamic cache provider or an alternate cache provider. If an alternate cache provider is available, it appears in the list of available cache providers.
Specifies a positive integer as the value for the maximum number of entries that the cache holds.
Enter a cache size value in this field that is between the range of 100 through 200,000.
Specifies the default priority for cache entries, determining how long an entry stays in a full cache.
Information | Value |
---|---|
Default | 1 |
Range | 1 to 255 |
Specifies the size of the memory cache.
Use this feature to constrain the cache in terms of the JVM heap. In addition to specifying the cache size in MB, dynamic cache also enables you to set a high watermark and low watermark for the cache heap that is consumed. When the cache heap memory reaches the high watermark, dynamic cache either discards or is evicted from the disk using the least recently used (LRU) algorithm, until the cache is brought down to the low watermark. This functionality of limiting the cache in terms of the JVM heap is only available if the objects that are put into the cache implement the sizeable interface. This interface has one method that returns the size of the object in bytes put into the cache. Dynamic cache uses the sizeable interface to estimate the heap size of the cache.
Information | Value |
---|---|
Default | -1 to disable limiting the memory cache size |
Range | 1 to maximum integer |
Specifies a value for the maximum memory cache size in megabytes (MB).
Specifies a high watermark when the memory cache eviction policy starts. The threshold is expressed in terms of the percentage of the memory cache size in megabytes (MB). The default value is 95%
Information | Value |
---|---|
Values | 1 to 100 |
Specifies a low watermark when the memory cache eviction policy ends. The threshold is expressed in terms of the percentage of the memory cache size in megabytes (MB). The default value is 80%.
Information | Value |
---|---|
Values | 1 to 100 |
Specifies whether disk offload is enabled.
By default, the dynamic cache maintains the number of entries that are configured in memory. If new entries are created while the cache is full, the priorities that are configured for each cache entry, and a least recently used algorithm, are used to remove entries from the cache. In addition to having a cache entry removed from memory when the cache is full, you can enable disk offload to have a cache entry copied to the file system (the location is configurable). Later, if that cache entry is needed, it is moved back to memory from the file system.
Specifies the location on the disk to save cache entries when disk offload is enabled.
If disk offload location is not specified, the default location, ${WAS_TEMP_DIR}/node/server name/_dynacache/cache JNDI name is used. If disk offload location is specified, the node, server name, and cache instance name are appended. For example, ${USER_INSTALL_ROOT}/diskoffload generates the location as ${USER_INSTALL_ROOT}/diskoffload/node/server name/cache JNDI name. This value is ignored if disk offload is not enabled.
Specifies if in-memory cached objects are saved to disk when the server is stopped. This value is ignored if Enable disk offload is not selected.
Information | Value |
---|---|
Default | false |
Specifies a value for the maximum disk cache size in GB. When you select this option, you can specify a positive integer value. Leaving this option blank indicates an unlimited size. This setting applies only if enable disk offload is specified for the cache.
Information | Value |
---|---|
Value | 3 and above. |
Specifies a value for the maximum disk cache size in number of entries. When you select this option, you can specify a positive integer value. Leaving this option blank indicates an unlimited size. This setting applies only if enable disk offload is specified for the cache.
Information | Value |
---|---|
Value | 0 to MAXINT. A value of 0 indicates unlimited size. |
Specifies a value for the maximum size of an individual cache entry in MB. Any cache entry larger than this value, when evicted from memory, is not offloaded to disk. When you select this option, you can specify a positive integer value. Leaving this option blank indicates an unlimited size. This setting applies only if enable disk offload is specified for the cache.
Information | Value |
---|---|
Value | 0 to MAXINT. A value of 0 indicates unlimited size. |
Specifies the level of performance that is required by the disk cache. This setting applies only if enableDiskOffload is specified for the cache. Performance levels determine how memory resources should be used on background activity such as cache cleanup, expiration, garbage collection, and so on. This setting applies only if enable disk offload is specified for the cache.
Information | Value |
---|---|
High performance and high memory usage | Indicates that all metadata is kept in memory. |
Balanced performance and balanced memory usage | Indicates some metadata is kept in memory. This is the default performance setting and provides an optimal balance of performance and memory usage for most users. |
Low performance and low memory usage | Indicates that limited metadata is kept in memory. |
Custom performance | Indicates that the administrator explicitly configures the memory settings that are used to support the above background activity. The administrator sets these values using the DiskCacheCustomPerformanceSettings object. |
Specifies a value for the disk cache cleanup frequency, in minutes. If this value is set to 0, the cleanup runs only at midnight. This setting applies only when the Disk Offload Performance Level is low, balanced, or custom. The high performance level does not require disk cleanup, and this value is ignored.
Information | Value |
---|---|
Value | 0 to 1440 |
Specifies a value for the maximum number of cache identifiers that are stored for an individual dependency ID or template in the disk cache metadata in memory. If this limit is exceeded the information is offloaded to the disk. This setting applies only when the disk offload performance level is CUSTOM.
Information | Value |
---|---|
Value | 100 to MAXINT |
Specifies a value for the maximum number of dependency identifier buckets in the disk cache metadata in memory. If this limit is exceeded the information is offloaded to the disk. This setting applies only when the disk cache performance level is custom.
Information | Value |
---|---|
Value | 100 to MAXINT |
Specifies a value for the maximum number of template buckets that are in the disk cache metadata in memory. If this limit is exceeded the information is offloaded to the disk. This setting applies only when the disk cache performance level is custom.
Information | Value |
---|---|
Value | 10 to MAXINT |
Specifies the eviction algorithm that the disk cache uses to evict entries when the high threshold is reached. This setting applies only if enable disk offload is specified for the cache. This setting does not apply when the disk cache eviction policy is set to none.
Information | Value |
---|---|
None | No eviction policy, so the disk cache can grow until it reaches its limit at which time the dynamic cache service stops writing to disk |
Random | When the disk size reaches a high threshold limit, the disk cache garbage collector wakes up and randomly picks entries on the disk and evicts them until the size reaches a low threshold limit. |
Size | When the disk size reaches a high threshold limit, the disk cache garbage collector wakes up and picks the largest entries on the disk and evicts them until the disk size reaches a low threshold limit. |
Specifies when the eviction policy runs. The threshold is expressed in terms of the percentage of the disk cache size in GB or entries. The lower value is used when limit disk cache size in GB and limit disk cache size in entries are specified. This setting does not apply when the disk cache eviction policy is set to none.
Information | Value |
---|---|
Values | 1 to 100 |
Specifies when the eviction policy ends. The threshold is expressed in terms of the percentage of the disk cache size in GB or entries. The lower value is used limit disk cache size in GB and limit disk cache size in entries are specified. This setting does not apply when the disk cache eviction policy is set to none.
Information | Value |
---|---|
Values | 1 to 100 |