SynchronEX for Linux & Windows Version 4.0.5 Powerful multi-directional file synchronizer with backup & network options. Supports: Local Paths, ZIP, SFTP/SSH2, FTP, FTPS/TLS, WebDAV/HTTP(S) & more Main features: Simulation mode; Collision detection; True synchronization of removed files & directories; Multi-directional synchronization (more than 2 locations); Super projects with configuration inheritance; Multi-Sync' projects; Sync' between nested directories; automatic journaling of changed & removed files ("XVS version tracking"); Logs & Statistics; Support for unicode filesystems; Bahavior can be extended, altered and subclassed by builtin Python OO script language. README for Linux ================ SynchronEX for Linux works in the same style as SynchronEX for Windows. The project script/config files are compatible. SynchronEX for Linux is a commandline-only tool so far. SynchronEX can be used up to 14 days as unregistered free trial. After that period you MUST PURCHASE A LICENSE. Software home page: http://xellsoft.com/SynchronEX.html Main documentation: http://xellsoft.com/synchronex_readme.html INSTALLATION ============ 1. SynchronEX for Linux is delivered as synchronex.tgz archive or synchronex-.tgz 2. Unpack it for example in /usr/local/lib and create a link in /usr/local/bin: cd /usr/local/lib tar xfz /downloadpath/synchronex.tgz cd /usr/local/bin ln -s /usr/local/lib/synchronex/synctree synctree 3. Usage on 64bit Linux: If the executable is not executed, you may have to install the "ia32" libraries. On Debian/Ubuntu for example this is done by: "aptitude install ia32-libs" or "apt-get install ia32-libs" 4. If you get an error about missing libssl0.9.8 upon program execution, then install libssl0.9.8 . On Debian style installations: "apt-get install libssl0.9.8" Or unpack http://www.xellsoft.com/download/libssl.zip into /usr/local/lib/tmailer/ or into one of the global lib folders like /usr/local/lib/ LICENCE KEY INSTALLATION (after free trial period) ======================== There are 2 alternative possibilities: Admin installation: create a file "/usr/local/lib/synchronex/sx_license.key" ("sx_license.key" next to the "synctree" binary). The file must contain the bare key string. User installation: run "synctree --regkey" interactively and enter/paste the license key string at the question mark. Or store the bare key in a keyfile and run "synctree --regkey < keyfile". GETTING STARTED =============== 1. Run 'synctree' or 'synctree --help' to see quick reference and version 2. Create a first sync-config script (or start with simple.syncpy) - e.g.: #/home/user/texts/my.syncpy roots=[ '/home/user/texts' , '/laptop/cc/texts' ] excludefiles_rel=['*.bak','bigfile.doc'] 3. Run 'synctree -s my.syncpy' for a simulation run 4. Run 'synctree my.syncpy' for an execution run 5. template.syncpy inside the .tgz archive is useful for starting a more complex script project. Find details in the manual : http://xellsoft.com/synchronex_readme.html 6. The Windows version of SynchronEX can be used to create project template scripts using the GUI Wizards. On Linux usually you'd only have to adapt the paths. UNIX SPECIFIC BEHAVIOUR ======================= By default SynchronEX doesn't follow symbolic links. Following smybolic links can be enabled by option "symlink_follow=1" in the project script (.syncpy) COMMANDLINE SYNTAX ================== Usage: synctree [OPTIONs] [PROJECTFILE] PROJECTFILE: project configuration file. e.g.: backup.syncpy OPTIONs / Examples: -s force simulation run; files are not really copied -z dont use default project file (OPTIONS only) -y use a sync database (prj.syncdb) and detect Y-collisions -o override (ignore) Y-collisions. Youngest file will be source -r /foo directory "/foo" is added to the sync roots -n0,2 1st and 3rd roots are not sources (backup/targets only) -e foo.c "foo.c" is added to excludefiles_rel -i foo.obj "foo.obj" is added to includefiles_rel -x tmp "tmp" is added to excludedirs_rel -k d/foo.tmp file "d/foo.tmp" will be deleted in all roots -d 1.2.02 set threshold date [thres_time=...] -t 13:20 set threshold time [thres_time=...] -v verbose list (incl. filemtime, size) -w / -W don't wait for ENTER at the end (-W : wait only if error) -l prj.slog short (easy parse) log file listing all source files & actions -L prj.log full log file (append mode) -+ sync file removals too [syncremove=1] -c read project file from console/stdin -p don't prompt for interactive questions, just exit with error -h small help --remove src.lst :remove files in the list! (create with '-l -s') --gui start the GUI --guirun start the GUI and run/simulate the project file --more wait after printing one page --help long help Find more details in manual: http://www.xellsoft.com/synchronex_readme.html