Sync

Provide sync access to cloud storage.

Introduction

Sync is a daemon for system admins to synchronize a file system with cloud storage continuously. Use sync to enable user and application access to any cloud storage.

Native Access
No change to user or application workflows. Sync works in the background to access cloud storage.

Automated Access
Sync local and remote changes automatically, even when network or storage systems are not available.

Flexible Access
Sync any configuration. Sync any folder to any folder, including overlapping folders across storage providers.

Features

Mapping

  • Any Cloud Storage
  • Any Folder to Any Folder
  • One Folder to Many Folders
  • Exclusions

Sync Rules

  • Bi-Direction Sync
  • One-Way Sync
  • Manual Sync
  • Scheduled Sync

Management

  • Progress Monitoring
  • Error Handling
  • Activity Logging

Retention

  • Trash Bin
  • Undelete
  • Conflict Detection
  • Storage Tiering

Performance

  • Offline Sync
  • Change Detection
  • Parallel Transfers
  • Move Detection
  • Rename Detection

Interface

  • Command-Line Interface
  • Shell Scripting
  • REST API
  • Sync Bading

Start Sync Daemon

Sync is a daemon. Start the sync daemon in the toolkit to enable sync.

$ ./startsync.sh 
Starting Sync Daemon
Started on port 27501
$
C:\toolkit\> startsync.bat
Starting Sync Daemon
Started on port 27501
C:\toolkit\>
$ ./startsync.sh 
Starting Sync Daemon
Started on port 27501
$

Start Sync Shell

Sync Shell (sync) is an interactive command-line interface for configuring and managing the Sync Daemon. Run sync in Sync Toolkit to start the interactive shell.

$ ./sync
sync>
C:\toolkit\> sync
sync>
$ ./sync
sync>

Mount Sync Folders

Use the mounts subcommand in sync shell to specify which folders to keep in sync with which cloud folder. Each mapping between a local and remote folder is called a sync mount. The remote folder is a path already connected with Explorer.

$ mkdir /Users/terrence/pictures
$ ./sync
sync> mounts add /Users/terrence/pictures /dropbox/mydropbox/photos hourly
Mount registered and activated.
sync>

Monitor Sync

Sync automatically uploads and downloads changes. To see current progress, run the monitor subcommand in the sync shell.

$ ./sync
sync> monitor
Refresh: 0 waiting, 1 active
Upload: 0 waiting, 0 active
Download: 3 waiting, 7 active
Pending: 0 refresh, 0 conflict, 0 upload, 0 download, 0 trash

11.png                          Downloading 22636 (10%)
1375060936145474.jpg            Downloading 20207 (90%)
Brave Frontier inf.xlsx         Downloading 516986 (51%)
CSharp_VFS_API_.doc             Downloading 89088 (45%)
Folder 2                        Downloading - (15%)
Case Folder 31                  Downloading - (0%)
python-2.7.14.msi               Downloading 19238912 (0%)
untitled folder                 Refreshing folder
Case Folder 32                  Waiting to download
Case Folder 33                  Waiting to download
Case Folder 34                  Waiting to download

Refresh Sync

Sync is automatic but not real-time. Use the refresh subcommand to find and sync changes in a folder.

$ ./sync
sync> refresh /dropbox/mydropbox/photos
Refresh requested. Use "monitor" command to see progress.
sync>

Manage Trash

Local files you delete are not deleted in the cloud until you're ready. Use the trash subcommand to recover or delete files.

$ rm /Users/terrence/pictures/file1.jpg
$ ./sync
sync> trash list
file1.jpg 835603 /Users/terrence/pictures/file1.jpg

Total: 1
sync> trash delete
Delete requested. Use "monitor" command to see activity.
$

API Access

Use the Sync REST API to configure and manage sync from your application. Please refer to the Sync API reference for available endpoints.