Hybrid Work Job

Overview

A Hybrid Work Job enables efficient collaboration between end-users. This data workflow type implements a combination of Primary Storage devices, Caching Gateways and Agents installed on end users' workstations for seamless access to shared files in the office, on the road or at home.

Primary Storage devices store the golden copy of the data synchronized within this Job. These are centrally deployed on-premises servers, or cloud storage solutions. Caching Gateways are located closer to the edge (for example, at each branch office) and accessed locally over SMB or NFS.

Agents installed on end-users' workstations ensure access to always up-to-date files outside the office. End-users Agents can synchronize files with Caching Gateways as well as Primary Storage devices.

Create a Hybrid Work Job

To create a Hybrid Work Job:

In the Management Console , from the top menu, select Jobs.
Select Configure Jobs , then click + CREATE NEW JOB.
Select Hybrid Work , then click Next.
On the DETAILS tab:
1. Enter the name.
2. Enter the optional description that will help understand the purpose of this Job, then click Next.
On the SETTINGS tab:
1. (Optional) Choose a drive letter to enable mapping the synchronization folder to a specified drive. Applicable to Windows workstations. For details, see Mapping job folder to a drive letter on windows.
2. Select Job’s priority.
  Note : Job priority determines the order in which the Agent handles its data transfers queue. High priority Jobs' transfers are handled first. While the lower priority Jobs are waiting for their transfer window, the Agent is performing non-transfer related tasks such as indexing files or merging the folder tree. In case of multiple Jobs with the same priority, their data transfers are performed simultaneously. For more information, see Job priority.
3. (Optional) Enable File Locking and adjust its parameters:
  - File lock timeout - Locked file idle time after which the lock server releases a locked file.
  - Locked files update interval - Time interval between locked file's status check.
    Note : For optimal performance, we recommend leaving the default value unchanged.
  - When Agent is not connected to Lock server - Access level to shared files when the locking server is unavailable.
  - Ignore locks for these files and folders - A regular expressions (PCRE2 syntax) to match files and folders that you want to exclude from locking. Add each regular expression in a separate line.
    1. In the User groups section, click + ADD USER GROUP , then select a group. Click Add and choose access level to the Job:
  - View only - Permission to view the Job on the Jobs list and access its status information.
  - Run - Permission to initiate a Job run (applicable to Distribution, Consolidation and Script Jobs).
  - Edit & Run - Permission to edit the Job's configuration and initiate Job runs. Users with Edit & Run permission cannot delete a Job.
  - Full Access - Permission to edit and delete a Job as well as initiate Job runs.
4. Click Next.
5. On the PROFILE tab, select Job settings - a pre-defined set of parameters that fine-tunes the Job run, then click Next.
  Tip : Select Unique for this Job to customize profile settings specifically for the Job being set up.
On the PRIMARY STORAGE tab, set up your Primary Storage devices:
1. Select individual Agents, or Agent groups, that will participate as Primary Storage devices.
  Note : macOS devices must run Resilio Agent 4.2 or newer to participate in the Hybrid Work Job as Primary Storage devices.
  Tip : Click + CREATE NEW GROUP to define a new Agents group. For details, see Groups tab and adding new groups.
2. Select options:
  - Read-only - Agent will be only allowed to download the files. Any files copied or added to the synchronization folder manually won't be propagated to other Agents.
    Note : There must be at least one non-read-only Primary Storage Agent.
  - Priority Agent - Priority Agents store a full copy of files in the synchronized folder. This ensures that when there are Agents with the Transparent Selective Sync (TSS) enabled (in Hybrid Work Jobs, TSS is enabled by default), there's a full copy of the data available. If a TSS-enabled Agent wants to offload some of the files, it will be allowed to do so only when the upload to one of the Priority Agents has been completed. While all Agents comprise a mesh network and exchange the data with each other, data transfers to Priority Agents are prioritized.
    Note : There must be at least one Priority Agent selected.
  - Lock server - Agent will be responsible for keeping track of locked files. For details, see File locking in Resilio Active Everywhere Jobs.
3. Click Specify path to select path or click the suggested path to modify it.
4. Select storage location option:
  - Direct path - Provide a direct, absolute path to the synchronization folder.
  - Storage connector - Select a previously defined cloud storage connector or add a new one. For details, see Setting up cloud storage and configuring Jobs.
  - %FOLDERS_STORAGE% - A special path macro pointing to agent's default storage folder location.
  - %DOWNLOADS% - A path macro pointing to downloads folder location. The path that the macro is resolved to depends on the operating system the Agent is running on. For details, see Path macros.
  - %HOME% - A path macro pointing to the home folder location. The path that the macro is resolved to depends on the operating system the Agent is running on. For details, see Path macros.
  - %USERPROFILE% - A path macro pointing to user profile folder location. The path that the macro is resolved to depends on the operating system the Agent is running on. For details, see Path macros.
5. (Optional) Click Browse to browse the file system and navigate to location where you want to store the synchronization folder for this Job. Select an existing folder or click + CREATE FOLDER to create a new one, then click Select.
  Note : For Agents with the limited user option enabled, file system browsing is limited to the default storage folder path. For details, see Limiting admin’s access to the Agent.
6. Click Save , then click Next.
On the CACHING GATEWAY tab, configure local caching instances:
1. Select individual agents, or agent groups, that will serve as an on-site cache.
  Important : Before you select a Linux-based system, make sure it has been set up accordingly. For details, see Configuring Linux OS cache servers.
  Note : macOS devices cannot participate in Hybrid Work Jobs as Caching Gateways.
  Tip : Click + CREATE NEW GROUP to define a new Agents group. For details, see Groups tab and adding new groups.
