Cache settings
This policy is applicable to version 2.0 and above
Basics
All files, that are read from or written to SharePoint Online via KONNEKT are temporarily cached on the local disc.
The cache directory is located at: %localappdata%\konnekt\cache
This policy defines the caching behavior of KONNEKT.
KONNEKT uses the cache for different purposes:
Files that are currently opened by the user
Files that need to be uploaded (write cache)
Files that are closed (read cache)
Definitions
Cache TTL (Time To Live)
How long (in minutes) closed documents (read cache) will stay in the Cache. Without this setting, TTL remains automatically at 60 minutes - at "Normal pressure". This value needs to be filled in the input field if the policy is enabled. The cache is always cleared after a restart of KONNEKT.
Dimension: Minutes
Minimum Value: 0
Maximum Value:
2880 (KONNEKT releases < 2.6.0)
60480 (KONNEKT release 2.6.0 or newer)
Fixed Cache Size
How big (in Megabytes) is the KONNEKT cache folder. This value needs to be filled in the input field if the policy is enabled.
Dimension: Megabytes
Minimum Value: 0 => cache size will be calculated from free disk space (default)
Maximum Value: 20000
Behind the scenes
Pressure states
The cache operates in different pressure states:
Normal pressure: The cache is utilized below critical values. Closed files will be kept in the read cache up to the TTL value.
High read pressure: The cache is filled up with too many closed files. The read cache will be deleted.
High write pressure: The cache is holding lots of files queued for upload. Further, write operations will be throttled in order to empty the upload queue.
Critical write pressure: The cache is nearly filled up with files queued for upload. Further, write operations will be throttled significantly in order to empty the upload queue.
Cache full: The cache is completely occupied. Requests to open further files will be rejected.
Automatic cache size calculation
Cache size from free disk calculation sizeMax = (FreeDiskSize + CacheSize) * 75%
High pressure calculation pressure = sizeUsed / sizeMax >= 80%
High write pressure calculation writePressure = uploadSize / sizeMax >= 60%
Critical write pressure calculation writePressure = uploadSize / sizeMax >= 80%
Cache filled calculation sizeUsed >= sizeMax
To apply the policy you have to restart the machine
There are several ways to apply the policy:
manually by adding the key in the registry under machine or user registry settings
via GPO, check settings via GPO
pushing policies via Intune, see setting for Intune Managed Devices
Policies stored in:
HKEY_CURRENT_USER\SOFTWARE\Policies\GlueckKanja\Konnekt
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\GlueckKanja\Konnekt
To apply the policy you have to restart the machine
Recommendations for VDI environments
We recommend the following settings for VDI environments in general, but please make sure, that this setting fit your use-case of KONNEKT:
Cache TTL: 10-60 min
Cache Size: 500-1000 MB
You may also want to restrict the file size, that you are reading from SharePoint Online:
OneDriveOpenFilesLargerThanReadOnly: 100-500 MB (= 104,857,600 - 524,288,000 bytes)
OneDriveDoNotOpenFilesLargerThan: 200-1000 MB (= 209,715,200 - 1,048,576,000 bytes)
Last updated
