The Sync Tool is a utility which was created in order to provide a simple way to move files from a local file system to DuraCloud and subsequently keep the files in DuraCloud synchronized with those on the local system.
Download the sync tool here from the Downloads page.
java -version |
java -jar synctool-{version}-driver.jar |
Short Option |
Long Option |
Argument Expected |
Required |
Description |
Default Value (if optional) |
---|---|---|---|---|---|
-h |
--host |
Yes |
Yes |
The host address of the DuraCloud DuraStore application |
|
-r |
--port |
Yes |
No |
The port of the DuraCloud DuraStore application |
443 |
-i |
--store-id |
Yes |
No |
The Store ID for the DuraCloud storage provider |
The primary storage provider is used |
-s |
--space-id |
Yes |
Yes |
The ID of the DuraCloud space where content will be stored |
|
-u |
--username |
Yes |
Yes |
The username necessary to perform writes to DuraStore |
|
-p |
--password |
Yes |
Yes |
The password necessary to perform writes to DuraStore |
|
-c |
--content-dirs |
Yes |
Yes |
A list of the directory paths to monitor and sync with DuraCloud. If multiple directories are included in this list, they should be separated by a space. |
|
-w |
--work-dir |
Yes |
Yes |
The state of the sync tool is persisted to this directory |
|
-f |
--poll-frequency |
Yes |
No |
The time (in ms) to wait between each poll of the sync-dirs |
10000 (10 seconds) |
-t |
--threads |
Yes |
No |
The number of threads in the pool used to manage file transfers |
3 |
-m |
--max-file-size |
Yes |
No |
The maximum size of a stored file in GB (value must be between 1 and 5), larger files will be split into pieces |
1 |
-d |
--sync-deletes |
No |
No |
Indicates that deletes performed on files within the content directories should also be performed on those files in DuraCloud; if this option is not included all deletes are ignored |
Not set |
-x |
--exit-on-completion |
No |
No |
Indicates that the sync tool should exit once it has completed a scan of the content directories and synced all files; if this option is included, the sync tool will not continue to monitor the content dirs |
Not set |
Short Option |
Long Option |
Argument Expected |
Required |
Description |
---|---|---|---|---|
-g |
--config-file |
Yes |
Yes |
Read configuration from this file (a file containing the most recently used configuration can be found in the work-dir, named synctool.config) |
java -jar synctool-{version}-driver.jar -w C:\tools\synctool\backup -c C:\files\important -f 2000 -h test.duracloud.org -s important-dir-backup -t 5 -u myname -w mypassword |
Short Command |
Long Command |
Description |
---|---|---|
x |
exit |
Tells the Sync Tool to end its activity and close |
c |
config |
Prints the configuration of the Sync Tool (the same information is printed at startup) |
s |
status |
Prints the current status of the Sync Tool |
l <Level> |
N/A |
Changes the log level to <Level> (may be any of DEBUG, INFO, WARN, ERROR) |
h |
help |
Prints the runtime command help |