ironsync file synchronization server

8/13/2019 IronSync File Synchronization Server

1/38

IronSync File Synchronization Server Flexense Ltd.

1

User Manual

Version 2.3

Feb 2014

www.ironsync.com www.flexense.com

Flexense Ltd.

IronSyncFILE SYNC SERVER


2/38


2

1 Product Overview................................................................................................3

2 Product Installation Procedure ...........................................................................4

3 Using IronS nc !lient "UI #$$lication ................................................................%

3.1 Types of File Synchronization Commands ..............................................................

3.2 !eriodic File Synchronization Commands ..............................................................." 3.3 !eriodic File Synchronization Tri##ers ...................................................................$ 3.% &eal'Time File Synchronization Commands ............................................................( 3.) &eal'Time *irectory Synchronization Commands..................................................1+ 3. ,dvanced File Synchronization -ptions ...............................................................11 3." Synchronizin# Specific Types of Files ..................................................................12 3.$ xcl/din# *irectories From File Synchronization ...................................................13 3.( File Synchronization Lo#s and rror 0otifications ..................................................1% 3.1+ Connectin# to a remote IronSync Server ............................................................. 1) 3.11 sin# IronSync to Synchronize 0etwor Shares ...................................................1 3.12 Confi#/rin# IronSync Server ..............................................................................1" 3.13 !rod/ct pdate !roced/re .................................................................................1( 3.1% !rod/ct &e#istration !roced/re ..........................................................................2+

4 Using &eb'(ased Inter)ace...............................................................................21 %.1 File Synchronization Command Types .................................................................22 %.2 ana#in# File Synchronization Commands...........................................................23 %.3 !eriodic File Synchronization Commands ............................................................. 2% %.% &eal'Time *irectory Synchronization Commands..................................................2" %.) ,dvanced File Synchronization Commands -ptions...............................................2$ %. Synchronizin# Specific Types of Files ..................................................................2( %." File Synchronization -ptions ..............................................................................3+ %.$ xcl/din# *irectories From File Synchronization ...................................................31 %.( Confi#/rin# IronSync Server ..............................................................................32 %.1+ Confi#/rin# ser 0ame and !assword .................................................................32 %.11 Confi#/rin# rror 4andlin# -ptions.....................................................................33 %.12 Confi#/rin# Server Control and 5e6 ,ccess !orts.................................................3% %.13 Confi#/rin# ' ail 0otifications..........................................................................3% %.1% !rod/ct &e#istration !roced/re ..........................................................................3) %.1) - !rod/ct 7ersion ........................................................................................3

% Using IronS nc !o**and +ine Utilit ...............................................................3,

- Su$$orted O$erating S ste*s...........................................................................3

, S ste* /e uire*ents .......................................................................................3


3/38


3

1 Product Overview

IronSync Server is a powerf/l file synchronization server providin# m/ltiple types of periodicand real'time file synchronization operations. IronSync is a hi#hly scala6le file synchronizationsol/tion especially desi#ned to effectively synchronize h/#e file systems containin# tens ofmillions of files. sers are provided with m/ltiple one'way and two'way file synchronizationmodes8 periodic and real'time file synchronization capa6ilities8 ' ail notifications8 error lo#s8file synchronization statistics reports8 etc.

IronSync is optimized for modern hardware architect/res and is capa6le of effectively /tilizin#m/lti'core C! s and m/lti'C! servers while synchronizin# millions of files in real'time. -nthe other hand8 IronSync Server is especially desi#ned to r/n on prod/ction servers /sin# avery small amo/nt of the system memory 9 :'$ :; and C! reso/rces in order to minimizethe performance impact on r/nnin# prod/ction applications.

IronSync Server r/ns as a service in the 6ac #ro/nd and provides a client < I application8 acommand line /tility and a we6'6ased mana#ement interface allowin# one to control8confi#/re and mana#e one or more IronSync Servers locally or thro/#h the networ . The /ser

is provided with the a6ility to set/p m/ltiple file synchronization commands8 specify excl/dedirectories8 synchronize specific types of files8 c/stomize error recovery options8 ena6le errorlo#s and=or send ' ail notifications when a sync command fails d/e to a hardware pro6lem.


4/38


%

2 Product Installation Procedure

IronSync Server is especially desi#ned to 6e as simple as possi6le. The prod/ct does notre>/ire any third'party software applications and may 6e installed and confi#/red within aco/ple of min/tes. , f/lly f/nctional 3+'days trial version of IronSync Server may 6edownloaded from the followin# pa#e? http?==www.ironsync.com=downloads.html .

The installation pac a#e is very small8 : ' " : dependin# on the tar#et operatin# system8and the prod/ct re>/ires @/st 2+ : of the free dis space on the tar#et server. In order toinstall IronSync Server8 start the set/p pro#ram8 select a destination directory and press theA0extA 6/tton.

-ptionally8 enter c/stom server control and=or we6 access ports. The server control port is/sed 6y the IronSync client < I application and the command line /tility to connect to theserver and the we6 access port is the port for the we6'6ased mana#ement interface allowin#

one to control IronSync Server /sin# a standard we6 6rowser. If IronSync Server sho/ld 6econtrolled remotely thro/#h the networ 8 ma e s/re one or 6oth of these ports are open in theserverAs firewall.


5/38


6/38


3.1 $es o) File S nc roni ation !o**ands

IronSync Server provides a n/m6er of different types of periodic and real'time filesynchronization commands with each one optimized for different needs and /sa#e scenarios. ,specific file synchronization command type sho/ld 6e selected for each newly created filesynchronization command. In order to add a new file synchronization command8 press the

A,ddA 6/tton located on the main tool6ar and select an appropriate file synchronizationcommand type. IronSync provides the followin# types of file synchronization commands?

Periodic File S nc roni ation !o**and ' this command may 6e exec/tedman/ally or a/tomatically tri##ered /sin# one or more periodic8 daily8 wee ly ormonthly sync tri##ers. !eriodic file synchronization commands provide m/ltiple one'way and two'way file synchronization modes8 r/le'6ased file synchronizationcapa6ilities8 error lo#s8 ' ail notifications8 etc. very time a periodic file synccommand is tri##ered8 IronSync rescans the so/rce and destination directories andsynchronizes all chan#es accordin# to the selected file synchronization mode. ,ll syncactions are performed on'the'fly8 witho/t readin# or writin# any file system state filesor data6ases and therefore periodic file synchronization commands are capa6le ofsynchronizin# h/#e file systems containin# millions of files very effectively while /sin#

