Search
K

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

Calculations

  • 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:

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)