Overview

The lock propagation feature allows you to configure if the lock status for files on the source will transfer to the destination with the same setting, assuming the destination platform supports it. 

Supported Platforms

• Box
• Office 365
• SharePoint 2013-2016
• OneDrive for Business

Example Scenario

1. Create a connector for Box and Office 365.
2. Create a new job with the specified lock propagation setting.
3. On the source connector (i.e., Box), create a folder with one or more files and lock them.
   1. Right-click the file on Box and select the “Lock” option.
   2. Folders cannot be locked on Box.
4. Execute the job (i.e., Box to Microsoft Office 365) and verify that the files are copied and that the file is locked on the destination side.

Expected Results

• If the setting is ignore, no locks will be propagated. On Microsoft Office 365, there will be no green arrow on the file icon.
• If the lock setting is mirror, the lock will propagate. On Microsoft Office 365, a green arrow will be present on the file icon indicating it is "checked-out" or locked.
• If the lock setting is mirror_owner, the lock will propagate and be under the ownership of the account mapped from the source.

Lock Propagation on NFS

DryvIQ can't unlock files on NFS, so locked files will get flagged. DryvIQ advises that you ignore these locks. When the files get checked back in, DryvIQ will migrate the file on the next job run. You also have the option of identifying the locked files through the flagged items and taking action on the file by either checking it in for the next job run or manually migrating it; however, these actions can result in an extensive flagged item report.

Example JSON

"lock_propagation" : "ignore"

Value Options: ignore (default), mirror_owner, mirror_lock

{
 "name":"Bundle X Lock Prop Ignore Test",
 "kind": "transfer",
 "transfer": {
     "audit_level": "trace",
     "lock_propagation": "ignore",
     "transfer_type": "copy",
     "source": {
       "connection": { "id": "{{cloud_connection_source}}" }
       ,
       "target":
       {"path":"/MASTER_TESTS/Lock Prop Tests"}
     },
     "destination": {
       "connection": { "id": "{{cloud_connection_destination}}" },
       "target": {
         "path": "/SAP/LB/Bundle X Lock Prop Ignore Tests"
       }
     }
 },
 "schedule": {
   "mode": "manual"
 }
}