a very small amo/nt of system memory and C! reso/rces. /eal' i*e File S nc roni ation !o**and ' this command synchronizes chan#ed

files on'the'fly as files are chan#in# in the so/rce directory. IronSync Server monitorsthe so/rce directory8 detects individ/al file chan#es and synchronizes all chan#ed filesto the destination directory. File synchronization is performed in one direction only 'from the so/rce directory to the destination directory. So/rce and destinationdirectories are never scanned and this type of file synchronization commands isespecially optimized for effective synchronization of h/#e file systems containin# tensand h/ndreds of millions of files.

/eal' i*e irector S nc roni ation !o**and ' this command synchronizeschan#ed directories on'the'fly as files are chan#in# in the so/rce directory. IronSyncServer monitors the so/rce directory8 in real'time detects chan#ed s/6directories andperforms short sync operations 6etween s/6directories. The /ser is provided with fivedifferent one'way and two'way file synchronization modes. F/ll scannin# of the so/rceand destination directories is never performed8 file synchronization is completed inreal'time 6etween pairs of chan#ed s/6directories and this type of file synchronizationcommands is optimized for effective synchronization of h/#e file systems containin#tens and h/ndreds of millions of files.


7/38


"

3.2 Periodic File S nc roni ation !o**ands

!eriodic file synchronization commands provide m/ltiple one'way and two'way filesynchronization modes8 r/le'6ased file synchronization capa6ilities8 file synchronization lo#s8error ' ail notifications8 etc. !eriodic file sync commands may 6e exec/ted man/ally ora/tomatically tri##ered /sin# one or more daily8 wee ly or monthly periodic sync tri##ers.

very time a periodic file sync command is tri##ered8 IronSync rescans the so/rce anddestination directories and synchronizes all chan#ed files accordin# to the selected filesynchronization mode. ,ll sync actions are performed on'the'fly8 witho/t readin# or writin#any file system state files or data6ases and therefore periodic file synchronization commandsare capa6le of synchronizin# h/#e file systems containin# millions of files very effectively while/sin# a very small amo/nt of system memory and C! reso/rces.

!eriodic file synchronization commands provide m/ltiple one'way and two'way filesynchronization modes with each one desi#ned for specific needs and /sa#e scenarios. Inorder to chan#e the file synchronization mode for a periodic file synchronization command8open the command A ditA pa#e and select an appropriate file synchronization mode. !eriodicfile synchronization commands provide the followin# file synchronization modes?

S nc roni e estination irector 9one'way; ' ,ll chan#es made in the so/rcedirectory will 6e propa#ated to the destination directory. Files deleted from the so/rcedirectory will 6e deleted from the destination directory. ,ll files chan#ed or deleted inthe destination directory will 6e restored /sin# files from the so/rce directory. 0ochan#es will 6e made in the so/rce directory. ,fter the file synchronization process iscomplete 6oth locations will 6e identical.

U$date estination irector 9one'way; ' 0ewly created and modified so/rce fileswill 6e copied to the destination directory. Files deleted from the so/rce directory will6e deleted from the destination directory. Files deleted from the destination directory

will 6e restored /sin# files from the so/rce directory. 0ewly created and modifieddestination files will 6e ept in place. 0o chan#es will 6e made in the so/rce directory. #ccu*ulate and U$date Files in estination 9one'way; ' 0ewly created and

modified so/rce files will 6e copied to the destination directory. Files deleted from thedestination directory will 6e restored /sin# files from the so/rce directory. 0ewlycreated and modified destination files will 6e ept in place. 0o files will 6e deletedfrom the destination directory. 0o chan#es will 6e made in the so/rce directory.

wo'&a File S nc roni ation ' 0ewly created and modified files will 6esynchronized in 6oth directions. Files deleted from the so/rce directory will 6e deletedfrom the destination directory. Files deleted from the destination directory will 6erestored from the so/rce directory. Chan#es may 6e made in 6oth locations. ,fter thefile synchronization process is complete 6oth locations will 6e identical.

wo'&a #ccu*ulation and U$date ' 0ewly created and modified files will 6e/pdated in 6oth directions. Files deleted from one location will 6e restored from thesecond location. Chan#es may 6e made in 6oth locations. ,fter the file synchronizationprocess is complete 6oth locations will 6e identical.


8/38


$

3.3 Periodic File S nc roni ation riggers

!eriodic file synchronization commands may 6e a/tomatically tri##ered /sin# one or moreperiodic8 daily8 wee ly or monthly sync tri##ers. In order to confi#/re sync tri##ers for aperiodic file synchronization command8 open the command options dialo# and select theA


9/38