2. Select options:
  - Read-only - Agent will be only allowed to download the files. Any files copied or added to the synchronization folder manually won't be propagated to other Agents.
  - File policy - A set of rules that manage data hydration. For details, see File policy.
3. Click Specify path to select path or click the suggested path to modify it.
4. Select storage location option:
  - Direct path - Provide a direct, absolute path to the synchronization folder.
  - %FOLDERS_STORAGE% - A special path macro pointing to agent's default storage folder location.
  - %DOWNLOADS% - A path macro pointing to downloads folder location. The path that the macro is resolved to depends on the operating system the Agent is running on. For details, see Path macros.
  - %HOME% - A path macro pointing to the home folder location. The path that the macro is resolved to depends on the operating system the Agent is running on. For details, see Path macros.
  - %USERPROFILE% - A path macro pointing to user profile folder location. The path that the macro is resolved to depends on the operating system the Agent is running on. For details, see Path macros.
    Important : For Linux-based servers, you must provide Linux and Linux cache paths. The former is the path over which the data is exposed for NFS and SMB access, while the latter is where the files are actually stored.
5. (Optional) Click Browse to browse the file system and navigate to location where you want to store the synchronization folder for this Job. Select an existing folder or click + CREATE FOLDER to create a new one, then click Select.
  Note : For Agents with the limited user option enabled, file system browsing is limited to the default storage folder path. For details, see Limiting admin’s access to the Agent.
6. Click Save , then click Next.
On the END-USER AGENTS tab:
1. Select individual agents, or agent groups, that will participate in the Job.
  Tip : Click + CREATE NEW GROUP to define a new Agents group. For details, see Groups tab and adding new groups.
2. Select options:
  - Read-only - Agent will be only allowed to download the files. Any files copied or added to the synchronization folder manually won't be propagated to other Agents.
  - File policy - A set of rules that manage data hydration. For details, see File policy.
3. Click Specify path to select path or click the suggested path to modify it.
4. Select storage location option:
  - Direct path - Provide a direct, absolute path to the synchronization folder.
  - %FOLDERS_STORAGE% - A special path macro pointing to agent's default storage folder location.
    Note : Select Ask user to prompt the user in the Agent UI to select folder upon initializing the Job.
  - %DOWNLOADS% - A path macro pointing to downloads folder location. The path that the macro is resolved to depends on the operating system the Agent is running on. For details, see Path macros.
  - %HOME% - A path macro pointing to the home folder location. The path that the macro is resolved to depends on the operating system the Agent is running on. For details, see Path macros.
  - %USERPROFILE% - A path macro pointing to user profile folder location. The path that the macro is resolved to depends on the operating system the Agent is running on. For details, see Path macros.
5. (Optional) Click Browse to browse the file system and navigate to location where you want to store the synchronization folder for this Job. Select an existing folder or click + CREATE FOLDER to create a new one, then click Select.
  Note : For Agents with the limited user option enabled, file system browsing is limited to the default storage folder path. For details, see Limiting admin’s access to the Agent.
6. Click Save , then click Next.
On the REFERENCE AGENT tab, select a Reference Agent, then click Next.
Note : Reference Agent is mandatory for Jobs configured to synchronize NTFS or POSIX permissions. In other cases, selecting a Reference Agent isn't necessary, but it can speed up the initial merging of contents of non-empty synchronization folders. Read-only Job participants cannot be Reference Agents, thus they're not available for selection. For more information, see Reference Agent.
On the NOTIFICATIONS tab:
1. Click + ADD NOTIFICATIONS.
2. From the Trigger drop-down list, select an event that will trigger notification.
3. (Optional) Click Skip notice if Jobs did not transfer files to disable notification in case there were no files transferred during the scheduled Job run.
4. Click + ADD RECIPIENT and select one of the options:
  - Add me - Add the currently logged in user.
  - Add user - Add another Resilio user.
  - Add e-mail - Add an email address of the recipient.
  - Add webhook - Add a predefined webhook URL.
5. Click Save , then click Next.
On the SUMMARY tab, verify your Job's configuration, then click Save.

Monitor a Hybrid Work Job

To monitor your cache utilization in a Hybrid Work Job:

In the Management Console , from the top menu, select Jobs.
On the JOB RUNS list, locate and click the Job run you want to monitor.
Select the AGENTS tab, then locate and click the Caching Gateways.
On the OVERVIEW tab, locate the CACHE USAGE section for information on cache utilization. For more information, see File Caching Job - Monitor Cache Utilization.

Info

Zero-sized files are calculated differently on Windows and Linux, resulting in discrepancy in the file size reported in cache server details.
Windows servers don't include the zero-sized files in file counters in the job run details, until they are populated in cache by opening their location in a file browser. Until then these zero-sized files will be pending in Files queue for this server.
Linux servers calculate them in the cache details right away.

Peculiarities and limitations

End-user Agent can also manage the files using the TSS context menu. However, they cannot dehydrate the files that are pinned by the File policy.
End-user Agents may report invalid files counter values, if there are files that have been dehydrated manually rather than by the File policy rule.
Files on the Primary Storage, which are ignored by the File and folder name filter custom parameter in the Job Profile, may appear as in progress on the caching server.