Professional Documents
Culture Documents
Flexense Ltd.
IronSync
Real-Time Sync
User Manual
Version 1.5
Jun 2012
Flexense Ltd.
Product Overview
IronSync Server is a real-time file synchronization server capable of synchronizing multiple pairs of local disks, directories and/or network shares. IronSync Server monitors file system changes and performs file synchronization operations in real-time as files on the disk are changing without scanning directories thus allowing one to effectively synchronize huge file systems containing millions of files.
IronSync is optimized for modern hardware architectures and is capable of effectively utilizing multi-core CPUs and multi-CPU servers while synchronizing millions of files in real-time. On the other hand, IronSync Server is especially designed to run on production servers using a very small amount of the system memory (6MB-8MB) and CPU resources in order to minimize the performance impact on running production applications.
IronSync Server runs as a service in the background and provides a web-based management interface allowing one to control, configure and manage the product using a regular web browser locally or through the network. The user is provided with the ability to setup multiple file synchronization commands, optionally specify exclude directories and/or specific types of files to synchronize, customize error recovery options, enable error logs and/or send E-Mail notifications when a sync command fails due to a hardware problem.
Flexense Ltd.
The installation package is very small, 2MB - 3MB depending on the target operating system, and the product requires just 10MB of the free disk space on the target server. In order to install IronSync 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 IronSync command line utility to connect to the server and the web access port is the port for the web-based management interface allowing one to control IronSync Server using a standard web browser. If IronSync Server should be controlled remotely through the network, make sure one or both of these ports are open in the server's firewall.
Flexense Ltd.
Web-Based Interface
IronSync Server provides a complete web-based management interface, which allows one to fully control, manage and configure one or more IronSync servers locally or though the network using a standard Web browser. By default, the web-based interface uses the TCP/IP port 80, which is the default HTTP port web browsers are using to connect to a web server.
In order to connect to IronSync Server, open a regular web browser, enter the host name of the server to connect to and login using the default user name and password: admin/admin. The IronSync web-based interface is a dynamic web application, which shows the current status of the server and the progress of performed operations without reloading the currently displayed web page. In order to operate properly, the web-based interface requires JavaScript to be enabled in the web browser.
Flexense Ltd.
On the IronSync Server status page, press the 'Add Command' button, enter a unique command name, enter a source directory, which should be a local disk or directory, and enter a destination directory, which may be set to a local disk, directory or a network share, and press the 'Save' button.
In order to start a file synchronization command, go to the main status page and click on the 'Start' button located on the right side of the file synchronization command. Click on the command name link to see an extended status of the command. In order to stop an active file synchronization command, click on the 'Stop' link located on the right side of the file synchronization command.
Flexense Ltd.
Another very useful feature is the sync preview mode, which may be enabled for any file synchronization command on the advanced options page. In the preview mode, IronSync will monitor the source directory, examine all detected file system changes and calculate the expected change rate without performing any actions in the destination directory. This mode allows one to analyze a frequently changing file system and estimate expected performance requirements in order to properly select a fast enough backup device to be used as a destination directory for a file synchronization command. IronSync Server provides the ability to perform initial file synchronization for static files existed in the source directory before the file synchronization command was started for the first time. In order to enable initial file synchronization for a sync command, open the main command page and select the 'Enable Initial File Synchronization' option. By default, initial file synchronization is performed when the IronSync server is idle, paused when a large number of real-time sync actions should be performed and automatically resumed when the number of pending sync actions drops below a user-configurable limit. The 'Initial Sync Start Limit' option sets the number of pending file system changes or pending sync actions triggering the start of the initial file synchronization operation. The 'Initial Sync Stop Limit' option sets the number of pending file system changes or pending sync actions triggering the stop of the initial file synchronization operation. For example, when the number of pending sync actions drops below the start limit, the initial file sync operation is resumed and when the number of pending actions raises above the stop limit, the initial sync operation is paused.
Flexense Ltd.
For example, IronSync Server allows one configure a file synchronization command to sync all types of images with the file size more than 10 MB and the file name not beginning with 'IRONSYNC' while skipping all other files not matching the specified rules. In order to configure file matching rules for a command, open the command page and press the 'Rules' button. On the 'Rules' page press the 'Add Rule' button, select an appropriate rule type, operator, a rule value and press the 'Save' button.
IronSync Server allows one to add an unlimited number of file matching rules for each file synchronization command with each one configured to match files by a specific file property. In addition, advanced users are provided with the ability configure an unlimited number of hierarchical nested rules combined with logical operators and allowing one to precisely select types of files that should be synchronized.
Flexense Ltd.
Sync File Attributes - select this option if you wish to sync file attributes for all files copied from the source to the destination directory (by default this option is enabled). Sync User/Group Security Descriptor - select this option if you wish to copy file ownership information for all files copied from the source to the destination directory (by default this option is disabled). Sync Discretionary Access Control Lists (DACL) - select this option if you wish to copy DACLs for all files copied from the source to the destination directory (by default this option is disabled). Sync System Access Control List (SACL) - select this option if you wish to copy SACLs for all files copied from the source to the destination directory (by default this option is disabled). Skip System Files and Directories - select this option if you wish to skip all system files and directories from the file synchronization process (by default this option is enabled). Skip Hidden Files and Directories - select this option if you wish to skip all hidden files and directories from the file synchronization process (by default this option is enabled). Bit-Level File Synchronization - select this option if you wish to copy only changed data blocks for files that should be synchronized (by default this option is disabled). Verify Files After Copy - select this option if you wish to verify each file copied to the destination directory (by default this option is disabled).
* All security related options require administrative privileges and the IronSync service needs to be configured to run under a user account having enough permissions to access all the required network shares and perform DACL and SACL copy operations.
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 the 'IronSync Server' service. Open the 'IronSync Server' service, select the 'General' tab and stop the service. Select the 'Log On' tab and specify a user account to use for the IronSync service. Select the 'General' tab and start the 'IronSync Server' service.
Now, the IronSync service 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.
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.
10
Flexense Ltd.
Default error handling settings should be good enough for most users, but if required, the user is provided with the ability to customize the maximum number of errors per sync command, the maximum number of consecutive errors, the maximum number of retries to perform for each locked file and the initial retry delay. In addition, IronSync Server provides the ability to set a global logs directory and/or a global notification E-Mail address to send notifications about failed file synchronization commands. If the global logs directory and/or error notifications are enabled, IronSync will save error logs and/or send notifications for all failed file synchronization commands. File synchronization commands explicitly configured to save error logs to a different directory and/or send notifications to a different E-Mail address take precedence over the global settings.
11
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, select the 'Use Custom Port' option and enter a custom port number to use. If the IronSync server should be controlled through the network, make sure the custom ports are open in the server's firewall.
12
Flexense Ltd.
The command line utility may be executed with a variety of command line parameters and options allowing one to automate control, configuration and management of one or more IronSync Servers using batch files or shell scripts. For detailed information about available command line options, execute the command line utility with the '-help' command line parameter.
13
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, IronSync Server updates should be manually performed by the user. In order to update an existing product installation, download the latest product version and just start the setup program.
The IronSync Server setup program will properly shutdown the running IronSync Server, update the product and restart the IronSync service after finishing the update procedure. All product configuration files, configured file synchronization commands and product registration will remain valid and there is nothing to reconfigure or manage after the update.
14
Flexense Ltd.
If the computer where IronSync Server is installed on is connected to the Internet, login to the IronSync web-based management interface (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 register@ironsync.com 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.
15
Flexense Ltd.
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
16