(

3.4 /eal' i*e File S nc roni ation !o**ands

&eal'Time file synchronization commands synchronize chan#ed files on'the'fly as files arechan#in# in the so/rce directory. IronSync Server monitors the so/rce directory8 detectsindivid/al file chan#es and synchronizes all chan#ed files to the destination directory. Filesynchronization is performed in one direction only ' from the so/rce directory to the

destination directory. So/rce and destination directories are never scanned and this type offile synchronization commands is especially optimized for effective synchronization of h/#e filesystems containin# tens and h/ndreds of millions of files.

In order to add a real'time file synchronization command8 press the A,ddA 6/tton located onthe main tool6ar8 select the A&eal'Time File SynchronizationA command type8 enter a /ni>/ecommand name8 specify the so/rce and destination directories and press the ASaveA 6/tton.

&eal'Time file synchronization commands can 6e started man/ally or a/tomatically when thecomp/ter starts. In order to ena6le a/to start for a real'time file synchronization command8select the command in the commands view8 press the ri#ht mo/se 6/tton8 select the A ditCommandA men/ item8 select the A


10/38


1+

3.% /eal' i*e irector S nc roni ation !o**ands

&eal'Time directory synchronization commands synchronize chan#ed directories on'the'fly asfiles are chan#in# in the so/rce directory. IronSync Server monitors the so/rce directory8 inreal'time detects chan#ed s/6directories and performs short sync operations 6etweens/6directories witho/t scannin# the complete directory tree. The /ser is provided with five

different one'way and two'way file synchronization modes. F/ll scannin# of the so/rce anddestination directories is never performed and file synchronization is completed in real'time6etween pairs of chan#ed s/6directories.

In order to chan#e the file synchronization mode for a file synchronization command8 open thefile synchronization command options dialo# and select one of the followin# filesynchronization modes?


U$date estination irector 9one'way; ' 0ewly created and modified so/rce fileswill 6e copied to the destination directory. Files deleted from the so/rce directory will6e deleted from the destination directory. Files deleted from the destination directorywill 6e restored /sin# files from the so/rce directory. 0ewly created and modifieddestination files will 6e ept in place. 0o chan#es will 6e made in the so/rce directory.

#ccu*ulate and U$date Files in estination 9one'way; ' 0ewly created and

modified so/rce files will 6e copied to the destination directory. Files deleted from thedestination directory will 6e restored /sin# files from the so/rce directory. 0ewlycreated and modified destination files will 6e ept in place. 0o files will 6e deletedfrom the destination directory. 0o chan#es will 6e made in the so/rce directory.




11/38


11

3.- #dvanced File S nc roni ation O$tions

IronSync provides a lar#e n/m6er of advanced file synchronization options allowin# one toc/stomize file synchronization operations for /ser'specific needs and hardware confi#/rations.In order to open the file synchronization options dialo#8 select a file synchronization commandin the sync commands view8 press the ri#ht mo/se 6/tton and select the A dit CommandA

men/ item.

The A#dvanced A ta6 allows one to control the n/m6er of parallel file synchronization threads8the n/m6er of parallel directory scannin# threads8 the performance mode and the filesynchronization preview mode8 which may 6e /sed to test advanced file synchronizationoptions 6efore exec/tin# file synchronization operations on prod/ction data.

The AO$tions A ta6 provides the a6ility to control which meta data is synchronized when filesare copied from one directory to another. In addition8 the /ser is provided with the a6ility toena6le the 6it'level file synchronization option for any file synchronization command. 5ith thisoption ena6led8 IronSync Server will compare and /pdate individ/al data 6loc s in files thatsho/ld 6e synchronized th/s minimizin# the amo/nt of data written to the dis . Finally8IronSync Server provides the a6ility to verify the inte#rity of copied files 6y comparin# hashsi#nat/res of so/rce and destination files after each file copy operation.


12/38


12

3., S nc roni ing S$eci)ic $es o) Files

Sometimes8 it may 6e re>/ired to synchronize specific types of files or #ro/ps of filesaccordin# to /ser'specific needs and re>/irements. IronSync provides a lar#e set of filematchin# r/les allowin# one to synchronize files 6y the file type8 extension8 size8 file name8directory8 attri6/tes8 /ser name8 etc. The /ser is provided with the a6ility to add a n/m6er of

file matchin# r/les to any file synchronization operation specifyin# which files to synchronize.

For example8 IronSync allows one to synchronize all types of doc/ment files with the file sizemore than B : and a text pattern in the file name. The /ser is provided with the a6ility tocom6ine different types of file matchin# r/les and lo#ical operators precisely selectin# filesthat sho/ld 6e synchronized.

In addition to positive file matchin# r/les8 the /ser is provided with ne#ative file matchin#r/les8 which can 6e /sed to excl/de specific types or #ro/ps of files from the filesynchronization process. For example8 IronSync allows one to excl/de all types of ima#esowned 6y a specific /ser and havin# the system file attri6/te. 7ario/s types of positive andne#ative file matchin# r/les may 6e com6ined into sophisticated8 m/lti'level file filtersprecisely selectin# which files to synchronize and which files to excl/de from the filesynchronization process.


13/38


13

3. 56cluding irectories Fro* File S nc roni ation

Sometimes8 it may 6e re>/ired to excl/de one or more s/6directories from the filesynchronization process. For example8 if yo/ need to synchronize two directories excl/din#one or two special s/6directories8 yo/ may specify the top level directories as the so/rce anddestination directories and add the s/6directories that sho/ld 6e s ipped to the excl/de list.

In order to add one or more directories to the excl/de list8 open the file synchronizationcommand options dialo#8 select the A xcl/deA ta6 and add one or more directories to theexcl/de directories list. ,ll files and s/6directories located in the specified excl/de directorieswill 6e excl/ded from the file synchronization process.

In addition8 advanced /sers are provided with a n/m6er of excl/de directories macro

commands allowin# one to excl/de m/ltiple directories /sin# a sin#le macro command.IronSync Server provides the followin# excl/de directories macro commands?

7(5"I8S 9 e6t String: ' this macro command excl/des all directories 6e#innin#with the specified text strin#.

7!O8 #I8S 9 e6t String: ' this macro command excl/des all directoriescontainin# the specified text strin#.

758 S 9 e6t String: ' this macro command excl/des all directories endin# with thespecified text strin#.

7/5"5; 9/egular 56$ression: ' this macro command excl/des directoriesmatchin# the specified re#/lar expression.

For example8 the excl/de macro command A C-0T,I0S Temporary FilesA will excl/de alldirectories with ATemporary FilesA at any place in the f/ll directory path and the excl/de macrocommand A & < B D.9T !ET !; A will excl/de directories endin# with A.T !A or A.T !A.


14/38


1%

3.< File S nc roni ation +ogs and 5rror 8oti)ications

IronSync provides a n/m6er of file synchronization lo#s and error notification options allowin#one to eep file synchronization operations /nder control. In order to ena6le error ' ailnotifications for a file synchronization command8 open the file synchronization commanddialo#8 select the A iscA ta68 select the ASend rror 0otificationsA option and specify an ' ail

address to send error notifications to. In addition8 in order to ena6le ' ail notifications8 the/ser needs to open the A-ptionsA dialo#8 select the A ' ailA ta6 and specify an S T! server to/se to send ' ail notifications.

