Cameyo's SessionSync data persistence mechanism synchronizes user profile files and registry keys between sessions. Here is how to configure which files get synchronized.

By default, all user's profile files are included within the synchronization mechanism, except the default exclusion list shown at the end of this article.

To extend or modify the list of synchronized files, you can create a file named C:\RemoteAppPilot\Settings\Upcs.filters, of which an example is shown here:

# Upcs.filters: list of inclusion and exclusion rules for files synchronization

+ AppData/Local/My App/**
- *.jpg
{Defaults}

You can also define these filters as a dynamic env variable, as described below, thus making them vary according to Cameyo clusters / servers / apps / users.

Follow the following syntax:

  • Lines beginning with + indicate additional paths to include.
  • Lines beginning with - indicate paths to exclude.
  • {Defaults} refers to Cameyo's default built-in rules (which are used by default if this filters file does not exist).
  • Lines beginning with # are ignored, reserved for comments.
  • Empty lines are ignored.
  • Cameyo's service on the server needs to be restarted for changes to take effect.

Rules are processed from the top to the bottom, the first match wins. For example in the following case, *.xyz files are excluded, but abc.xyz is still included:

+ abc.xyz
- *.xyz

Another example

# Upcs.filters: list of inclusion and exclusion rules for files synchronization

- SomeDir/**
- Draft.*
- *.tmp
- Options.ini
+ AppData/Local/**
{Defaults}

In the above example, folder SomeDir is recursively excluded. Any file named Draft.[anything] is excluded, as well as any file with .tmp extension. Any file named Options.ini will be excluded, regardless of directory. Last, AppData/Local (excluded by Cameyo's built-in rules) is included in data synchronization. The rest of Cameyo's default filters are then taken into account

Defaults

As of April 2020 {Defaults} corresponds to the following:

- Shared/**
- Outbound/**
- GDrive/**
- GDriveSvc/**
- GTeamDrive/**
- GTeamDriveSvc/**
- MS/**
- Dropbox/**
- DropboxSvc/**
- RapData/**
- Links/**
- CCPTmp/**
- Windows/**
- AppData/LocalLow/**
- AppData/Local/**
- AppData/Roaming/Microsoft/Protect/**
- AppData/Roaming/VOS/**
- AppData/Roaming/Microsoft/Windows/SendTo/**
- AppData/Roaming/Microsoft/SystemCertificates/**
- AppData/Roaming/Microsoft/Search/Data/Applications/**
- NTUSER.*
- *.lnk
- Desktop.ini
- SessionInfo.*
- Cameyo.log

Environment variable setting

You can configure data persistence filters using Cameyo's dynamic environment variables CAMEYO_UPCS_INCLUDE, CAMEYO_UPCS_EXCLUDE or the more advanced CAMEYO_UPCS_FILTERS variable:


CAMEYO_UPCS_EXCLUDE / CAMEYO_UPCS_INCLUDE / CAMEYO_UPCS_EXCLUDE2

These environment variables allow you to define inclusion & exclusion filters in a simplified semi-column-separated form, and are matched in the indicated order of precedence: EXCLUDE is checked first, then INCLUDE, then EXCLUDE2.

Example:

CAMEYO_UPCS_INCLUDE=Documents/Adobe/Premiere Pro/**;AppData/Roaming/Adobe/Premiere Pro/**


CAMEYO_UPCS_FILTERS

The CAMEYO_UPCS_FILTERS environment variable uses the same syntax as the Upcs.filters file described above, but replacing newlines with '|' (pipe).

Example:

CAMEYO_UPCS_FILTERS=+ *.docx|+ *.bat|- *

In the above example, only .docx and .bat files will be synchronized for the configured app.


You can disable data persistence for a specific Cameyo cluster / server / app / user by setting env variable CAMEYO_UPCS_ENABLED=0