Open source cache manager and settings in config.properties file
includes an open-source cache manager, ehcache. The following properties are available in the config.properties file to enable advanced administrators to customize the cache behavior.
Property | Description |
|---|---|
arsystem.resource_expiry_interval | Sets the cache expiry time (in seconds) after which the browser checks for updated resources such as images and JavaScript files. The default value is 3600. |
arsystem.ehcache.maxElementsInMemory | Sets the maximum number of objects that will be maintained in the memory cache. If set to 0, the number of objects is unlimited. The default value is 2147483647. |
arsystem.ehcache.eternal | Sets whether elements are eternal. If eternal, timeouts are ignored and the element is never expired. The default value is true. |
arsystem.ehcache.timeToIdleSeconds | Sets the maximum amount of time between accesses before an element expires. This setting is used only if the element is not eternal (arsystem.ehcache.eternal=false). A value of 0 means that an element can idle for infinity. The default value is 0. |
arsystem.ehcache.timeToLiveSeconds | Sets the maximum time between creation time and when an element expires. This setting is used only if the element is not eternal (arsystem.ehcache.eternal=false). A value of 0 means that an element can live for infinity. The default value is 0. |
arsystem.ehcache.overflowToDisk | Sets whether the disk store persists to disk between restarts of the Java Virtual Machine. The default value is true. If the Enable Cache Persistence option is selected in the Mid Tier Configuration Tool, the value is set to true. |
arsystem.ehcache.overflowToDiskTemp | Sets whether to cache items to overflow from memory to disk. The cache items are not preserved between restarts of the Java Virtual Machine. The default value is false. If set to true when arsystem.ehcache.overflowToDisk is set to true, duplicate storage of the same cache item on disk might result. |
arsystem.ehcache.maxElementsOnDisk | Sets the maximum number of objects that will be maintained in the DiskStore. The default value is 0 (unlimited). |
arsystem.ehcache.diskExpiryThreadIntervalSeconds | Sets the number of seconds between runs of the disk expiry thread. The default value is 600. |
arsystem.ehcache.memoryStoreEvictionPolicy | Sets the memory policy. The policy would be enforced upon reaching the maxElementsInMemory limit. The default policy is Least Recently Used (LRU). Other policies include First In First Out (FIFO) and Less Frequently Used (LFU). |
arsystem.ehcache.referenceMaxElementsInMemory | The maximum number of elements in memory for each cache maintained by . Because caches grow at different rates, this value is used as a base value, which is then multiplied by a cache-specific weight value. This property is used in conjunction with the arsystem.ehcache.referenceMaxElementsInMemoryWeight. cacheType to determine the maximum number of elements in memory allowed for a given cache. After the maximum has been reached for a given cache, elements are split over to disk using an LRU policy if disk persistence has been enabled. By changing this value, you can adjust the maximum sizes for all caches and maintain the appropriate weightings for each cache. If this property is specified, then arsystem.ehcache.maxElementsInMemory is no longer in effect. If the property is not specified, then arsystem.ehcache.maxElementsInMemory behaves as before. There is no specified default value. |
The value in each of the following properties is multiplied with the value specified by the arsystem.ehcache.referenceMaxElementsInMemory property to determine the maximum number of elements in memory allowed for the specified cache. After the maximum has been reached, elements are spilled over to disk using the policy specified by the property arsystem.ecache.memoryStoreEvictionPolicy, if disk persistence has been enabled.
Property | Description |
|---|---|
arsystem.ehcache.referenceMaxElementsInMemoryWeight.formImages | The maximum elements in memory weight for the form images cache. The default value is 0.104. |
arsystem.ehcache.referenceMaxElementsInMemoryWeight.activeLinks | The maximum elements in memory weight for the active links cache. The default value is 4.904. |
arsystem.ehcache.referenceMaxElementsInMemoryWeight.groups | The maximum elements in memory weight for the groups cache. The default value is 0.025. |
arsystem.ehcache.referenceMaxElementsInMemoryWeight.roles | The maximum elements in memory weight for the roles cache. The default value is 0.036. |
arsystem.ehcache.referenceMaxElementsInMemoryWeight.js | The maximum elements in memory weight for the JavaScript cache. The default value is 0.195. |
arsystem.ehcache.referenceMaxElementsInMemoryWeight. displayedFields | The maximum elements in memory weight for the display fields cache. The default value is 0.157. |
arsystem.ehcache.referenceMaxElementsInMemoryWeight.fieldMaps | The maximum elements in memory weight for the field maps cache. The default value is 0.323. |
arsystem.ehcache.referenceMaxElementsInMemoryWeight.sysdata | The maximum elements in memory weight for the system data cache. The default value is 1.202. |
arsystem.ehcache.referenceMaxElementsInMemoryWeight. compiledForms | The maximum elements in memory weight for the compiled forms cache. The default value is 1.14. |
arsystem.ehcache.referenceMaxElementsInMemoryWeight.forms | The maximum elements in memory weight for the forms cache. The default value is 0.235. |
arsystem.ehcache.referenceMaxElementsInMemoryWeight.html | The maximum elements in memory weight for the HTML cache. The default value is 0.195. |
arsystem.ehcache.referenceMaxElementsInMemoryWeight.formFields | The maximum elements in memory weight for the form fields cache. The default value is 28.577. |
arsystem.ehcache.overflowToDiskTemp | Whether to allow cache items to overflow from memory to disk temporarily. The overflow behavior follows the policy specified by the property arsystem.ehcache.memoryStoreEvictionPolicy. The cache items are not preserved between Java Virtual Machine (JVM) restarts. This property can be set to true along with arsystem.ehcache.overflowToDisk being set to true, but might result in duplicate storage of the same cache item on disk, wasting disk space. This property honors the values for arsystem.ehcache.maxElementsOnDisk and arsystem.ehcache.diskcache.maxElementsInMemory. The default value is false. |
arsystem.ehcache.midTierCacheTempDir | Specifies the directory where overflow elements from the caches are stored if temporary disk persistence is enabled. This property is in effect only if arsystem.ehcache.overflowToDiskTemp is set to true. The default value is midTierRootDirectory/cachetemp. |
Cache configuration example: Temporary disk persistence enabled
The following example of property values for cache persistence is for temporary disk persistence enabled (out-of-box configuration).
arsystem.ehcache.midTierCacheTempDir=
Setting these properties allows cache elements to spill over to disk temporarily. The spilled-over cache elements are stored in the directory midTierRootDirectory/cachetemp.
Cache configuration example: Maximum elements in memory
The following example of property values for cache persistence is for maximum elements in memory (out-of-box configuration).
arsystem.ehcache.referenceMaxElementsInMemoryWeight.formImages=0.104
arsystem.ehcache.referenceMaxElementsInMemoryWeight.activeLinks=4.904
arsystem.ehcache.referenceMaxElementsInMemoryWeight.groups=0.025
arsystem.ehcache.referenceMaxElementsInMemoryWeight.roles=0.036
arsystem.ehcache.referenceMaxElementsInMemoryWeight.js=0.195
arsystem.ehcache.referenceMaxElementsInMemoryWeight.displayedFields=0.157
arsystem.ehcache.referenceMaxElementsInMemoryWeight.fieldMaps=20
arsystem.ehcache.referenceMaxElementsInMemoryWeight.sysdata=1.202
arsystem.ehcache.referenceMaxElementsInMemoryWeight.compiledForms=1.5
arsystem.ehcache.referenceMaxElementsInMemoryWeight.forms=0.400
arsystem.ehcache.referenceMaxElementsInMemoryWeight.html=0.195
arsystem.ehcache.referenceMaxElementsInMemoryWeight.formFields=8.577
arsystem.ehcache.referenceMaxElementsInMemoryWeight.actorViews=0.32
arsystem.ehcache.referenceMaxElementsInMemoryWeight.actorViewsMapping=0.32
As noted in the following table, setting these properties specify the maximum number of elements for each cache:
Maximum number of elements for cache types
Cache type | Calculation | Maximum number of elements |
|---|---|---|
Form images | 3500 * 0.104 | 364 |
Active links | 3500 * 4.094 | 14329 |
Groups | 3500 * 0.025 | 87 |
Roles | 3500 * 0.36 | 1260 |
JavaScript | 3500 * 0.195 | 682 |
Display fields | 3500 * 0.157 | 549 |
Field maps | 3500 * 20 | 70000 |
System data | 3500 * 1.202 | 4207 |
Compiled forms | 3500 * 1.5 | 5250 |
Forms | 3500 * 0.400 | 1400 |
HTML | 3500 * 0.195 | 683 |
Form fields | 3500 * 8.577 | 10721 |
Actor views | 3500 * 0.32 | 1120 |
Actor views mapping | 3500 * 0.32 | 1120 |