rror ' ail notifications are sent when a file synchronization operation is a6orted d/e to acritical error s/ch as no dis space on the destination device or when there are too many non'critical errors. In addition to error ' ail notifications8 the /ser is provided with the a6ility tosave file synchronization error lo#s in a /ser'specified directory. Finally8 in order to simplifytestin# of sophisticated file synchronization operations8 IronSync provides the a6ility to savef/ll file synchronization lo#s incl/din# all file synchronization actions performed 6y a filesynchronization operation.

File synchronization lo#s and error notifications may 6e ena6led for each file synchronizationcommand individ/ally and #lo6ally for all file synchronization commands on the IronSync

Server A-ptionsA dialo#. File synchronization lo#s and error notifications options specified for afile synchronization command ta e precedence over #lo6al file synchronization lo#s and errornotification options specified on the IronSync Server A-ptionsA dialo#.


15/38


1)

3.10 !onnecting to a re*ote IronS nc Server

The IronSync client < I application allows one to control one or more IronSync Servers locallyor via the networ . In order to connect to a remote IronSync server8 open the client < Iapplication8 press the AConnectA 6/tton located on the main tool6ar and specify a host name oran I! address of the server to connect to.

In order to prevent /na/thorized access to the IronSync Server8 all comm/nication 6etweenthe client < I application and the remote IronSync server is performed /sin# an , S'2)encrypted networ protocol with randomly selected and dynamically chan#ed eys for eachsession. :y defa/lt8 the IronSync client < I application /ses the TC!=I! port (1%2 to connectto the IronSync Server and in order to 6e a6le to connect thro/#h the networ 8 the portsho/ld 6e open in the serverAs firewall.

5hen the IronSync client < I application is connected to a server8 the name of the server isdisplayed on the stat/s 6ar8 the sync commands view shows file synchronization commandsconfi#/red on the server and the messa#e lo# view shows last stat/s messa#es from the

IronSync server. In order to see more information a6o/t the IronSync Server8 select the men/A4elp ' ,6o/tA and the IronSync client < I application will display serverAs A,6o/tA dialo#.


16/38


1

3.11 Using IronS nc to S nc roni e 8etwor= S ares

:y defa/lt8 the IronSync service is confi#/red to r/n /nder the local system acco/nt8 which is#ood to synchronize local dis s and directories. -n the other hand8 the local system acco/ntdoes not have permissions to access networ shares and 0,S stora#e devices.

In order to ena6le IronSync Server to synchronize files to networ shares and 0,S stora#edevices8 the IronSync service sho/ld 6e confi#/red to r/n /nder a /ser acco/nt8 which haspermissions to create files and directories on the re>/ired networ shares.

The confi#/ration is very simple and may 6e performed within a co/ple of seconds /sin# thefollowin# step'6y'step #/ide?

1. -pen the 5indows control panel and clic on the A,dministrative ToolsA /tility.

2. -pen the Services control center and find the AIronSync ServerA service.3. -pen the AIronSync ServerA service8 select the A


17/38


1"

3.12 !on)iguring IronS nc Server

IronSync Server provides a lar#e n/m6er of advanced confi#/ration options allowin# one toc/stomize the prod/ct for /ser'specific needs and re>/irements. In order to open the A-ptionsAdialo#8 open the IronSync client < I application8 connect to a server and press the A-ptionsA6/tton located on the main tool6ar. 5hen the /ser opens the A-ptionsA dialo#8 the client < I

application re>/ests server confi#/ration options from the IronSync Server and /pdatesconfi#/ration options on the server side when the /ser closes the A-ptionsA dialo#.

The A"eneral A ta6 provides a lar#e n/m6er of #eneral'p/rpose options allowin# one to controlhow IronSync scans directories8 handles errors and reports a6o/t different types of filesynchronization errors. The AServerA ta6 provides the a6ility to c/stomize the IronSync Server/ser name and password /sed 6y the IronSync client < I application and the command line/tility to lo#in to the IronSync Server. :y defa/lt8 IronSync Server is confi#/red to /se the

Aad*in>ad*in A /ser name and password8 which can 6e chan#ed to any ar6itrary /ser nameand password.

In order to prevent /na/thorized access to the IronSync Server8 all comm/nication 6etweenthe client < I application and the IronSync server is performed /sin# an , S'2) encryptednetwor protocol with randomly selected and dynamically chan#ed eys for each session. Inaddition8 the AServerA ta6 provides the a6ility to c/stomize the server control port /sed 6y theIronSync client < I application and the command line /tility to connect to the server. Finally8

the /ser is provided with the a6ility to c/stomize the we6 mana#ement interface port /sed 6ywe6 6rowsers to connect to the IronSync server. If the IronSync server sho/ld 6e controlledvia the networ 8 one or 6oth of these ports sho/ld 6e open in the serverAs firewall.


18/38


1$

The A#dvanced A ta6 allows one to control the maxim/m n/m6er of file synchronization errorsand the maxim/m n/m6er of consec/tive errors to a6ort a file synchronization operation. Inaddition8 the /ser is provided with the a6ility to control the file copy verification mode8 specifya #lo6al file synchronization error lo#s directory8 a #lo6al sync lo#s directory and a #lo6al '

ail address to send error notifications to.

If a #lo6al lo# directory is specified8 IronSync Server will save error lo#s and=or sync lo#s forall file synchronization commands confi#/red in the IronSync Server. In addition to the #lo6allo# directories8 the /ser is provided with the a6ility to confi#/re lo# directories for each filesynchronization command individ/ally on the file synchronization command options dialo#.

The A5'Mail A ta6 provides the a6ility to specify an S T! server to /se to send error ' ailnotifications. If a #lo6al error notifications address is specified8 IronSync Server will send error

' ail notifications to the #lo6al ' ail address for all failed file synchronization operations. Inaddition8 to the #lo6al error notifications ' ail address8 the /ser is provided with the a6ility toconfi#/re an individ/al error notification ' ail address for each file synchronization commandon the file synchronization command options dialo#.


19/38


