SyncBreeze File Synchronization
SyncBreeze File Synchronization
Flexense Ltd.
SyncBreeze
File Synchronization
User Manual
Version 5.4
Jul 2013
Flexense Ltd.
1 2 3
SyncBreeze Overview..........................................................................................3 SyncBreeze Product Versions..............................................................................4 Using Desktop Product Version ...........................................................................5 3.1 3.2 3.3 3.4 3.5 3.6 3.7 3.8 3.9 3.10 3.11 3.12 3.13 3.14 3.15 3.16 3.17 3.18 3.19 3.20 3.21 3.22 3.23 3.24 3.25 3.26 3.27 3.28 3.29 3.30 Synchronizing Disks or Directories........................................................................5 Selecting the Right File Synchronization Mode........................................................6 Synchronizing Specific File Types or Categories......................................................7 Synchronizing Disks or Directories without Preview.................................................7 Periodic Execution of File Synchronization Commands .............................................8 Using the System Tray Icon.................................................................................8 Background File Synchronization Commands .........................................................9 Real-Time File Synchronization ............................................................................9 Bit-Level File Synchronization ............................................................................ 10 Synchronizing Network Shares Using UNC Path Names ......................................... 11 File Synchronization Performance Tuning Options ................................................. 11 Synchronizing With Tertiary Destination Directories .............................................. 12 Synchronizing Multiple Directory Pairs................................................................. 12 Executing Sync Commands Using Desktop Shortcuts ............................................ 13 Executing Sync Commands Using Keyboard Shortcuts .......................................... 13 Excluding Subdirectories from File Synchronization............................................... 14 Excluding Specific Files or File Types................................................................... 15 Recoverable File Synchronization Operations ....................................................... 16 Advanced File Synchronization Options ............................................................... 17 Mapping Network Drives.................................................................................... 17 Managing File Synchronization Commands........................................................... 18 Sound Notifications........................................................................................... 19 Customizing SyncBreeze GUI application ............................................................. 20 Using SyncBreeze GUI Layouts .......................................................................... 21 Using SyncBreeze Command Line Utility.............................................................. 22 SyncBreeze Product Installation Procedure .......................................................... 24 SyncBreeze Product Update Procedure ................................................................ 25 SyncBreeze Product Registration Procedure ......................................................... 26 Supported Operating Systems............................................................................ 26 SyncBreeze System Requirements...................................................................... 26
Using SyncBreeze Server ..................................................................................27 4.1 4.2 4.3 4.4 4.5 4.6 4.7 4.8 4.9 4.10 4.11 4.12 4.13 4.14 4.15 4.16 4.17 4.18 4.19 4.20 4.21 4.22 4.23 4.24 4.25 4.26 SyncBreeze Server Overview ............................................................................. 27 Installing SyncBreeze Server ............................................................................. 28 SyncBreeze Client Application ............................................................................ 29 Web-Based Management Interface ..................................................................... 30 Managing File Synchronization Commands........................................................... 31 Selecting File Synchronization Modes .................................................................. 32 Advanced File Synchronization Options ............................................................... 33 Synchronizing Specific File Types or File Categories .............................................. 34 Excluding Directories or Files From the Synchronization Process............................. 35 File Synchronization Commands History .............................................................. 36 Using SyncBreeze Server to Sync Network Shares ................................................ 37 Synchronizing Running Databases ...................................................................... 38 Sending Error E-Mail Notifications....................................................................... 39 Sending Sync Commands Status Notifications ...................................................... 40 Viewing File Synchronization Statistics ................................................................ 41 Sending Status Reports to an E-Mail Address ....................................................... 42 Configuring SyncBreeze Server .......................................................................... 43 Configuring Custom User Name and Password ..................................................... 43 Configuring Custom Server Ports........................................................................ 44 Configuring Advanced Server Options ................................................................. 44 SyncBreeze Server Command Line Utility ............................................................ 45 Updating SyncBreeze Server.............................................................................. 47 Registering SyncBreeze Server .......................................................................... 48 SyncBreeze Server OEM Version......................................................................... 49 SyncBreeze Server Supported Operating Systems ................................................ 50 SyncBreeze Server System Requirements ........................................................... 50
Flexense Ltd.
1 SyncBreeze Overview
SyncBreeze is a powerful, easy-to-use and fast file synchronization solution allowing one to synchronize files between disks, directories, network shares and NAS storage devices. Users are provided with four different product versions freeware, pro, ultimate and server designed for home users, power users, IT professionals and enterprises respectively.
SyncBreeze provides multiple one-way and two-way file synchronization modes, periodic file synchronization, compressed file synchronization, background file synchronization, real-time file synchronization, an option to synchronize specific types of files, user-selectable GUI layouts and allows one to define multiple customizable file synchronization commands making it very simple to synchronize numerous directories, disks or NAS storage devices.
In addition, IT professionals are provided with SyncBreeze Server a server-based product version, which runs in the background as a service and may be controlled through the network using a regular web browser, a client GUI application or a command line utility. SyncBreeze Server allows one to execute multiple, simultaneous file synchronization operations, adds fault-tolerant file synchronization modes and advanced error handling options and allows one to send E-Mail notifications for failed file synchronization operations.
Flexense Ltd.
Flexense Ltd.
In the simplest case, in order to synchronize two disks or directories, press the 'Sync' button located in the top-left corner of the main toolbar, enter the source and destination directories and press the 'Sync' button. SyncBreeze will scan the specified source and destination directories and show a preview dialog with a list of files that should be synchronized.
The synchronization preview dialog shows all files that should be synchronized and allows one to manually select/unselect specific file synchronization actions. In order to see more information about a file synchronization action, select the action item, press the right mouse button and select the 'Action Properties' menu item. Once finished selecting all the actions that should be executed, press the 'Sync' button located in the bottom-right corner of the preview dialog.
During the file synchronization process, SyncBreeze will display a synchronization process dialog showing the total number of synchronized files, the amount of synchronized storage space, the performance of the file synchronization process and the process time. Press the 'Pause' button to temporarily suspend the file synchronization operation. Press the 'Continue' button to resume a previously paused file synchronization operation. In order to cancel the currently running file synchronization operation, press the 'Stop' button. Once the file synchronization operation is finished, SyncBreeze will show a confirmation message informing about the status of the completed file synchronization operation. By default, SyncBreeze will try to perform as many file synchronization actions as possible without interrupting the operation on non-fatal errors. In the case that any errors will occur during the file synchronization operation, SyncBreeze will show an appropriate error message and enable the 'Errors' button allowing the user to access the error log.
Flexense Ltd.
3.2
Depending on specific needs, it may be required to perform different types of file synchronization operations. For example, sometimes users may be interested in keeping all files in the destination directory even when some of them were deleted from the source directory. Another option is to perform two-way accumulation and update keeping both directories completely identical. SyncBreeze provides five different one-way and two-way file synchronization modes allowing one to perform different types of file synchronization operations according to user-specific needs and requirements.
In order to change the file synchronization mode for a file synchronization command, open the file synchronization command dialog, select the 'General' tab and select one of the following file synchronization modes: Synchronize Destination Directory (one-way) - All changes made in the source directory will be propagated to the destination directory. Files deleted from the source directory will be deleted from the destination directory. All files changed or deleted in the destination directory will be restored using files from the source directory. No changes will be made in the source directory. After the file synchronization process is complete both locations will be identical. Update Destination Directory (one-way) - Newly created and modified source files will be copied to the destination directory. Files deleted from the source directory will be deleted from the destination directory. Files deleted from the destination directory will be restored using files from the source directory. Newly created and modified destination files will be kept in place. No changes will be made in the source directory. Accumulate and Update Files in Destination (one-way) - Newly created and modified source files will be copied to the destination directory. Files deleted from the destination directory will be restored using files from the source directory. Newly created and modified destination files will be kept in place. No files will be deleted from the destination directory. No changes will be made in the source directory. Two-Way File Synchronization - Newly created and modified files will be synchronized in both directions. Files deleted from the source directory will be deleted from the destination directory. Files deleted from the destination directory will be restored from the source directory. Changes may be made in both locations. After the file synchronization process is complete both locations will be identical. Two-Way Stateful File Synchronization - Newly created and modified files will be synchronized in both directions. Files deleted from the source directory will be deleted from the destination directory. Files deleted from the destination directory will be deleted from the source directory. Changes may be made in both locations. After the file synchronization process is complete both locations will be identical. Two-Way Accumulation and Update - Newly created and modified files will be updated in both directions. Files deleted from one location will be restored from the second location. Changes may be made in both locations. After the file synchronization process is complete both locations will be identical.
Flexense Ltd.
3.3
SyncBreeze Pro provides power computer users with the ability to synchronize specific file types or file categories using one or more flexible file matching rules. For example, the user may specify to synchronize documents and digital images with the file size more than 2 MB.
In order to add one or more file matching rules, open the file synchronization command dialog, select the 'Rules' tab and press the 'Add' button. On the 'Rules' dialog select an appropriate rule type and specify all the required parameters. During the file synchronization process, SyncBreeze Pro will scan the entered source and destination directories and apply the specified file matching rules to all the existing files. Files not matching the specified rules will be skipped from the file synchronization process effectively limiting the operation to user-selected files only.
3.4
File synchronization with preview is very useful providing the user with a clear picture about what files will be synchronized. On the other hand, file synchronization with preview may be ineffective or completely inappropriate when there is a need to synchronize large directories or whole disks containing many thousands of files, especially due to the fact that none will have the time to review lists of file synchronization actions containing thousands of items.
SyncBreeze Pro provides an additional file synchronization mode, named the stream file synchronization mode, which performs file synchronization on-the-fly without showing the preview dialog. The stream file synchronization more is especially designed for file systems containing huge amounts of files and is capable of synchronizing large directories, disks and NAS storage devices very fast and effectively. Finally, the stream file synchronization mode is ideal for automated, periodic file synchronization operations performed in the background without any user intervention.
Flexense Ltd.
3.5
Another advanced option provided by SyncBreeze Pro is the ability to execute file synchronization commands periodically at user-specified time intervals. In addition, SyncBreeze Pro allows one to schedule daily or weekly sync operations to be performed at a specified time of the day. The major reason to execute a file synchronization command periodically is to continuously keep a frequently changing directory synchronized with a backup directory located on an external USB disk or a NAS storage device.
In order to enable periodic file synchronization for a sync command, open the command dialog, select the 'Advanced' tab, specify the time period to execute the file synchronization command in and press the 'Save' button. For all periodic file synchronization commands, SyncBreeze Pro displays the time remaining to the next synchronization. After each elapse of the specified time period, SyncBreeze Pro will start the file synchronization command in the background and mark it as 'Active' in the status field. In order to open a synchronization process dialog for an active command, click on the command item in the commands view. After finishing a periodic file synchronization command, SyncBreeze Pro will reset the command's timer to the specified time period.
3.6
Background file synchronization operations are especially useful when configured to automatically synchronize one or more directories at specific time intervals. Another feature that greatly complements the background file synchronization capabilities is the ability to minimize the main GUI application to the system tray while allowing one to execute background file synchronization commands using the system tray icon's context menu.
In order to enable the system tray icon, which is available in SyncBreeze Pro+, open the advanced options dialog and select the 'Minimize to System Tray' option. With this option enabled, the SyncBreeze main GUI application will minimize itself into the system tray and allow one to execute background file synchronization commands using the system tray icon's context menu. A minimized application may be shown at any time by clicking on the system tray icon. Another option is to click the right mouse button over the system tray icon and to select the 'Show Sync Breeze' menu item. In order to execute a file synchronization command in the background, click the right mouse button over the system tray icon and select a command item in the 'Commands' context menu. Finally, in order to close the SyncBreeze application, select the 'Quit' menu item.
Flexense Ltd.
3.7
By default, when the user clicks on a sync command item, SyncBreeze starts the selected file synchronization command and executes it in the foreground. Another option provided by SyncBreeze Pro is to execute one or more file synchronization commands in the background. The main reason to execute sync commands in the background is to synchronize multiple disks or directories simultaneously thus reducing the total time required to synchronize multiple directories. In order to synchronize multiple directories in the background, select all the required sync commands in the command list, press the right mouse button and select the 'Start Background Sync' menu item. SyncBreeze Pro will start all the selected sync commands in the background and mark them as 'Active' in the status field. In order to open a synchronization process dialog for an active command, click on the command item in the commands view. The process dialog allows one to pause, resume or stop any background file synchronization operation. In addition, the user is provided with the ability to dynamically control the speed of any file synchronization operation. In order to change the speed of a running file synchronization command, just set an appropriate performance mode in the 'Speed' combo box located on the file synchronization process dialog.
3.8
In addition to the standard file synchronization features available in the freeware product version, SyncBreeze Ultimate and SyncBreeze Server provide the user with advanced realtime file synchronization capabilities allowing one to monitor the source and/or destination directories and execute the file synchronization command after detecting a user-specified number of changes.
The real-time file synchronization capabilities are especially useful when the amount of file system changes is not even over time with sudden spikes of file system changes followed by periods of a low activity. In such a situation, it will be wasteful to frequently perform periodic file synchronization if nothing has changed, but on the other hand, if someone suddenly changes a large number of files, these changes should be synchronized as soon as possible. The most balanced approach for such situations is a combination of periodic file synchronization with real-time disk change monitoring configured to execute the file synchronization command after a user-specified number of changes. In this way, if the amount of file system changes is below the threshold defined in the real-time disk change monitor, the timer will execute the file synchronization command according to the scheduled time interval. On the other hand, if there are too many changes, the disk change monitor will execute the file synchronization command before the scheduled time. In order to enable the real-time disk change monitor for a file synchronization command, open the command, select the 'Advanced' tab and select the 'Monitor Changes In' checkbox. SyncBreeze allows one to monitor the source directory, the destination directory or both directories simultaneously. Enter an appropriate number of changes that should trigger the file synchronization command and press the 'Save' button.
Flexense Ltd.
3.9
SyncBreeze Ultimate and SyncBreeze Server provide bit-level file synchronization capabilities allowing one to synchronize only changed file system clusters in each file thus minimizing the amount of disk write operations and extending the life of SSD disks.
In order to enable bit-level file synchronization for a file synchronization command, open the sync command dialog, select the 'Options' tab and enable the 'Bit-Level File Synchronization' option. When this option is enabled, for each changed file, SyncBreeze will synchronize changed file system clusters only.
For example, let's assume we have a large 45MB Microsoft Word document file. When bit-level file synchronization is disabled, SyncBreeze will copy the whole file each time the file is modified. On the other hand, with the bit-level file synchronization option enabled, SyncBreeze will update changed file system clusters only thus significantly reducing the amount of data written to the disk and extending the life of SSD disks.
10
Flexense Ltd.
While working with UNC path names, please take into account that in order to be able to synchronize files on network shares and/or NAS storage devices, the user should have directory access and file write permissions for each specific network share and/or NAS storage device. If the user will not have directory access or file write permissions, the file synchronization operation will fail with one or more error messages reporting about access denied errors.
In order to enable multi-stream file synchronization for a sync command, open the command dialog, select the 'Advanced' tab and set an appropriate number of file synchronization streams. Take into account that multi-stream file synchronization is optimized for multi-disk, RAID and networked configurations and it is not recommended to use it when synchronizing directories located on the same physical disk. In addition, users required to synchronize files on running, production systems are provided with the ability to execute file synchronization commands slowly thus minimizing the performance impact on running applications. In order to change the speed of a file synchronization command, open the command dialog, select the 'Advanced' tab and select an appropriate performance mode in the 'Speed' combo box.
11
Flexense Ltd.
SyncBreeze Ultimate allows one to define a tertiary destination directory for any file synchronization command. In order to configure a tertiary destination directory, open the command dialog, select the 'General' tab, select the 'Extended' configuration mode and specify a tertiary destination directory. During runtime, SyncBreeze will first synchronize the source directory with the first destination directory and after that with the tertiary destination directory.
For each directory pair, the user is provided with the ability to specify a source directory, a destination directory, an optional tertiary destination directory and the file synchronization mode that should be used for this specific directory pair. During runtime, SyncBreeze will synchronize all directory pair sequentially, one after one, in the same order as the directory pair were defined in the command dialog. In order to change the order of the specified directory pairs, select a directory pair item, press the right mouse button and select the 'Move Up' or 'Move Down' menu item.
12
Flexense Ltd.
Now, just click on the command's desktop shortcut to execute the associated file synchronization command. SyncBreeze will open the associated file synchronization command, scan the specified source and destination directories and show the file synchronization preview dialog. Moreover, by using multiple desktop shortcuts the user is provided with the ability to easily execute multiple, simultaneous file synchronization commands.
On the shortcut dialog, enter a custom key sequence and press the 'Ok' button. Now, just type the selected key sequence and SyncBreeze will start the associated file synchronization command. In addition to the keyboard shortcuts for file synchronization commands, SyncBreeze provides the user with the ability to customize all pre-defined functional keyboard shortcuts. In order to customize per-defined keyboard shortcuts, select the 'Tools - Advanced Options' menu item to open the options dialog and select the 'Shortcuts' tab.
13
Flexense Ltd.
In order to add one or more directories to the exclude list, open the file synchronization command dialog, select the 'Exclude' tab and press the 'Add' button. All files and subdirectories located in the specified exclude directory will be excluded from the file synchronization process. In addition, advanced users are provided with a number of exclude directories macro commands allowing one to exclude multiple directories using a single macro command. SyncBreeze provides the following exclude directories macro commands: $BEGINS <Text String> - this macro command excludes all directories beginning with the specified text string. $CONTAINS <Text String> - this macro command excludes all directories containing the specified text string. $ENDS <Text String> - this macro command excludes all directories ending with the specified text string. $REGEX <Regular Expression> - this macro command excludes directories matching the specified regular expression.
For example, the exclude macro command '$CONTAINS Temporary Files' will exclude all directories with 'Temporary Files' at any place in the full directory path and the exclude macro command '$REGEX \.(TMP|TEMP)$' will exclude directories ending with '.TMP' or '.TEMP'.
14
Flexense Ltd.
For example, in order to exclude all types of image files from the file synchronization process, open the file synchronization command dialog, select the 'Rules' tab and add a rule to match files 'Not Categorized As Images, Pictures and Graphic Files'. Multiple types of file matching rules excluding files by the category, file name, file size, extension, etc. may be added to any file synchronization operation allowing one to effectively exclude specific files or file categories.
For example, in order to exclude all system and hidden files with the text pattern 'SYNCBREEZE' in the file name, add the following two file matching rules: the first one to exclude files by a text pattern in the file name and the second one to exclude files by file attributes. During the file synchronization process, SyncBreeze will check all files that should be synchronized and exclude files according to the specified file matching rules.
15
Flexense Ltd.
With this option enabled, SyncBreeze will calculate the SHA256 file signature for each source file, reread each destination file after copy and compare the source and destination files signatures. Now, select the 'Advanced' tab, press the performance 'Options' button and enter an appropriate number of file copy retries and a retry delay (in milliseconds).
When a file copy operation will fail due to a disk I/O error, network error or the source and destination SHA256 file signatures will not match, SyncBreeze will retry the file copy operation the specified number of times while adding the specified delay before each retry.
16
Flexense Ltd.
By default, SyncBreeze will try to map network shares using the current user account. In order to map a network drive using another user account, specify a custom user name and password to connect the network drive with.
17
Flexense Ltd.
Now, the newly created file synchronization command may be easily executed at any time just by clicking on the command item in the commands view. For each file synchronization command, SyncBreeze shows the command name, the last synchronization time, the total number of files and the amount of data in the source and destination directories and the status trend showing how the amount of data is changing over time. In order to edit a file synchronization command, select the command item in the commands view, press the right mouse button and select the 'Edit Command' menu item. Select one or more file synchronization commands, press the right mouse button and select the 'Delete Commands' menu item to delete all the selected file synchronization commands. All the user-defined file synchronization commands are stored in the user-specific product configuration file, which may be exported for backup purposes and later used to restore the product configuration on the same or another computer. In order to export the user-specific product configuration to a file, select the menu 'File - Export Configuration' and specify a file name to export the product configuration to. Select the menu 'File - Import Configuration' to import a previously exported product configuration file.
18
Flexense Ltd.
In order to open the 'Notification Sounds' dialog, select the 'Tools - Notification Sounds' menu item. The 'Notifications Sounds' dialog shows all the available sound notifications and allows one to enable or disable specific sound notifications.
In order to select a custom notification sound file, click on a notification sound item in the sounds list and select a custom WAV file. In order to play a notification sound, select the required notification sound in the sounds list and press the 'Play' button.
19
Flexense Ltd.
The 'General' tab allows one to control the following options: Show Main Toolbar - Enables/Disables the main toolbar Automatically Check For Product Updates - select this option to instruct SyncBreeze to automatically check for available product updates. Show Scanning Access Denied Errors - select this option to see error messages when SyncBreeze is prevented to scan files in a directory Process System Files - select this option to synchronize system files. Abort Operation On Critical Errors - by default SyncBreeze is trying to process as many files as possible logging non-fatal errors in a process log. Select this option to instruct SyncBreeze to abort operation when encountering a critical error.
The 'Shortcuts' tab provides the user with the ability to customize keyboard shortcuts. Click on a shortcut item to edit the currently assigned key sequence. Press the 'Default Shortcuts' button to reset all keyboard shortcuts to default values.
The 'Proxy' tab provides the user with the ability to configure the HTTP proxy settings. SyncBreeze uses the HTTP protocol in order to inquire whether there is a new product version available on the web site. By default, SyncBreeze detects proxy settings and connects to the Internet directly or through an HTTP proxy depending on the configuration of the host computer. Depending on a specific host and network configuration, the user is provided with the ability to connect to the Internet directly, trough automatic HTTP proxy discovery or manually by entering the HTTP proxy server name and port
20
Flexense Ltd.
The first (default) GUI layout displays large toolbar buttons with descriptive text labels under each button and uses large icons to show user-defined file synchronization commands in the commands view.
The second GUI layout displays small toolbar buttons with descriptive text labels beside each button and uses small icons to show user-defined file synchronization commands in the commands view.
The third GUI layout displays small toolbar buttons without descriptive text labels, uses small icons to show user-defined file synchronization commands and shows the command name only for each command in the commands view.
21
Flexense Ltd.
22
Flexense Ltd.
STA - Sets the two-way accumulate file synchronization mode Newly created and modified files will be updated in both directions. Files deleted in one location will be restored from the second location. After finishing the synchronization process both locations will be identical. -perf <FULL | MEDIUM | LOW> FULL - Full-speed file synchronization MEDIUM - Medium-speed file synchronization LOW - Low-speed file synchronization -streams <1 ... 16> Specifies the number of parallel file synchronization streams. -DACL Instructs to copy files' access control lists (DACL). -SACL Instructs to copy files' security control lists (SACL). -OWNER Instructs to copy files' user/group information. -v Shows the product major version, minor version, revision and build date. -help This command shows the command line usage information.
23
Flexense Ltd.
SyncBreeze is especially designed to be as simple as possible. The installation procedure is very simple, requires no special knowledge and may be completed in less than 30 seconds. There is no need for any additional software. Just download the SyncBreeze installation package, run the setup program and you are done.
On the 'Welcome' screen press the 'Next' button. Read the end-user license agreement and press the 'I Agree' button if you agree with the license terms or the 'Cancel' button to stop the installation process. Select the destination directory, press the 'Install' button and wait for the installation process to complete. That's all you need to do to install the SyncBreeze file synchronization utility on your computer.
24
Flexense Ltd.
In order to manually verify that the currently installed product version is up-to-date, select menu 'Help - Check For Updates' on the main menu bar. The update manager will connect to the update server and check if there is a newer version of the product available for download.
If there is a new product version available, the update dialog will show the version of the new product update and two links: the 'Release Notes' link and the 'Install' link. Click on the 'Release Notes' link to see more information about new features and bug-fixes provided by this specific product version. Click on the 'Install' link to download and install the new product version.
After clicking on the 'Install' link, please wait while the update manager will download the new product version to the local disk. The update package will be downloaded to a temporary directory on the system drive and automatically deleted after the update manager will finish updating the product. After download is completed, close all open SyncBreeze applications and press the 'Ok' button when ready. If one or more SyncBreeze applications will be open during the update, the operation will fail and the whole update process will need to be restarted from the beginning. After finishing the update process, SyncBreeze will show a message box informing about the successfully completed operation.
25
Flexense Ltd.
After you will receive your unlock key, start the SyncBreeze GUI application and press the 'Register' button located in the top-right corner of the window. On the register dialog, enter your name and the received unlock key and press the 'Register' button to finish the registration procedure.
Minimal System Configuration Supported Operating System 500 MHz or better CPU 256 MB of system memory 25 MB of free disk space
Recommended System Configuration Supported Operating System 2 GHz or better CPU 512 MB of system memory 25 MB of free disk space
26
Flexense Ltd.
SyncBreeze Server is a dedicated file synchronization server, which runs in the background as a service and is capable of synchronizing disks, directories, network shares and NAS storage devices in a fully automatic, unattended mode. The SyncBreeze server provides the ability to define multiple file synchronization commands, periodically execute one or more file synchronization commands at specific time intervals and/or monitor the source and destination directories and automatically synchronize files and directories when a user-defined number of changes detected.
The file sync server may be controlled through the network using a regular web browser, a client GUI application or the SyncBreeze command line utility, which is included in the SyncBreeze Server installation. The GUI interface provided by the SyncBreeze client application is almost identical to the desktop SyncBreeze GUI application making it very simple to manage and control file synchronization commands. In order to connect to the sync server, start the SyncBreeze Client application, press the 'Connect' button located on the main toolbar and specify the host name (or IP address) of the server to connect to and enter a SyncBreeze user name and password (the default user name and password admin/admin).
Another way to control the sync server is to use the SyncBreeze command line utility, which is located in the '\bin' directory. The SyncBreeze command line utility allows one to start, pause, resume and stop file synchronization commands, view the status of running file synchronization operations and configure the SyncBreeze Server user name, password and port number. For detailed information about all the available command line options execute the following command: 'syncbreeze help'.
27
Flexense Ltd.
4.2
SyncBreeze Server is especially designed to be as simple as possible. The product does not require any third-party software applications and may be installed and configured within a couple of minutes. A fully functional 30-days trial version of SyncBreeze Server may be downloaded from the following page: http://www.syncbreeze.com/downloads.html.
The installation package is very small, 4MB - 5MB depending on the target operating system, and the product requires just 20MB of the free disk space on the target server. In order to install SyncBreeze Server, start the setup program, select a destination directory and press the 'Next' button.
Optionally, enter custom server control and/or web access ports. The server control port is used by the SyncBreeze client GUI application and the command line utility to connect to SyncBreeze Server. The web access port is the port for the web-based management interface allowing one to control SyncBreeze Server using a standard web browser from any computer on the network. If SyncBreeze Server should be controlled remotely through the network, make sure one or both of these ports are open in the server's firewall.
28
Flexense Ltd.
4.3
SyncBreeze Server provides a client GUI application, which is capable of controlling one or more SyncBreeze Servers locally or through the network. The client GUI application allows one to configure file synchronization commands, setup periodic file synchronization operations, control execution of file synchronization commands, setup error logs and E-Mail notifications, configure advanced server options, etc.
In order to connect to a remote SyncBreeze server through the network, press the 'Connect' button located on the main toolbar, enter the host name (or an IP address) of the server to connect to, enter the SyncBreeze user name and password (default is admin/admin) and press the 'Connect' button.
When connected to a SyncBreeze server, the client application displays file synchronization commands configured on the server and allows one to start file synchronization operations, add, edit, delete file synchronization commands and manage advanced server options. In order to add a new file synchronization command, press the 'Add' button located on the main toolbar, specify a unique command name, enter the source and destination directories to synchronize and press the 'Save' button. Now, in order to start the file synchronization command, select the command item, press the right mouse button and select the 'Start Command' menu item. The file synchronization command will be executed on the SyncBreeze server while the file synchronization status dialog will be displayed in the client GUI application, which can be connected to the server remotely through the network.
29
Flexense Ltd.
4.4
SyncBreeze Server provides a complete web-based management interface allowing one to control, configure and manage one or more SyncBreeze Servers using a regular web browser from any computer on the network.
In order to enable the web-based management interface on a SyncBreeze Server, connect to the server using the SyncBreeze client GUI application, open the 'Options' dialog, select the 'Server' tab, enable the 'Web Server' option and press the 'Save' button. By default, the SyncBreeze web server uses the TCP/IP port 80, which is a standard port used by web browsers to connect to web servers. Sometimes, the standard web access port may be in use by other applications or services installed on the server preventing the SyncBreeze web interface to operate properly. In this case, the user needs to change the web access port number and then, in order to connect to the custom port, type in the web browser address bar: http://server-name:port-number.
The SyncBreeze Server web-based interface is a dynamic web application, which automatically updates the status and progress of active file synchronization operations, and in order to operate properly, the web based interface requires JavaScript to be enabled in the web browser.
30
Flexense Ltd.
4.5
SyncBreeze Server provides the ability to setup a number of file synchronization commands with each one configured to synchronize files between a pair of source and destination disks, directories or network shares. The SyncBreeze Server home page shows the configured file synchronization commands and allows one to add, start, stop and delete file sync commands and configure advanced file synchronization options.
In order to add a new file synchronization command, press the 'Add Command' button located on the SyncBreeze Server home page, enter a unique command name, specify a source and destination directories to synchronize, select an appropriate file synchronization mode and press the 'Save' button.
The newly created file synchronization command will be displayed on the SyncBreeze Server home page and in order to start the file sync command manually, click on the command's 'Start' button located in the 'Tools' column. SyncBreeze Server provides a large set of advanced file synchronization options allowing one to customize any file synchronization command for user-specific needs and requirements. In order to customize advanced file synchronization options, click the 'Edit Command' button located in the 'Tools' column.
31
Flexense Ltd.
4.6
SyncBreeze Server provides a number of different one-way and two-way file synchronization modes allowing one to perform different types of file synchronization operations depending on user-specific needs and requirements.
In order to change the file synchronization mode for a file synchronization command, open the file synchronization command configuration page and select one of the following file synchronization modes: Synchronize Destination Directory (one-way) - All changes made in the source directory will be propagated to the destination directory. Files deleted from the source directory will be deleted from the destination directory. All files changed or deleted in the destination directory will be restored using files from the source directory. No changes will be made in the source directory. After the file synchronization process is complete both locations will be identical. Update Destination Directory (one-way) - Newly created and modified source files will be copied to the destination directory. Files deleted from the source directory will be deleted from the destination directory. Files deleted from the destination directory will be restored using files from the source directory. Newly created and modified destination files will be kept in place. No changes will be made in the source directory. Accumulate and Update Files in Destination (one-way) - Newly created and modified source files will be copied to the destination directory. Files deleted from the destination directory will be restored using files from the source directory. Newly created and modified destination files will be kept in place. No files will be deleted from the destination directory. No changes will be made in the source directory. Two-Way File Synchronization - Newly created and modified files will be synchronized in both directions. Files deleted from the source directory will be deleted from the destination directory. Files deleted from the destination directory will be restored from the source directory. Changes may be made in both locations. After the file synchronization process is complete both locations will be identical. Two-Way Stateful File Synchronization - Newly created and modified files will be synchronized in both directions. Files deleted from the source directory will be deleted from the destination directory. Files deleted from the destination directory will be deleted from the source directory. Changes may be made in both locations. After the file synchronization process is complete both locations will be identical. Two-Way Accumulation and Update - Newly created and modified files will be updated in both directions. Files deleted from one location will be restored from the second location. Changes may be made in both locations. After the file synchronization process is complete both locations will be identical.
32
Flexense Ltd.
4.7
SyncBreeze Server provides the ability to schedule periodic file synchronization operations. In order to configure a file synchronization command to be executed periodically, open the command configuration page, press the 'Advanced' button, enable the 'Periodic Sync' option and specify an appropriate time interval. Another option is configure a file synchronization command to be executed an a specific time of the day.
In addition to periodic file synchronization operations, SyncBreeze Server provides the ability to monitor the source and/or destination directories and automatically trigger a file synchronization operation when a user-specified number of changes detected. In order to enable the real-time disk change monitor for a file synchronization command, open the command configuration page, press the 'Advanced' button, enable the 'Monitor Changes' option and specify the number of changes that should trigger the file sync command.
SyncBreeze Server provides a rich set of advanced file synchronization options such as file security attributes synchronization, bit-level file synchronization, file copy verification, etc. In order to configure the advanced file synchronization options, open the file synchronization command configuration page and press the 'Options' button.
33
Flexense Ltd.
4.8
Sometimes, it may be required to synchronize specific file types or file categories according to user-specific needs and requirements. SyncBreeze Server provides an extensive set of file matching rules allowing one to sync files by the file type, category, size, name, extension, file attributes, location, user name, etc.
In order to add one or more file matching rules to a file synchronization command, open the command configuration page, press the 'Rules' button and press the 'Add Rule' button. On the 'Add Rule' page, select an appropriate rule type, enter all the required parameters and press the 'Add' button.
SyncBreeze Server provides the ability to add an unlimited number of file matching rules for each file synchronization command. During runtime, SyncBreeze Server will apply the specified rules to the processed files and synchronize files matching the rules. Files not matching the specified rules, will be just skipped from the file synchronization process.
34
Flexense Ltd.
4.9
SyncBreeze Server allows one to exclude directories or files from the file synchronization process. In the simplest case, in order to exclude a subdirectory from a file synchronization command, open the file synchronization command configuration page, press the 'Exclude' button and add one or more subdirectories to the exclude list.
During the file synchronization process, SyncBreeze will skip all directories specified in the exclude list including all subdirectories and files located in these directories. Another option is to exclude files using negative file matching rules. For example, in order to exclude all temporary files with the 'TMP' or 'TEMP' file extensions, add a file matching rule configured to match files with extensions different from 'TMP' and 'TEMP'.
In order to add one or more exclude file matching rules, open the file synchronization command configuration page, press the 'Rules' button, select an appropriate rule type, select a negative file matching operator and specify all the required parameters.
35
Flexense Ltd.
The file synchronization history page shows the total number of file synchronization operations for the sync command, the total number of synchronized files, the total amount of synchronized disk space and the total number of file synchronization errors. In addition, a sync history page shows a history of last X file sync operations according to the number of history sync tasks configured on the 'Advanced Server Options' page.
In order to change the number of history file synchronization tasks kept for each file sync command, open the 'Advanced Server Options' page and set the 'Command History Tasks' option to an appropriate value.
36
Flexense Ltd.
The configuration is very simple and may be performed within a couple of seconds using the following step-by-step guide: 1. 2. 3. 4. 5. Open the Windows control panel and click on the 'Administrative Tools' utility. Open the Services control center and find here the 'Sync Breeze Server' service. Open the 'Sync Breeze Server' service, select the 'General' tab and stop the service. Select the 'Log On' tab and specify a user account to use for the service. Select the 'General' tab and start the 'Sync Breeze Server' service.
IMPORTANT: SyncBreeze Server is a regular Windows service and therefore it has a separate space of mapped network drive letters. Mapped network drive letters visible in a desktop login session are not accessible to the SyncBreeze service and in order to synchronize network shares, the user needs to use UNC path names (\\server\share) or mount network drive letters using the SyncBreeze client GUI application.
Now, the SyncBreeze file synchronization server will run under the specified user account and will have exactly the same permissions as the specified account when accessing network shares and NAS storage devices.
37
Flexense Ltd.
SyncBreeze Ultimate and SyncBreeze Server provide the ability to configure pre-sync and post-sync actions for any file synchronization operation allowing one to stop a database before the sync operation is started and restart the database again when the sync operation is completed. For example, in order to safely backup Microsoft SQL server data files, set the pre-sync action and the post-sync action as follows: Pre-Sync Action: 'net stop MSSQLSERVER' Post-Sync Action: 'net start MSSQLSERVER' The per-sync action will stop the Microsoft SQL Server database service before the file sync operation and the post-sync action will start the Microsoft SQL Server database service again after the sync operation is completed. Sometimes, a database may use multiple directories for different types of files. In this case, in order to synchronize such a database using a single file synchronization command, open the file synchronization command dialog, select the 'General' tab, select the 'Expert' configuration mode and add all directory pairs that should be synchronized. This way the database will be stopped only once when the file synchronization command is started and all the required directories will be synchronized in a single operation. In order to minimize the impact of the database downtime on users and other applications, the file synchronization operation may be scheduled to be executed automatically when no users are working with the database.
38
Flexense Ltd.
The SyncBreeze file synchronization server provides the user with the ability to send E-Mail notifications about failed file synchronization commands with a detailed description explaining the exact reason for the failure and a list of files that caused the failure.
In order to enable error E-Mail notifications, open the 'E-Mail Server Settings' page and specify an SMTP server host name (or IP address), E-Mail account and password to use to send E-Mail notifications. In addition, open the 'Advanced Server Options' page, enable the E-Mail notifications option and specify a destination E-Mail address to send notifications to.
39
Flexense Ltd.
When enabled, status notifications are sent for all successfully completed and failed file synchronization operations. A file synchronization status notification shows the total number of file synchronization operations for the sync command, the total number of synchronized files, the total amount of synchronized disk space and the total number of file synchronization errors. In addition, a sync status notification shows a history of last X file sync operations according to the number of history sync tasks configured on the 'Advanced Server Options' page.
In order to enable status E-Mail notifications, open the 'E-Mail Server Settings' page and specify an SMTP server host name (or IP address), E-Mail account and password to use to send E-Mail notifications. In addition, open the sync command configuration page, press the 'Misc' button, enable the status E-Mail notifications option and specify a destination E-Mail address to send notifications to.
40
Flexense Ltd.
The file synchronization statistics page allows one to display pie charts showing the total number of sync operations per file synchronization command, the total amount of disk space, the total number of files, the amount of synchronized disk space, the number of synchronized files and the number of sync errors per file synchronization command.
In addition, the user is provided with the ability to export file synchronization statistics reports into a number of standard formats including PDF, XML, HTML, Excel CSV and plain text. In order to export a detailed report, which includes history statistics for all commands, select the 'Detailed' report type and press the 'Save' button.
41
Flexense Ltd.
Each status E-Mail notification includes an HTML summary table showing the current status of all file synchronization commands and an attached PDF report with detailed information about all file synchronization commands, history statistics, pie charts and history line charts for X last file synchronization operations according to the configuration selected on the 'Advanced Server Options' page.
In order to configure periodic status reports, open the 'Advanced Server Options' page, enable periodic status reports, select the time interval, enable E-Mail notifications and specify an EMail address to send status reports to. In addition, open the E-Mail server configuration page and specify an SMTP server to use to send E-Mail notifications.
42
Flexense Ltd.
In order to set a custom user name and password, click on the 'Configure Server Login' link located on the main settings page, enter a new user name and password and press the 'Save' button.
43
Flexense Ltd.
In order to set a custom server control port and/or web access port, click on the 'Setup Server Ports' link located on the main settings page and enter a custom server control port or webaccess port to use. If the SyncBreeze server should be controlled through the network, make sure the server control port and the web access port are open in the server's firewall.
44
Flexense Ltd.
SyncBreeze command line utility server commands: syncbreeze -server_status Shows the Sync Breeze server status. syncbreeze -server_show_commands Shows file synchronization commands defined in the Sync Breeze Server configuration. syncbreeze -server_add_command <Command Name> -source <Dir> -dest <Dir> Adds a new file synchronization command. syncbreeze -server_delete_command <Command Name> Deletes the specified file synchronization command. syncbreeze -server_execute_command <Sync Command> Synchronously executes the specified file synchronization command on the SyncBreeze server. syncbreeze -server_start_command <Sync Command> Asynchronously starts the specified file synchronization command on the SyncBreeze server. syncbreeze -server_pause_command <Sync Command> Pauses the specified file synchronization command. syncbreeze -server_stop_command <Sync Command> Stops the specified file synchronization command syncbreeze -server_start_all_commands Starts all configured file synchronization commands. syncbreeze -server_stop_all_commands Stops all running file synchronization commands.
45
Flexense Ltd.
syncbreeze -server_enable_command_monitor <Sync Command> Enables the real-time disk change monitor for the specified file synchronization command. Optional Parameters: [ -monitor <SOURCE | DEST | ALL> ] [ -changes CHANGE-COUNT ] syncbreeze -server_disable_command_monitor <Sync Command> Disables the real-time disk change monitor for the specified file synchronization command. syncbreeze -server_enable_command_timer <Sync Command> Enables periodic file synchronization for the specified file synchronization command. Optional Parameters: [ -time TIME-VALUE ] [ -units <MIN | HOUR> ] syncbreeze -server_disable_command_timer <Sync Command> Disables periodic file synchronization for the specified file synchronization command. syncbreeze -server_command_status <Sync Command> Shows the status of the specified file synchronization command. syncbreeze -server_command_history <Sync Command> Shows the sync history for the specified file synchronization command. syncbreeze -server_export_command <Sync Command> -file <XML File Name> Exports the specified file synchronization command to an XML file. syncbreeze -server_export_all_commands -dir <Directory Name> Exports all configured file synchronization commands to a directory as XML files. syncbreeze -server_import_command -file <XML File Name> Imports a file synchronization command from the specified XML file. syncbreeze -server_import_commands -dir <Directory Name> Imports all XML command files located in the specified directory. syncbreeze -server_show_debug_log Shows the Sync Breeze Server debug message log. syncbreeze -server_clear_debug_log Clears the SyncBreeze server debug message log. syncbreeze -server_set_user <User Name> Sets the server user name. Execute this command locally to reset the user name. syncbreeze -server_set_password <Password> Sets the server password. Execute this command locally to reset the password. syncbreeze -server_set_port <Port Number> Sets the server control port (default is 9121). After changing the port number restart the server to apply changes. syncbreeze -server_set_defaults -host <Host Name> -port <Port Number> -user <User Name> -password <Password>
Sets the default server host name, port, user name and password to connect to.
46
Flexense Ltd.
Due to the fact that the product is especially designed for servers running in production environments where stability is a major decision factor, SyncBreeze Server updates should be manually installed by the user. In order to update an existing product installation, download the latest product version and just start the setup program.
The SyncBreeze Server setup program will properly shutdown the running SyncBreeze service, update the product and restart the SyncBreeze service after finishing the update procedure. All product configuration files, saved file synchronization commands and product registration will remain valid and there is nothing to reconfigure or manage after the update.
47
Flexense Ltd.
If the computer where SyncBreeze Server is installed on is connected to the Internet, login to the SyncBreeze server (default user name and password: admin/admin) using a standard web browser, click on the 'About' link located on the top menu bar, press the 'Register' button, enter your name or your company name, enter the received unlock key and press the 'Register' button.
If the computer is not connected to the Internet, press the 'Manual Registration' button, export the product ID file and send the product ID file to [email protected] as an attachment. Within a couple of hours, you will receive an unlock file, which should be imported in order to finish the registration procedure.
48
Flexense Ltd.
In order to be able to set custom OEM product and vendor information, the user needs to register the product using a special OEM-Enabled unlock key, which may be purchased on the product purchase page. Once the product is registered using an OEM unlock key, open the 'About' page, press the 'Set OEM Info' button, specify your custom OEM product and vendor information and press the 'Save' button.
Custom OEM product and vendor information will be displayed on all pages of the SyncBreeze web-based management interface, in all types of reports generated by the product and all notification E-Mail messages sent by SyncBreeze Server.
49
Flexense Ltd.
32-Bit Operating Systems Windows Windows Windows Windows Windows Windows Windows XP Vista 7 8 Server 2003 Server 2008 Server 2012
64-Bit Operating Systems Windows Windows Windows Windows Windows Windows Windows XP 64-Bit Vista 64-Bit 7 64-Bit 8 64-Bit Server 2003 64-Bit Server 2008 64-Bit Server 2012 64-Bit
Minimal System Configuration Supported Operating System 1 GHz or better CPU 256 MB of system memory 25 MB of free disk space Internet Explorer 9, FireFox 12, Chrome 17 or newer is required for proper operation of the web-based management interface
Recommended System Configuration Supported Operating System Dual-Core 2 GHz or better CPU 512 MB of system memory 25 MB of free disk space Internet Explorer 9, FireFox 12, Chrome 17 or newer is required for proper operation of the web-based management interface
50