...
- Closing the browser window will not stop the Sync Tool. It will continue to run and transfer files.
- Getting back to the Sync Tool
- Once the Sync Tool is started, it will continue to run in the background, even if you close your browser. You can also get back to the UI by pointing your browser to: http://localhost:8888/sync (hint: bookmark this page).
- Selecting any of the shortcuts created by the installer will bring up the Sync Tool UI.
- Stopping the Sync Tool
- Within the UI there are options to stop and start the sync. This will allow you to stop syncing for a time, and start it up again later.
- Stopping the Sync Tool process
- If you would like to completely shut down the Sync Tool process, such that the UI is no longer available:
- On Windows: Look for a DuraCloud Sync icon in the task tray, right click on it, select Exit
- On Mac: Look for a DuraCloud Sync icon in the menu bar, right click on it, select Exit
- On Ubuntu: Look for a DuraCloud Sync icon in the task bar, right click on it, select Exit
- If you would like to completely shut down the Sync Tool process, such that the UI is no longer available:
- Work Directory
- The work directory is named duracloud-sync-work, and can be found under your home directory (C:\Users\[username] on Windows, /Users/[username] on Mac, /home/[username] on Linux)
- In the work directory you will find:
- A configuration file which includes the data you entered when configuring the tool
- A logs directory with log files containing runtime status information of the Sync Tool. These can be helpful when diagnosing a problem the tool may have had.
- Transfer Rate Optimization
- You may find after using the synctool that the transfer rate could be faster. The When performing a transfer of files to DuraCloud, the goal is often to get those files moved as quickly as possible. To assist with this the Sync Tool allows you to adjust the number of simultaneous transfers (a.k.a "threads") on the Configuration tab. One One caveat here is that the higher the number of threads, the more system resources will be consumed. Additionally Additionally as the number of simultaneous transfers increases, more more network bandwidth will be consumed. So what is the best number of threads? It It depends on the characteristics of your machine and the network to which it is attached. We've added a handy new feature that will automatically determine the optimal number of threads for your system. In the Tune the "Transfer Rate" section of the configuration page you'll notice an "Optimize Automatically" button. In the "Transfer Rate" section of the configuration page you'll notice an "Optimize Automatically" button. Click Click it to automatically discover and set the optimal number of threads.
- NB: Note that "optimal", in in this context, means the highest number of threads that can be used before transfer speeds level off. It is possible that your machine's local performance may suffer if you're using it for other compute intensive tasks such as photo or video editing. In this case, you can further fine tune your thread count by decreasing the number of using the thread count optimization tool manually until the performance of your other applications is satisfactory to you.will allow content to be transferred as quickly as possible.
- The determination of "optimal" thread count is based on testing actual timed transfers, which is why the test may take a while to run when resources such as upload bandwidth or CPU or memory capacity are constrained. This also means that the optimal thread count given will reflect the capability of the machine while the test is running. If other tasks on the machine are consuming significant system resources, this will affect the results of the test.
- If the machine being used for the transfer of content is not primarily dedicated to this one task (at least while the SyncTool is running), then you may want to set the thread count lower than the determined "optimal" setting. This will, of course, reduce the transfer rate, but would allow the machine to have capacity for other activities.
- Destination Prefix
Using the prefix option, the content IDs that are created for the files being moved to DuraCloud by the SyncTool can be made to begin with a consistent text value. There are several reasons this might be useful, such as to include the name of a top-level directory in the path, or to be able to run the Sync from a new sub-directory, but still maintain the full path included on all existing stored content. Suppose
Some users have a need to prefix their content IDs in order that the paths to the content appear in DuraCloud differently than what appears on the file system. Suppose the path to a local file (relative to found within the watch directory) is "dir1/file.txt" and the user you would like the resulting content stored in DuraCloud as to be 'a/b/c/dir1/file.txt. To To achieve that result, the a destination prefix of "a/b/c/" would need to be set.
Changing the destination prefix between synchronization runs when is enabled likely in duracloud in that space to be deleted and re-uploaded. Be cautious when enablingWarning
Command Line Interface
The Sync Tool provides a command line interface which can be executed directly, used in scripts, or used for scheduling sync activities (such as within a cron job.) The command line interface provides access to all feature of the Sync Tool, some of which are not available (yet) in the graphical interface.
...