1(

3.13 Product U$date Procedure

Flexense develops IronSync Server /sin# a fast release cycle with minor prod/ct versions8/pdates and 6/# fixes released almost every month and ma@or prod/ct versions releasedevery year. 0ew prod/ct versions and prod/ct /pdates are p/6lished on the prod/ct we6 siteand may 6e downloaded from the followin# pa#e? http?==www.ironsync.com=downloads.html .

*/e to the fact that the prod/ct is especially desi#ned for servers r/nnin# in prod/ctionenvironments where sta6ility is a ma@or decision factor8 IronSync Server /pdates sho/ld 6eman/ally performed 6y the /ser. In order to /pdate an existin# prod/ct installation8 downloadthe latest prod/ct version and @/st start the set/p pro#ram.

The IronSync Server set/p pro#ram will properly sh/tdown the r/nnin# IronSync Server8/pdate the prod/ct and restart the IronSync service after finishin# the /pdate proced/re. ,llprod/ct confi#/ration files8 confi#/red file synchronization commands and prod/ct re#istrationwill remain valid and there is nothin# to reconfi#/re or mana#e after the /pdate.


20/38


2+

3.14 Product /egistration Procedure

5ithin a co/ple of ho/rs after p/rchasin# a prod/ct license8 the c/stomer will receive two e'mail messa#es? the first one confirmin# the payment and the second one containin# an /nloc

ey8 which sho/ld 6e /sed to re#ister the prod/ct. If yo/ will not receive yo/r /nloc eywithin 2% ho/rs8 please chec yo/r spam 6ox and if the /nloc ey is not in the spam 6ox

contact o/r s/pport team? su$$ort?)le6ense.co* .

If the comp/ter where the IronSync Server is installed on is connected to the Internet8connect to the IronSync Server /sin# the client < I application8 press the A&e#isterA 6/ttonlocated in the top'ri#ht corner8 enter yo/r name or yo/r company name as the c/stomername8 enter the received /nloc ey and press the A&e#isterA 6/tton.

If the comp/ter is not connected to the Internet8 press the A an/al &e#istrationA 6/tton8export a prod/ct I* file and send the prod/ct I* file to register?irons nc.co* as anattachment. 5ithin a co/ple of ho/rs8 yo/ will receive an /nloc file8 which sho/ld 6e importedin order to finish the re#istration proced/re.


21/38


21

4 Using &eb'(ased Inter)ace

IronSync Server provides a complete we6'6ased mana#ement interface allowin# one tocontrol8 mana#e and confi#/re one or more IronSync servers locally or via the networ /sin# astandard we6 6rowser. :y defa/lt8 the we6'6ased interface is disa6led and in order to ena6lethe we6'6ased mana#ement interface8 connect to the IronSync server /sin# the client < Iapplication8 open the A-ptionsA dialo#8 select the AServerA ta68 select the A na6le 5e6 ServerAoption and press the ASaveA 6/tton.

In order to connect to the IronSync Server /sin# a re#/lar we6 6rowser8 enter the host nameor an I! address of the server in the address 6ar and lo#in /sin# the defa/lt /ser name andpassword? ad*in>ad*in . :y defa/lt8 the we6'6ased mana#ement interface /ses the TC!=I!port $+8 which is the standard port /sed 6y we6 6rowsers to connect to we6 servers8 and inorder to 6e a6le to mana#e the IronSync server via the networ 8 the we6 interface port sho/ld

6e open in the serverAs firewall.

The IronSync Server we6'6ased mana#ement interface is a dynamic we6 application8 which

shows the c/rrent stat/s of the server and the pro#ress of file synchronization operationswitho/t reloadin# the c/rrently displayed we6 pa#e. In order to operate properly8 the we6'6ased interface re>/ires avaScript to 6e ena6led in the we6 6rowser.


22/38


22

4.1 File S nc roni ation !o**and $es

IronSync Server provides m/ltiple different types of periodic and real'time file synchronizationcommands with each one optimized for different needs and /sa#e scenarios. , specific filesynchronization command type sho/ld 6e selected for each newly created file synchronizationcommand. In order to add a new file synchronization command8 press the A,dd CommandA

6/tton located on the IronSync Server home pa#e8 enter a command name and select anappropriate file synchronization command type.

IronSync Server provides the followin# types of file synchronization commands?

Periodic File S nc roni ation !o**and ' this command may 6e exec/tedman/ally or a/tomatically tri##ered /sin# one or more periodic8 daily8 wee ly ormonthly sync tri##ers. !eriodic file synchronization commands provide m/ltiple one'way and two'way file synchronization modes8 r/le'6ased file synchronizationcapa6ilities8 error lo#s8 ' ail notifications8 etc. very time a periodic file synccommand is tri##ered8 IronSync rescans the so/rce and destination directories andsynchronizes all chan#es accordin# to the selected file synchronization mode. ,ll syncactions are performed on'the'fly8 witho/t readin# or writin# any file system state filesor data6ases and therefore periodic file synchronization commands are capa6le ofsynchronizin# h/#e file systems containin# millions of files very effectively while /sin#a very small amo/nt of system memory and C! reso/rces.

/eal' i*e File S nc roni ation !o**and ' this command synchronizes chan#edfiles on'the'fly as files are chan#in# in the so/rce directory. IronSync Server monitorsthe so/rce directory8 detects individ/al file chan#es and synchronizes all chan#ed filesto the destination directory. File synchronization is performed in one direction only 'from the so/rce directory to the destination directory. So/rce and destinationdirectories are never scanned and this type of file synchronization commands isespecially optimized to effectively synchronize file systems with millions of files.

/eal' i*e irector S nc roni ation !o**and ' this command synchronizeschan#ed directories on'the'fly as files are chan#in# in the so/rce directory. IronSyncServer monitors the so/rce directory8 in real'time detects chan#ed s/6directories andperforms short sync operations 6etween s/6directories. The /ser is provided with fivedifferent one'way and two'way file synchronization modes. F/ll scannin# of the so/rceand destination directories is never performed8 file synchronization is completed inreal'time 6etween pairs of chan#ed s/6directories and this type of file synchronizationcommands is optimized to effectively synchronize file systems with millions of files.


23/38


23

4.2 Managing File S nc roni ation !o**ands

IronSync Server allows one to set/p an /nlimited n/m6er of file synchronization commandswith each one synchronizin# files from a so/rce dis or directory to a destination dis ordirectory. In order to set/p one or more file synchronization commands8 lo#in to the IronSyncServer we6'6ased mana#ement console /sin# a standard we6 6rowser.

