close

Filter

loading table of contents...

Deployment Manual / Version 2404

Table Of Contents

3.1.5 Blob Transformation properties

com.coremedia.transform.blob-cache.base-path
Type java.nio.file.Path
Default  
Description

The path to the transformed image blobs cache. If not set (which is the default), then this cache is deactivated and the results of image transformations are stored using the UAPI cache.

It is recommended to set this property to a folder that is not cleared during CAE restart, for example, /var/cache/coremedia/persistent-transformed-blobcache.

com.coremedia.transform.blob-cache.log-interval-seconds
Type java.time.Duration
Default 600s
Description

Delay for logging metrics of the transformed BLOB cache. The default unit is "seconds".

com.coremedia.transform.blob-cache.size
Type org.springframework.util.unit.DataSize
Default 1GB
Description

The maximum allowed size that the transformed image blob cache can occupy on the disk. This is a separate cache where results of blob transformations are stored persistently and can survive CAE restarts.

Note that the file system overhead for storing the files does not count towards this value. So the physical space that has to be reserved on the disk for the cache has to be slightly higher than value of this configuration property. If several concurrent threads write large blobs at the same time, the deletion of the folder with the old unused files can be postponed for later, thus this is the second reason why the maximum allowed cache size can grow slightly higher than this configuration property. The size of such deviation depends on the blobs size as well as the amount of parallel threads.

The default unit is "bytes".

com.coremedia.transform.memory-guard.safety-factor
Type java.lang.Double
Default 1.2
Description

A safety factor of the memory guard configured for the imageTransformer. Setting this to zero disables memory checks.

com.coremedia.transform.throttle.fallback-factor
Type java.lang.Integer
Default 1
Description

A factor to multiply the blob size with if the size of the in-memory representation needed for transformation cannot be determined. A warning is logged if this happens.

com.coremedia.transform.throttle.hard-limit
Type java.lang.Boolean
Default true
Description

Specifies whether the configured permits should be considered a hard limit for transformations.

Setting this to false allows transformations needing more permits (serialized, one at a time). This would allow larger images to be transformed, but would make OutOfMemoryErrors during transformations more likely.

com.coremedia.transform.throttle.permits
Type java.lang.Integer
Default 0
Description

Capacity of the ThrottlingBlobTransformer. Default is 0 (zero), which falls back to 1/4 of the total JVM memory size (in megabytes).

com.coremedia.transform.throttle.safety-factor
Type java.lang.Double
Default 3
Description

A safety factor for the ImageSizePermitStrategy to multiply the memory size of an image with. The default number of 3 takes into account that some image operations need to make a copy of the image, plus one copy for the in-memory cache for loaded images.

Table 3.5. Blob Transformation Properties


cache.capacities.com.coremedia.transform.image.java2d.LoadedImageCacheKey
Value Number
Default 100 MB
Description

The size of the loaded image cache, in bytes.

Table 3.6. Further Configuration Properties


Search Results

Table Of Contents
warning

Your Internet Explorer is no longer supported.

Please use Mozilla Firefox, Google Chrome, or Microsoft Edge.