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)