-n the IronSync Server stat/s pa#e8 press the A,dd CommandA 6/tton8 enter a /ni>/ecommand name8 select an appropriate file synchronization command type8 enter a so/rcedirectory8 which sho/ld 6e a local dis or directory8 and enter a destination directory8 whichmay 6e set to a local dis 8 directory or a networ share8 and press the ASaveA 6/tton.

In order to start a file synchronization command8 #o to the main stat/s pa#e and clic on theAStartA 6/tton located on the ri#ht side of the file synchronization command. Clic on thecommand name lin to see an extended stat/s of the command. In order to stop an active filesynchronization command8 clic on the AStopA lin located on the ri#ht side of the filesynchronization command.


24/38


2%

4.3 Periodic File S nc roni ation !o**ands

!eriodic file synchronization commands provide m/ltiple one'way and two'way filesynchronization modes8 r/le'6ased file synchronization capa6ilities8 error lo#s8 ' ailnotifications8 etc. !eriodic file synchronization commands may 6e exec/ted man/ally ora/tomatically tri##ered /sin# one or more periodic8 daily8 wee ly or monthly sync tri##ers.

very time a periodic file sync command is tri##ered8 IronSync rescans the so/rce anddestination directories and synchronizes all chan#ed files accordin# to the selected filesynchronization mode. ,ll sync actions are performed on'the'fly8 witho/t readin# or writin#any file system state files or data6ases and therefore periodic file synchronization commandsare capa6le of synchronizin# h/#e file systems containin# millions of files very effectively while/sin# a very small amo/nt of system memory and C! reso/rces.


25/38


2)

!eriodic file synchronization commands provide m/ltiple one'way and two'way filesynchronization modes with each one desi#ned for specific needs and /sa#e scenarios. Inorder to chan#e the file synchronization mode for a periodic file synchronization command8open the command A ditA pa#e and select an appropriate file synchronization mode.

!eriodic file synchronization commands s/pport the followin# file synchronization modes?


U$date estination irector 9one'way; ' 0ewly created and modified so/rce fileswill 6e copied to the destination directory. Files deleted from the so/rce directory will6e deleted from the destination directory. Files deleted from the destination directorywill 6e restored /sin# files from the so/rce directory. 0ewly created and modifieddestination files will 6e ept in place. 0o chan#es will 6e made in the so/rce directory.

#ccu*ulate and U$date Files in estination 9one'way; ' 0ewly created andmodified so/rce files will 6e copied to the destination directory. Files deleted from thedestination directory will 6e restored /sin# files from the so/rce directory. 0ewly

created and modified destination files will 6e ept in place. 0o files will 6e deletedfrom the destination directory. 0o chan#es will 6e made in the so/rce directory. wo'&a File S nc roni ation ' 0ewly created and modified files will 6e

synchronized in 6oth directions. Files deleted from the so/rce directory will 6e deletedfrom the destination directory. Files deleted from the destination directory will 6erestored from the so/rce directory. Chan#es may 6e made in 6oth locations. ,fter thefile synchronization process is complete 6oth locations will 6e identical.



26/38


2

!eriodic file synchronization commands may 6e a/tomatically tri##ered /sin# one or moreperiodic8 daily8 wee ly or monthly sync tri##ers. In order to confi#/re sync tri##ers for aperiodic file synchronization command8 open the command A ditA pa#e and press the ATri##ersA6/tton. The ASync Tri##ersA pa#e shows the c/rrently confi#/red sync tri##ers and allows oneto add8 delete8 ena6le8 disa6le and confi#/re an /nlimited n/m6er of sync tri##ers.

In order to add a new sync tri##er for a periodic file synchronization command8 press the A,ddTri##erA 6/tton8 select a tri##er type8 specify all the re>/ired parameters and press the A,ddA6/tton. In order to chan#e a previo/sly confi#/red sync tri##er8 clic on the tri##erAs A ditA6/tton located in the AToolsA col/mn.

Simple periodic sync tri##ers provide the a6ility to exec/te a sync command every B min/tesor ho/rs. *aily sync tri##ers provide the a6ility to exec/te a sync command every day at aspecified time. In order to exec/te a sync command twice per day at different times8 the /sercan add two daily tri##ers with each one confi#/red to tri##er the sync command at a differenttime. 5ee ly tri##ers provide the a6ility to specify days of wee 9from 1 to " delimited 6y thecomma character; and a time of the day to exec/te the sync command. /ltiple wee lytri##ers may 6e /sed to exec/te the sync command at different times on different wee days.In addition8 /sers are provided with monthly sync tri##ers allowin# one to exec/te a synccommand on specific days of month. Finally8 IronSync provides a sin#le time sync tri##erallowin# one to exec/te a sync command one time only at a specified date and time.


27/38


2"

4.4 /eal' i*e irector S nc roni ation !o**ands

&eal'Time directory synchronization commands synchronize chan#ed directories on'the'fly asfiles are chan#in# in the so/rce directory. IronSync Server monitors the so/rce directory8 inreal'time detects chan#ed s/6directories and performs short sync operations 6etweens/6directories witho/t scannin# the complete directory tree. The /ser is provided with five

different one'way and two'way file synchronization modes. F/ll scannin# of the so/rce anddestination directories is never performed and file synchronization is completed in real'time6etween pairs of chan#ed s/6directories.

In order to chan#e the file synchronization mode for a file synchronization command8 open thefile synchronization command confi#/ration pa#e and select one of the followin# filesynchronization modes?


U$date estination irector 9one'way; ' 0ewly created and modified so/rce fileswill 6e copied to the destination directory. Files deleted from the so/rce directory will6e deleted from the destination directory. Files deleted from the destination directory

will 6e restored /sin# files from the so/rce directory. 0ewly created and modifieddestination files will 6e ept in place. 0o chan#es will 6e made in the so/rce directory.

#ccu*ulate and U$date Files in estination 9one'way; ' 0ewly created andmodified so/rce files will 6e copied to the destination directory. Files deleted from thedestination directory will 6e restored /sin# files from the so/rce directory. 0ewlycreated and modified destination files will 6e ept in place. 0o files will 6e deletedfrom the destination directory. 0o chan#es will 6e made in the so/rce directory.




