Create a sync specification

A sync specification is a list of mappings, defining which files or folders need to be synchronized by the SHARE network.

To create a sync specification and add a folder mapping to it, follow these steps:
  1. Open SHARE > SYNC SPECIFICATION.
  2. Select Add syncspec.
  3. Specify a name for the sync specification and select the target site.
  4. Select Add.
  5. Hover over the sync specification and click to open the details
  6. Select Add mapping.
  7. Complete the following fields:
    1. File Mapping: here you can define a description for the files you want to map.
    2. Source Site: here you can define the source site. You can set the direction of a Share as either source -> destination (uni-directional) or source <-> destination (bi-directional).
    3. Source Folder: here you can enter the CLOUDFLOW URL of the source folder (for example cloudflow://PP_FILE_STORE/site_a/).
    4. Target Folder: here you can enter the CLOUDFLOW URL of the target folder (for example cloudflow://PP_FILE_STORE/site_b/)
    5. Filter: here you can define a filter if needed. The filter pattern is a Regular expressions.
      Note: You can use https://regex101.com as an online regex tester.
  8. Select Add.
  9. Hover over the syncspec to open it. Possibly you need to refresh the page before you can view the details.
  10. Select the Sync Mode. Options:
    • Bidirectional: if you select this option, changes from both source and target folders are synchronized.
    • Source → Target: if you select this option, only changes from the source site are synchronized. Changes at the target site are discarded.
    • Target → Source: if you select this option, only changes from the target site are synchronized. Changes at the source site are discarded.
    • Disabled: if you select this option, nothing is synchronized.
    • Propagate file deletions: if you select this checkbox, file deletions will also be propagated to the other site. This checkbox is only available if you selected Source → Target or Target → Source.

As a result, the mapped folders will now be kept in sync and any file modification is now synchronized. This means:

  • Each file modification in the file location in site_a, will be synced to site_b, and vice versa.
  • If a file is deleted in site_a, the file is also deleted in site_b, and vice versa.
  • If a new file appears in site_a, this file will also appear in site_b, and vice versa.
Remarks:
  • In case of a collision (for example if a file is edited simultaneously in both site_a and site_b), the source location always wins.
  • Deleted files are moved into a .Trash folder in the root of the File store to prevent accidental data loss. If desired, files in the .Trash folder that are older than a predefined number of days will be removed. See MAINTENANCE for more information.
  • With Remove you can delete a mapping or a sync specification. As a consequence, all files on the target site will be removed.