This documentation supports the 22.1 version of Action Request System.
To view an earlier version, select the version from the Product version menu.

Open source cache manager and settings in config.properties file

Mid Tier  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.

PropertyDescription

arsystem.resource_expiry_interval

Sets the cache expiry time (in seconds) after which the browser checks  Mid Tier 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  Mid Tier . 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.

PropertyDescription

arsystem.ehcache.referenceMaxElementsInMemoryWeight.formImages

The maximum elements in memory weight for the AR System form images cache. The default value is 0.104.

arsystem.ehcache.referenceMaxElementsInMemoryWeight.activeLinks

The maximum elements in memory weight for the AR System active links cache. The default value is 4.904.

arsystem.ehcache.referenceMaxElementsInMemoryWeight.groups

The maximum elements in memory weight for the AR System groups cache. The default value is 0.025.

arsystem.ehcache.referenceMaxElementsInMemoryWeight.roles

The maximum elements in memory weight for the AR System 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 AR System 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 AR System forms cache. The default value is 1.14.

arsystem.ehcache.referenceMaxElementsInMemoryWeight.forms

The maximum elements in memory weight for the AR System 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 AR System 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.overflowToDiskTemp=true
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.referenceMaxElementsInMemory=3500
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

Was this page helpful? Yes No Submitting... Thank you

Comments