28/38


2$

4.% #dvanced File S nc roni ation !o**ands O$tions

In order to access advanced file synchronization command options8 clic on the A ditCommandA 6/tton located on the ri#ht side of the file synchronization command and press theA,dvanced -ptionsA 6/tton. The advanced options pa#e allows one to specify one or moreexcl/de directories8 set the n/m6er of file synchronization streams to /se for the command8

set/p a c/stom error lo#s directory to save error reports and=or send ' ail notifications whenthe command is a6orted d/e to a hardware pro6lem.

,nother very /sef/l feat/re is the sync preview mode8 which may 6e ena6led for any filesynchronization command on the advanced options pa#e. In the preview mode8 IronSync willmonitor the so/rce directory8 examine all detected file system chan#es and calc/late theexpected chan#e rate witho/t performin# any actions in the destination directory. This modeallows one to analyze a fre>/ently chan#in# file system and estimate expected performancere>/irements in order to properly select a fast eno/#h 6ac /p device to 6e /sed as adestination directory for a file synchronization command.

IronSync Server provides the a6ility to perform initial file synchronization for static filesexisted in the so/rce directory 6efore the file synchronization command was started for thefirst time. In order to ena6le initial file synchronization for a sync command8 open the main

command pa#e and select the A na6le Initial File SynchronizationA option. :y defa/lt8 initial filesynchronization is performed when the IronSync server is idle8 pa/sed when a lar#e n/m6er ofreal'time sync actions sho/ld 6e performed and a/tomatically res/med when the n/m6er ofpendin# sync actions drops 6elow a /ser'confi#/ra6le limit.

The AInitial Sync Start LimitA option sets the n/m6er of pendin# file system chan#es or pendin#sync actions tri##erin# the start of the initial file synchronization operation. The AInitial SyncStop LimitA option sets the n/m6er of pendin# file system chan#es or pendin# sync actionstri##erin# the stop of the initial file synchronization operation. For example8 when the n/m6erof pendin# sync actions drops 6elow the start limit8 the initial file sync operation is res/medand when the n/m6er of pendin# actions raises a6ove the stop limit8 the initial sync operationis pa/sed.


29/38


2(

4.- S nc roni ing S$eci)ic $es o) Files

Sometimes8 it may 6e re>/ired to synchronize files related to a specific file type or cate#oryaccordin# to /ser'specific needs while s ippin# all other files. IronSync Server allows one tospecify which types of files sho/ld 6e synchronized 6y a file synchronization command. The/ser is provided with the a6ility to synchronize files 6y the file name8 extension8 directory8 file

type8 size8 text or 6inary patterns8 etc.

For example8 IronSync Server allows one confi#/re a file synchronization command to sync alltypes of doc/ments with the file size more than 1+ : and the file name 6e#innin# withAI&-0SG0CA while s ippin# all other files not matchin# the specified r/les. In order to confi#/re

file matchin# r/les for a command8 open the command pa#e and press the A&/lesA 6/tton. -nthe A&/lesA pa#e press the A,dd &/leA 6/tton8 select an appropriate r/le type8 operator8 a r/leval/e and press the ASaveA 6/tton.

IronSync Server allows one to add an /nlimited n/m6er of file matchin# r/les for each filesynchronization command with each one confi#/red to match files 6y a specific file property.In addition8 advanced /sers are provided with the a6ility confi#/re an /nlimited n/m6er ofhierarchical nested r/les com6ined with lo#ical operators and allowin# one to precisely selecttypes of files that sho/ld 6e synchronized.


30/38


3+

4., File S nc roni ation O$tions

,dditional file synchronization options may 6e controlled on the AFile Sync -ptionsA pa#e. Inorder to open the file synchronization options pa#e open the file synchronization commandpa#e and press the A-ptionsA 6/tton.

S nc File #ttributes ' select this option if yo/ wish to sync file attri6/tes for all files

copied from the so/rce to the destination directory 96y defa/lt this option is ena6led;. S nc User>"rou$ Securit escri$tor ' select this option if yo/ wish to copy file

ownership information for all files copied from the so/rce to the destination directory96y defa/lt this option is disa6led;.

S nc iscretionar #ccess !ontrol +ists @ #!+A ' select this option if yo/ wish tocopy *,CLs for all files copied from the so/rce to the destination directory 96y defa/ltthis option is disa6led;.

S nc S ste* #ccess !ontrol +ist @S#!+A ' select this option if yo/ wish to copyS,CLs for all files copied from the so/rce to the destination directory 96y defa/lt thisoption is disa6led;.

S=i$ S ste* Files and irectories ' select this option if yo/ wish to s ip all systemfiles and directories from the file synchronization process 96y defa/lt this option isena6led;.

S=i$ Bidden Files and irectories ' select this option if yo/ wish to s ip all hiddenfiles and directories from the file synchronization process 96y defa/lt this option isena6led;.

(it'+evel File S nc roni ation ' select this option if yo/ wish to copy only chan#eddata 6loc s for files that sho/ld 6e synchronized 96y defa/lt this option is disa6led;.

Veri) Files #)ter !o$ ' select this option if yo/ wish to verify each file copied tothe destination directory 96y defa/lt this option is disa6led;.

H ,ll sec/rity related options re>/ire administrative privile#es and the IronSync service needsto 6e confi#/red to r/n /nder a /ser acco/nt havin# eno/#h permissions to access all there>/ired networ shares and perform *,CL and S,CL copy operations.


31/38


31

4. 56cluding irectories Fro* File S nc roni ation

Sometimes8 it may 6e re>/ired to excl/de one or more s/6directories from the filesynchronization process. For example8 if yo/ need to synchronize two directories excl/din#one or two special s/6directories8 yo/ may specify the top level directories as the so/rce anddestination directories and add the s/6directories that sho/ld 6e s ipped to the excl/de list.

In order to add one or more directories to the excl/de list8 open the file synchronizationcommand confi#/ration pa#e8 press the A,dvanced -ptionsA 6/tton and add one or moredirectories to the excl/de directories list separated 6y the semicolon 9 ; character. ,ll files ands/6directories located in the specified excl/de directories will 6e excl/ded from the filesynchronization process.

In addition8 advanced /sers are provided with a n/m6er of excl/de directories macrocommands allowin# one to excl/de m/ltiple directories /sin# a sin#le macro command.IronSync Server provides the followin# excl/de directories macro commands?

7(5"I8S 9 e6t String: ' this macro command excl/des all directories 6e#innin#with the specified text strin#.

7!O8 #I8S 9 e6t String: ' this macro command excl/des all directoriescontainin# the specified text strin#.

758 S 9 e6t String: ' this macro command excl/des all directories endin# with thespecified text strin#.

7/5"5; 9/egular 56$ression: ' this macro command excl/des directoriesmatchin# the specified re#/lar expression.

For example8 the excl/de macro command A C-0T,I0S Temporary FilesA will excl/de alldirectories with ATemporary FilesA at any place in the f/ll directory path and the excl/de macrocommand A & < B D.9T !ET !; A will excl/de directories endin# with A.T !A or A.T !A.


32/38


32

4.< !on)iguring IronS nc Server

IronSync Server provides a variety of confi#/ration options allowin# one to easily inte#rate theprod/ct into a /ser'specific networ environment. In order to open the main settin#s pa#e8clic on the ASettin#sA lin located on the top men/ 6ar.

4.10 !on)iguring User 8a*e and Password

The IronSync Server we6'6ased mana#ement console8 re>/ires /sers to lo#in with a IronSync/ser name and password. The defa/lt /ser name and password is set to? ad*in =ad*in . In

addition8 IronSync Server provides the a6ility to set a c/stom /ser name and=or password forthe IronSync we6'6ased mana#ement interface and the command line /tility8 which may 6e/sed to a/tomate confi#/ration and mana#ement tas s.

In order to set a c/stom /ser name and password8 clic on the AConfi#/re Server Lo#inA linlocated on the main settin#s pa#e8 enter a new /ser name and password and press the ASaveA6/tton.


33/38


33

4.11 !on)iguring 5rror Bandling O$tions

IronSync Server provides a n/m6er of advanced error handin#8 recovery and notificationoptions. In order to open the error handlin# pa#e8 #o to the main settin#s pa#e and clic onthe ALo#s and 0otificationsA lin .

*efa/lt error handlin# settin#s sho/ld 6e #ood eno/#h for most /sers8 6/t if re>/ired8 the /seris provided with the a6ility to c/stomize the maxim/m n/m6er of errors per sync command8the maxim/m n/m6er of consec/tive errors8 the maxim/m n/m6er of retries to perform foreach loc ed file and the initial retry delay.

In addition8 IronSync Server provides the a6ility to set a #lo6al lo#s directory and=or a #lo6alnotification ' ail address to send notifications a6o/t failed file synchronization commands. Ifthe #lo6al lo#s directory and=or error notifications are ena6led8 IronSync will save error lo#sand=or send notifications for all failed file synchronization commands. File synchronizationcommands explicitly confi#/red to save error lo#s to a different directory and=or sendnotifications to a different ' ail address ta e precedence over the #lo6al settin#s.


34/38


3%

4.12 !on)iguring Server !ontrol and &eb #ccess Ports

IronSync Server /ses the TC!=I! port (1%2 as the defa/lt server control port and the TC!=I!port $+ as the defa/lt we6 access port. Sometimes8 these ports may 6e in /se 6y some othersoftware prod/cts or system services. If one or 6oth of these ports are in /se8 IronSync will 6e/na6le to operate properly and the /ser needs to chan#e the IronSync server control port

and=or we6 access port.

In order to set a c/stom server control port and=or we6 access port8 clic on the ASet/p Server!ortsA lin located on the main settin#s pa#e8 select the A se C/stom !ortA option and enter ac/stom port n/m6er to /se. If the IronSync server sho/ld 6e controlled thro/#h the networ 8ma e s/re the c/stom ports are open in the serverAs firewall.

4.13 !on)iguring 5'Mail 8oti)ications

IronSync Server provides the a6ility to send ' ail notifications when a file synchronizationcommand fails d/e to a hardware pro6lem. In order to confi#/re an S T! ' ail server to /seto send ' ail notifications8 clic on the AConfi#/re ' ail ServerA lin located on the mainsettin#s pa#e8 enter the S T! server host name8 S T! server port8 S T! /ser name8password and the so/rce ' ail address to /se to send ' ail notifications.


35/38


36/38


3

4.1% O5M Product Version

Flexense provides system inte#rators8 val/e'added distri6/tors and IT service providers withthe a6ility to resell IronSync Server and=or provide services 6ased on the prod/ct /nder third'party 6rand names. &esellers and inte#rators are provided with the a6ility to chan#e theprod/ct name8 the prod/ct we6 site address8 the prod/ct vendor name and the prod/ct vendor

we6 site address.

In order to 6e a6le to set c/stom - prod/ct and vendor information8 the /ser needs tore#ister the prod/ct /sin# a special - ' na6led /nloc ey8 which may 6e p/rchased on theprod/ct p/rchase pa#e. -nce the prod/ct is re#istered /sin# an - /nloc ey8 open theA,6o/tA pa#e8 press the ASet - InfoA 6/tton8 specify yo/r c/stom - prod/ct and vendorinformation and press the ASaveA 6/tton.

C/stom - prod/ct and vendor information will 6e displayed on all pa#es of the IronSyncwe6'6ased mana#ement interface8 in all types of reports #enerated 6y the prod/ct and allnotification ' ail messa#es sent 6y IronSync Server.


37/38


38/38


- Su$$orted O$erating S ste*s

32'(it O$erating S ste*s

5indows B! 5indows 7ista 5indows " 5indows $ 5indows Server 2++3 5indows Server 2++$ 5indows Server 2+12

-4'(it O$erating S ste*s

5indows B! %':it 5indows 7ista %':it 5indows " %':it

5indows $ %':it 5indows Server 2++3 %':it 5indows Server 2++$ %':it 5indows Server 2+12 %':it

, S ste* /e uire*ents

Mini*al S ste* !on)iguration

S/pported -peratin# System Sin#le Core 1

ironsync file synchronization server

Documents