<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> <HTML> <HEAD> <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8"> <TITLE>luckyBackup - backup and sync utility</TITLE> <link rel="stylesheet" type="text/css" href="styles.css" /> <meta name="generator" content="Bluefish 2.0.3" > <META NAME="CREATED" CONTENT="0;0"> <META NAME="CHANGEDBY" CONTENT="Loukas Avgeriou"> <META NAME="CHANGED" CONTENT="20090504;22030700"> <META NAME="DESCRIPTION" CONTENT="luckyBackup is an application that backs-up and/or synchronizes any directories using the rsync tool."> <META NAME="KEYWORDS" CONTENT="luckyBackup, luckybackup, backup, sync, synchronize, rsync, qt, c++"> <META NAME="Info 1" CONTENT=""> <META NAME="Info 2" CONTENT=""> <META NAME="Info 3" CONTENT=""> <META NAME="Info 4" CONTENT=""> <META NAME="CHANGEDBY" CONTENT="Loukas Avgeriou"> <STYLE TYPE="text/css"> <!-- TD P { color: #000000 } H1 { color: #000000 } P { color: #000000 } DD { color: #000000 } DT { color: #000000 } --> </STYLE> </HEAD> <body> <div id="wrapper"> <div id="body" class="clear"> <div id="content"> <!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~` START PASTE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ --> <P ALIGN=CENTER><IMG SRC="data/luckybackup_320.png" NAME="luckyBackup logo" ALT="luckyBackup logo" ALIGN=MIDDLE WIDTH=320 HEIGHT=296 BORDER=0> </P> <P ALIGN=CENTER><FONT FACE="FreeSans, sans-serif"><BR><BR></FONT><BR><BR> </P> <H1 ALIGN=CENTER STYLE="border-top: none; border-bottom: 1px solid #000000; border-left: none; border-right: none; padding-top: 0cm; padding-bottom: 0.07cm; padding-left: 0cm; padding-right: 0cm"> <A NAME="top"></A> <FONT COLOR="#4c1900" FACE="FreeSans, sans-serif" SIZE=7 STYLE="font-size: 32pt"><B>user's manual</B></FONT><br></H1> <!-- <h3 align="center"><font color="#4c1900">please be a bit patient for a complete manual update</font></h3> --> <P><BR><BR> </P> <!-- ********************************* contents *******************************************************************--> <H1><A NAME="contents"></A><FONT COLOR="#800000"><FONT FACE="FreeSans, sans-serif">contents</FONT></FONT></H1> <UL> <LI><P ALIGN=LEFT><A HREF="#overview"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><B>overview - features</B></FONT></FONT></A></P> <LI><P ALIGN=LEFT><A HREF="#legal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><B>legal</B></FONT></FONT></A></P> <LI><P ALIGN=LEFT><A HREF="#definitions"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><B>definitions</B></FONT></FONT></A></P> </UL> <UL> <LI><P ALIGN=LEFT><A HREF="#waysToRun"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><B>launch</B></FONT></FONT></A></P> </UL> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#waysMenu"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>menu entries</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#waysArguments"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>terminal arguments</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#waysManPage"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>man page</B></FONT></FONT></A></P> <UL> <LI><P ALIGN=LEFT><A HREF="#mainWindow"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><B>the main window (...playing around)</B></FONT></FONT></A></P> </UL> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#MainTasks"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Tasks</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#MainProfiles"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Profiles</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#MainHelp"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Help</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#MainSettings"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Settings</B></FONT></FONT></A></P> <UL> <LI><P ALIGN=LEFT><A HREF="#propertiesSimple"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><B>task properties (the simple way)</B></FONT></FONT></A></P> </UL> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#OperationName"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>name</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#OperationType"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>type</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#OperationSource"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>source</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#OperationDestination"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>destination</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#OperationRemoteNot"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>cannot display remote places</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#OperationKeepSnapshots"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>snapshots</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#OperationDoneErrorsCheck"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>done</B></FONT></FONT></A></P> <UL> <LI><P ALIGN=LEFT><A HREF="#propertiesAdvanced"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><B>task properties (for the unsatisfied)</B></FONT></FONT></A></P> </UL> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#OperationAdvancedDescription"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>description</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#OperationAdvancedExclude"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>exclude</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#OperationAdvancedOnlyInclude"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>include</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#OperationAdvancedOptions"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>options</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#OperationAdvancedRemote"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>remote</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#OperationAdvancedAlsoExecute"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>also execute</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#OperationAdvancedValidate"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>validate</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#OperationAdvancedPatternRules"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>pattern rules</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#OperationAdvancedPatternEditor"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>pattern editor</B></FONT></FONT></A></P> <UL> <LI><P ALIGN=LEFT><A HREF="#notReady"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><B>not just ready yet</B></FONT></FONT></A></P> </UL> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#NotReadyIncludeState"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>include state</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#startDeclaredDataCheck"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>declared data check</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#NotReadyExecutionOrder"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>execution order</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#NotReadySaveProfile"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>save profile</B></FONT></FONT></A></P> <UL> <LI><P ALIGN=LEFT><A HREF="#purpleButton"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><B>run</B></FONT></FONT></A></P> </UL> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#startDryRun"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>simulation</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#startOperationsListCheck"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>task list check</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#rsyncIt"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>normal run</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#silentMode"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>silent mode</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#terminal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>command-line mode</B></FONT></FONT></A></P> <UL><LI><P ALIGN=LEFT><A HREF="#cronIt"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><B>schedule</B></FONT></FONT></A></P></UL> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#cronItAdd"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>add</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#cronItModify"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>modify</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#cronItRemove"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>remove</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#cronItCronIt"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>cronIT</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#cronItCrontabInfo"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>crontab info</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#cronItTroubleshoot"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>troubleshooting cron</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#cronItLogFile"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>log-file</B></FONT></FONT></A></P> <UL><LI><P ALIGN=LEFT><A HREF="#email"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><B>e-mail</B></FONT></FONT></A></P></UL> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#emailCommand"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>command</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#emailConditions"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>conditions</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#emailArguments"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>arguments</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#emailTest"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>test</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#emailLogfile"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>logging</B></FONT></FONT></A></P> <UL> <LI><P ALIGN=LEFT><A HREF="#manageMain"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><B>manage backup/sync</B></FONT></FONT></A></P> </UL> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#manageLogViewer"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>view log</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#manageCalcDifs"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>calculate differences</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#manageDelete"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>delete backup</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#manageRestore"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>restore</B></FONT></FONT></A></P> <UL> <LI><P ALIGN=LEFT><A HREF="#restore"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><B>restore procedures</B></FONT></FONT></A></P> </UL> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#restoreWizard"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>manage wizard</B></FONT></FONT></A></P> <P ALIGN=LEFT STYLE="margin-left: 75"><A HREF="#restoreTask"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>separate task</B></FONT></FONT></A></P> <UL> <LI><P ALIGN=LEFT><A HREF="#thanks"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><B>Epilogue</B></FONT></FONT></A></P> </UL> <P ALIGN=LEFT STYLE="border-top: none; border-bottom: 1px solid #000000; border-left: none; border-right: none; padding-top: 0cm; padding-bottom: 0.07cm; padding-left: 0cm; padding-right: 0cm"> <A NAME="overview"></A> <!-- ********************************* overview *******************************************************************--> <BR><BR> </P> <H1><A HREF="#top" NAME="Go up"><IMG SRC="data/up.png" NAME="graphics2" ALT="go up" ALIGN=LEFT WIDTH=24 HEIGHT=24 BORDER=0><BR CLEAR=LEFT></A><FONT COLOR="#800000"> <!-- ********************************* overview *******************************************************************--> <FONT FACE="FreeSans, sans-serif">overview – features</FONT></FONT></H1> <P ALIGN=LEFT STYLE="margin-bottom: 0.2cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>luckyBackup</B></FONT></FONT> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>is an application that </FONT></FONT><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><U>backs-up</U></FONT></FONT> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>and/or </FONT></FONT><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><U>synchronizes</U></FONT></FONT> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>any directories with the power of <A HREF="http://samba.anu.edu.au/rsync/" TARGET="_blank">rsync</A></FONT></FONT><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><SPAN STYLE="font-weight: normal">.</SPAN></FONT></FONT></P> <P ALIGN=LEFT STYLE="margin-bottom: 0.2cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><SPAN STYLE="font-weight: normal">It is </SPAN></FONT><FONT SIZE=3><B>simple to use</B></FONT><FONT SIZE=3><SPAN STYLE="font-weight: normal">, </SPAN></FONT><FONT SIZE=3><B>fast </B></FONT><FONT SIZE=3><SPAN STYLE="font-weight: normal">(transfers over only changes made and not all data), </SPAN></FONT><FONT SIZE=3><B>safe</B></FONT> <FONT SIZE=3><SPAN STYLE="font-weight: normal">(keeps your data safe by checking all declared directories before proceeding in any data manipulation</SPAN></FONT> <FONT SIZE=3><SPAN STYLE="font-weight: normal">), </SPAN></FONT><FONT SIZE=3><B>reliable</B></FONT> <FONT SIZE=3><SPAN STYLE="font-weight: normal">and fully </SPAN></FONT><FONT SIZE=3><B>customizable</B></FONT><FONT SIZE=3><SPAN STYLE="font-weight: normal">.</SPAN></FONT></FONT></P> <P ALIGN=LEFT STYLE="margin-bottom: 0.2cm"><BR><BR> </P> <P ALIGN=LEFT STYLE="margin-bottom: 0.2cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Backup</B></FONT></FONT></P> <P><FONT FACE="FreeSans, sans-serif">Create a <B>"clone" of your data at another location in no time, safely</B>.<BR><BR>Backup any directory (source) to another (destination).<BR><BR>luckyBackup copies over only the changes you've made to the source directory and nothing more.<BR>You will be surprised when your huge source is backed up in seconds (after the first time !!). <BR><BR>Whatever changes you make to the source including adding, moving, deleting, modifying files / directories etc, will have the same effect to the destination. <BR><BR>Owner, group, time stamps, links and permissions of files are preserved (unless stated otherwise).</FONT></P> <P><FONT FACE="FreeSans, sans-serif"><B>Snapshots</B><BR>Create multiple backup "snapshots". <BR><BR>Each snapshot is an image of the source data that refers to a specific date-time.<br><br> Rolling back to any of the snapshots is possible.</FONT></P> <P><FONT FACE="FreeSans, sans-serif"><B>Sync</B><BR>Sync any directories keeping the files that were most recently modified on both of them. <BR><BR>Useful if you modify files on more than one PCs (using a flash-drive and don't want to bother remembering what did you use last.</FONT></P> <P><FONT FACE="FreeSans, sans-serif"><B>Keep your data safe</B><BR>luckyBackup first checks whether the directories you've declared exist or if they are empty and warns you accordingly. <BR><BR>You wouldn't want your 500GB music collection backup (that took half a day to create !!) vanish in a second if you forgot to mount the external drive that your source is in !! <BR>You also wouldn't want to execute an rsync command if your destination folder is in an external drive that you also forgot to mount. </FONT> </P> <P><FONT FACE="FreeSans, sans-serif"><B>Simple / advanced option</B><BR>The add/modify task dialog is quite simple and everybody can use it with confidence.<BR>Hit on the "advanced" pushbutton at the task properties window and a whole bunch of other options will appear.<BR>If you know what you're doing change anything at will.</FONT></P> <P><FONT FACE="FreeSans, sans-serif"><B>Exclude option</B><BR>Exclude any file, folder or pattern from the transfer.<BR>You might not want to copy over backup files (*~), trash folders, system mount folders (/media & /mnt), some huge video files or anything else.<br><br> Choose from already made templates or produce your own with the cool pattern editor.</FONT></P> <P><FONT FACE="FreeSans, sans-serif"><B>Only include option</B><BR>Use this option to only transfer over specific file(s), folder(s) or pattern(s) within your source directory and nothing else.</FONT></P> <P><FONT FACE="FreeSans, sans-serif"><B>Add/remove any rsync option</B><BR>If you don't like the default rsync options that luckybackup uses, add or remove any option you wish.</FONT></P> <P><FONT FACE="FreeSans, sans-serif"><B>Remote connections</B><BR>Remote connections are possible, either for use as a source or as a destination.</FONT></P> <P><FONT FACE="FreeSans, sans-serif"><B>Also execute</B> <BR>You can execute any command(s) before or after a specific task.</FONT></P> <P><FONT FACE="FreeSans, sans-serif"><B>Restore task</B><BR>Everybody wishes to never use this !!<BR>But when this time comes, luckyBackup gives you the option to either go through a restore wizard or create a task based on an existing one for restore purposes.</FONT></P> <P><FONT FACE="FreeSans, sans-serif"><B>Simulation option</B><BR>If you are unsure of the effects on your data when executing an rsync command try the dry-run option. luckyBackup will perform a trial run that doesn't make any changes (and produces mostly the same output as a real run).<BR>Note: The progress-bar might be misleading when using this.</FONT></P> <P><FONT FACE="FreeSans, sans-serif"><B>Profiles</B><BR>You don't have to create all tasks from scratch every time you start luckyBackup.<br>You can save your preferences in a .profile file and load it whenever needed. Use as many profiles as you like, export, import or duplicate them.</FONT></P> <P STYLE="margin-bottom: 0cm"><FONT FACE="FreeSans, sans-serif"> <B>Include option – Execution order</B><BR>A separate check-box can be used to include or not a task within a profile.</FONT></P> <P><FONT FACE="FreeSans, sans-serif">The option to change the execution order of tasks is also given.</FONT></P> <P STYLE="margin-bottom: 0cm"><FONT FACE="FreeSans, sans-serif"><B>Scheduling</B></FONT></P> <P><FONT FACE="FreeSans, sans-serif">Scheduling for execution of already created profiles via cronjobs is supported.</FONT></P> <P><FONT FACE="FreeSans, sans-serif"> <P STYLE="margin-bottom: 0cm"><FONT FACE="FreeSans, sans-serif"><B>e-mail</B></FONT></P> <P><FONT FACE="FreeSans, sans-serif">email a report after a profile execution.</FONT></P> <P><FONT FACE="FreeSans, sans-serif"> <B>Logfile</B><BR>After all tasks execution, a logfile is created in your home folder. You can have a look at it any time you want.<br><br> A handy logviewer that displays errors in red and has next/previous buttons, is also provided.</FONT></P> <P><FONT FACE="FreeSans, sans-serif"><B>Command line mode</B><BR>luckyBackup can run in command line if you wish not to use the gui, but you have to first create the profile that is going to be executed.<BR>Type "luckybackup --help" at a terminal to see usage and supported options.</FONT></P> <P><BR><BR> </P> <P STYLE="border-top: none; border-bottom: 1px solid #000000; border-left: none; border-right: none; padding-top: 0cm; padding-bottom: 0.07cm; padding-left: 0cm; padding-right: 0cm"> <A NAME="legal"></A> <BR><BR> </P> <P STYLE="margin-bottom: 0.3cm"><BR><BR> </P> <H1 STYLE="margin-top: 0.22cm"><A HREF="#top"><IMG SRC="data/up.png" NAME="#TOP" ALIGN=LEFT WIDTH=24 HEIGHT=24 BORDER=0><BR CLEAR=LEFT></A><FONT COLOR="#800000"><!-- ********************************* legal *******************************************************************--><FONT FACE="FreeSans, sans-serif">legal</FONT></FONT></H1> <P STYLE="margin-top: 0.92cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Copyright © 2008, Loukas Avgeriou<BR><BR><A HREF="http://www.gnu.org/copyleft/gpl.html" TARGET="_blank"><IMG SRC="data/gpl.png" NAME="gpl" ALIGN=BOTTOM WIDTH=60 HEIGHT=20 BORDER=0></A> luckyBackup is distributed under the terms of the <A HREF="http://www.gnu.org/copyleft/gpl.html" TARGET="_blank">GNU General Public License.</A><BR><BR>It is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 3 of the License.<BR><BR>It is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.</FONT></FONT></P> <P STYLE="margin-top: 0.92cm; border-top: none; border-bottom: 1px solid #000000; border-left: none; border-right: none; padding-top: 0cm; padding-bottom: 0.07cm; padding-left: 0cm; padding-right: 0cm"> <A NAME="definitions"></A> <BR><BR> </P> <P STYLE="margin-top: 0.42cm; margin-bottom: 0.2cm; background: transparent; page-break-after: avoid"> <A HREF="#top"><IMG SRC="data/up.png" NAME="graphics1" ALIGN=LEFT WIDTH=24 HEIGHT=24 BORDER=0><BR CLEAR=LEFT></A><FONT COLOR="#800000"><!-- ********************************* definitions *******************************************************************--><FONT FACE="FreeSans, sans-serif"><FONT SIZE=6><B>definitions</B></FONT></FONT></FONT></P> <P><BR><BR> </P> <P><FONT FACE="FreeSans, sans-serif">Before we proceed to any description or instructions, it would be useful to first make some definitions:</FONT></P> <P STYLE="margin-top: 0.42cm; margin-bottom: 0.2cm; background: transparent; page-break-after: avoid"> <BR><BR> </P> <TABLE WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0> <COL WIDTH=35*> <COL WIDTH=221*> <TR VALIGN=TOP> <TD WIDTH=14%> <P ALIGN=LEFT STYLE="margin-top: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>task</B></FONT></FONT></P> </TD> <TD WIDTH=86%> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>For example the task of backing up one directory to another. The basic properties of a task are:</FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>a. Its <B>name</B> (for example “backup my home directory”).</FONT></FONT></P> <P STYLE="margin-top: 0.1cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>b. Its <B>include</B> state which actually says if the task will be executed or not.</FONT></FONT></P> </TD> </TR> <TR VALIGN=TOP> <TD WIDTH=14%> <P ALIGN=LEFT STYLE="margin-top: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>source</B></FONT></FONT></P> </TD> <TD WIDTH=86%> <P STYLE="margin-top: 0.1cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>The directory that holds the data to be backed-up.</FONT></FONT></P> </TD> </TR> <TR VALIGN=TOP> <TD WIDTH=14%> <P ALIGN=LEFT STYLE="margin-top: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>destination</B></FONT></FONT></P> </TD> <TD WIDTH=86%> <P STYLE="margin-top: 0.1cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>The directory that source will be backed-up to.</FONT></FONT></P> </TD> </TR> <TR VALIGN=TOP> <TD WIDTH=14%> <P ALIGN=LEFT><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>profile</B></FONT></FONT></P> </TD> <TD WIDTH=86%> <P STYLE="font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>A collection of tasks at a particular order.</FONT></FONT></P> </TD> </TR> <TR VALIGN=TOP> <TD WIDTH=14%> <P ALIGN=LEFT><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>snapshot</B></FONT></FONT></P> </TD> <TD WIDTH=86%> <P STYLE="font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Backup data that refer to the source at a particular time. Just like a photo snapshot that captured a face at a specific time.</FONT></FONT></P> </TD> </TR> <TR VALIGN=TOP> <TD WIDTH=14%> <P ALIGN=LEFT><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>schedule</B></FONT></FONT></P> </TD> <TD WIDTH=86%> <P STYLE="font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>A profile that is scheduled to be executed at a specific time, at a specific day.</FONT></FONT></P> </TD> </TR> <TR VALIGN=TOP> <TD WIDTH=14%> <P ALIGN=LEFT><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>super-user mode</B></FONT></FONT></P> </TD> <TD WIDTH=86%> <P STYLE="font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>The execution of luckyBackup with super-user privileges.</FONT></FONT></P> </TD> </TR> <TR VALIGN=TOP> <TD WIDTH=14%> <P ALIGN=LEFT><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Command-line mode</B></FONT></FONT></P> </TD> <TD WIDTH=86%> <P STYLE="font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>The execution of luckyBackup without a graphical user interface (gui), by using a terminal.</FONT></FONT></P> </TD> </TR> <TR VALIGN=TOP> <TD WIDTH=14%> <P ALIGN=LEFT><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Silent mode</B></FONT></FONT></P> </TD> <TD WIDTH=86%> <P STYLE="font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>The execution of luckyBackup without launching the main window - just tray notification shown.</FONT></FONT></P> </TD> </TR> </TABLE> <!-- ******************************************** launch ******************************************************************************** --> <P STYLE="margin-top: 0.42cm; margin-bottom: 0.2cm; background: transparent"> <BR><BR> </P> <P STYLE="margin-top: 0.42cm; margin-bottom: 0.2cm; background: transparent; border-top: none; border-bottom: 1px solid #000000; border-left: none; border-right: none; padding-top: 0cm; padding-bottom: 0.07cm; padding-left: 0cm; padding-right: 0cm"></p> <A NAME="waysToRun"></A> <p><BR><BR></P> <H1><A HREF="#top"><IMG SRC="data/up.png" NAME="graphics3" ALIGN=LEFT WIDTH=24 HEIGHT=24 BORDER=0><BR CLEAR=LEFT></A><FONT COLOR="#800000"> <FONT FACE="FreeSans, sans-serif">launch</FONT></FONT></H1> <P><BR></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3> After this (small I hope) introduction, It is now time to launch luckyBackup.<br> It is always a good thing to have multiple options and the ability to choose.<br> That is why, there are various ways to do that:<br> </P> <p><BR></P> <A NAME="waysMenu"></a> <P STYLE="margin-bottom: 0cm"><FONT COLOR="#000080"><FONT FACE="FreeSans, sans-serif"> <FONT SIZE=4><B>Menu</B></FONT></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><BR>The easiest way to launch luckyBackup is by using your operating system's menu items.<br> Please note that 2 items are created.</FONT></FONT><br><br></P> <A NAME="waysNormal"></A> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"> <FONT SIZE=3><B>Normal user</B></FONT></FONT></FONT><br><br></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/menu_LinkNormal.png" NAME="menu_LinkNormal" ALIGN=MIDDLE BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"><br><br> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><BR>The first one is used to launch luckyBackup as a normal user.<br> This is created under Utilities (kde) or Accessories (Gnome) or Applications -> File Management (Debian menu).<br><br> <b>Use this method, if the normal user has full read access to the source and full write access to the destination.</b> </FONT></FONT></P> <P><BR><BR> </P> <A NAME="waysRoot"></A> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"> <FONT SIZE=3><B>Super user</B></FONT></FONT></FONT><br><br></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/menu_LinkRoot.png" NAME="menu_LinkRoot" ALIGN=MIDDLE BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"><br><br> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><BR>The second one is used to launch luckyBackup as a super-user.<br> This is created under System (kde) or System Tools (Gnome) or Applications -> System -> Administration (Debian menu).<br> Fedora users, must install the "beesu" package to use the system menu link.<br><br> <b>Use this method, if the normal user has limited read access to the source or limited write access to the destination.</b> </FONT></FONT></P> <P><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <font size=3 color="#FF0000" face="FreeSans, sans-serif">IMPORTANT</FONT>:<br> <font size=3 face="FreeSans, sans-serif"> luckyBackup copies files preserving their owner, group, times, permissions and attributes.<br> You <b>should</b> run it with su privileges if you want to <ul> <li>transfer data that a normal user has no or limited authorization on.</li> <li>transfer data to a place that a normal user has no or limited authorization on.</li> </ul> </font></P> <p><BR></P> <A NAME="waysArguments"></a> <P STYLE="margin-bottom: 0cm"><FONT COLOR="#000080"><FONT FACE="FreeSans, sans-serif"> <FONT SIZE=4><B>Terminal arguments</B></FONT></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><BR>luckyBackup can also be launched by using a terminal (console).<br> The full syntax of the command used is :<br></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=2><B><SPAN STYLE="background: #99ccff">$ luckybackup [options] [profile]</SPAN></B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><BR>If <b>no</b> <a href="#waysArgumentsOptions">options</a> or <a href="#waysArgumentsProfile">profile</a> is provided, the <a href="#mainWindow">main window</a> will show, the same way as if you used the <a href="#waysMenu">menu items</a> .<br></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><BR> Launching with <a href="#waysRoot">super-user privileges</a>, is possible by using normal bash commands to gain root access.<br>eg </FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=2><B><SPAN STYLE="background: #99ccff">$ sudo luckybackup [options] [profile]</SPAN></B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>or</FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=2><B><SPAN STYLE="background: #99ccff">$ su root<br> Password: XXXXXXX<br> # luckybackup [options] [profile]</SPAN></B></FONT></FONT></P> <A NAME="waysArgumentsProfile"></a> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"> <FONT SIZE=3><B>[profile]</B></FONT></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"> ... is an already created profile that is going to be executed instantly, either in <a href="#mainWindow">gui</a> or <a href="#terminal">command-line mode</a>, depending on the options provided.<br> Profile files are normaly located under your home directory (<b>~</b>) at <b>~/.luckyBackup/profiles</b>.<br> NOTE that the root's home directory is <b>/root</b>.<br> As <b>[profile]</b> you can use : <ul> <li>the full path of the profile filename.<br> eg: <b>~/.luckyBackup/profiles/default.profile</b></li> <li>The profile filename without using its full path.<br> Then, luckyBackup will search at the normal profiles location, under the home directory of the current user.<br> eg: <b>default.profile</b></li> <li>The profile name.<br> Again, luckyBackup will search at the normal profiles location, under the home directory of the current user.<br> eg: <b>default</b></li> </ul> </FONT></P> <A NAME="waysArgumentsOptions"></a> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"> <FONT SIZE=3><B>[options]</B></FONT></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/CommandLine_usage.png" NAME="graphics38" ALIGN=MIDDLE BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"> available options :</FONT> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <TABLE WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0 STYLE="page-break-inside: avoid"> <COL WIDTH=40*> <COL WIDTH=216*> <TR VALIGN=TOP> <TD WIDTH=15%> <P><FONT FACE="FreeSans, sans-serif"><B>--help</B></FONT></P> </TD> <TD WIDTH=85%><P STYLE="margin-top: 0.1cm"><FONT FACE="FreeSans, sans-serif">Displays a “usage” help message</FONT></P></TD> </TR> <TR VALIGN=TOP> <TD WIDTH=15%> <P><FONT FACE="FreeSans, sans-serif"><B>--version</B></FONT></P> </TD> <TD WIDTH=85%><P STYLE="margin-top: 0.1cm"><FONT FACE="FreeSans, sans-serif">Displays luckybackup's current version</FONT></P></TD> </TR> <TR VALIGN=TOP> <TD WIDTH=15%> <P><FONT FACE="FreeSans, sans-serif"><B>--skip-critical</B></FONT></P> </TD> <TD WIDTH=85%> <P STYLE="margin-top: 0.1cm"><FONT FACE="FreeSans, sans-serif">Will not execute tasks that appear with a <a href="#startDeclaredDataCheck">CRITICAL</a> warning message after the data checks</FONT></P> </TD> </TR> <TR VALIGN=TOP> <TD WIDTH=15%> <P><FONT FACE="FreeSans, sans-serif"><B>--dry-run</B></FONT></P> </TD> <TD WIDTH=85%> <P STYLE="margin-top: 0.1cm"><FONT FACE="FreeSans, sans-serif">Executes luckyBackup in <a href="#startDryRun">dry-run (simulation) mode</a></FONT></P> </TD> </TR> <TR VALIGN=TOP> <TD WIDTH=15%> <P><FONT FACE="FreeSans, sans-serif"><B>--silent</B></FONT></P> </TD> <TD WIDTH=85%> <P STYLE="margin-top: 0.1cm"><FONT FACE="FreeSans, sans-serif">Executes luckyBackup in <a href="#silentMode">silent mode</a> ((just notification tray icon shown))</FONT></P> </TD> </TR> <TR VALIGN=TOP> <TD WIDTH=15%><P><FONT FACE="FreeSans, sans-serif"><B>-c</B></FONT></P></TD> <TD WIDTH=85%><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Console mode</FONT></P> <P STYLE="margin-top: 0.1cm"><FONT FACE="FreeSans, sans-serif">Executes luckyBackup in <a href="#terminal">command-line mode</a><br></FONT></P> </TD> </TR> <TR VALIGN=TOP> <TD WIDTH=15%><P><FONT FACE="FreeSans, sans-serif"><B>--no-questions</B></FONT></P></TD> <TD WIDTH=85%> <P STYLE="margin-top: 0.1cm"><FONT FACE="FreeSans, sans-serif">Executes luckyBackup in <a href="#terminal">command-line mode</a> and skips confirmation questions asked to user. Implies -c (console mode).</FONT></P> </TD> </TR> </TABLE> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><A NAME="waysManualySchedule"></a><BR><BR></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT COLOR="#000080"> <B>manualy schedule</B></FONT>:</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"> For some reason, you might not wish to use the luckybackup's <a href="#cronIt">schedule feautre</a>, to have some jobs scheduled.<br> Instead you might want to manualy configure your system to execute luckybackup by using <b>cron</b> or <b>anacron</b> or a <b>bash script</b> or anything.<br><br> If that is the case, it is recommended to use the <b>--silent</b> together with the<b> --skip-critical</b> option to run luckybackup in <a href="#silentMode">silent mode</a>.<br><br> Something else that should be taken into consideration is that for the silent mode to run, a graphical environment is needed.<br> For that purpose the environmental variable <b>DISPLAY</b> should be defined.<br> An example, a luckybackup <a href="#cronItCrontabInfo">crontab</a> entry follows: </FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=2><B><SPAN STYLE="background: #99ccff"> env DISPLAY=:0 /usr/bin/luckybackup --silent --skip-critical /home/luckyb/.luckyBackup/profiles/EveryDay_jobs.profile</SPAN></B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT COLOR="#000080"><B>examples</B></FONT>:</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>1.</B> Execute luckybackup gui:</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=2><B><SPAN STYLE="background: #99ccff">$ luckybackup</SPAN></B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>2.</B> Execute luckybackup gui and run profile "BackupHome" immediately:</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=2><B><SPAN STYLE="background: #99ccff">$ luckybackup ~/.luckyBackup/profiles/BackupHome.profile</SPAN></B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>3.</B> Execute luckybackup gui and run profile "BackupHome" immediately in <a href="#startDryRun">simulation mode</a>:</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=2><B><SPAN STYLE="background: #99ccff">$ luckybackup --dry-run BackupHome.profile</SPAN></B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>4.</B> Execute luckybackup in <a href="#silentMode">silent mode</a> and run profile "BackupHome" immediately. Skip all <a href="#startDeclaredDataCheck">CRITICAL</a> tasks:</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=2><B><SPAN STYLE="background: #99ccff">$ luckybackup --silent --skip-critical BackupHome</SPAN></B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>5.</B> Execute luckybackup in <a href="#terminal">command-line mode</a> and run profile "BackupHome" immediately:</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=2><B><SPAN STYLE="background: #99ccff">$ luckybackup -c BackupHome</SPAN></B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>6.</B> Execute luckybackup in <a href="#terminal">command-line mode</a> and run profile "BackupHome" immediately. Do not ask any questions and Skip all <a href="#startDeclaredDataCheck">CRITICAL</a> tasks:</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=2><B><SPAN STYLE="background: #99ccff">$ luckybackup -c --skip-critical --no-questions BackupHome</SPAN></B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR></P> <A NAME="waysManPage"></a> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"> <FONT SIZE=3><B>man page</B></FONT></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><BR>A man page (system's manual page) is available at section 8 (System administration commands).<br> To view it, enter the following command:<br></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=2><B><SPAN STYLE="background: #99ccff">$ man luckybackup</SPAN></B></FONT></FONT></P> <P><BR><BR> </P> <P STYLE="margin-top: 0.42cm; margin-bottom: 0.2cm; background: transparent"> <BR><BR> </P> <P STYLE="margin-top: 0.42cm; margin-bottom: 0.2cm; background: transparent; border-top: none; border-bottom: 1px solid #000000; border-left: none; border-right: none; padding-top: 0cm; padding-bottom: 0.07cm; padding-left: 0cm; padding-right: 0cm"> <A NAME="mainWindow"></A> <BR><BR> </P> <H1><A HREF="#top"><IMG SRC="data/up.png" NAME="graphics3" ALIGN=LEFT WIDTH=24 HEIGHT=24 BORDER=0><BR CLEAR=LEFT></A><FONT COLOR="#800000"> <!-- ********************************* main window ****************************************************************--> <FONT FACE="FreeSans, sans-serif">the main window</FONT></FONT></H1> <P><BR><BR> </P> <P><BR><BR> </P> <H1 ALIGN=CENTER STYLE="margin-top: 0.42cm; margin-bottom: 0.2cm; background: transparent"> <FONT COLOR="#000080"><IMG SRC="data/MainWindowEmpty.png" NAME="graphics18" ALIGN=MIDDLE BORDER=0></FONT></H1> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>This is the application's main window as it appears as soon as you execute luckyBackup.</FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>It consists of :</B></FONT></FONT></P> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>A <b>menu</b>.</FONT></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>A <b>toolbar</b> that refers to current profile handling.</FONT></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>The <B>Task</B> <B>List</B> which lists all the available tasks of the current profile.</FONT></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>3 buttons that refer to specific task handling (<B>add</B> – <B>remove</B> – <B>modify</B>).</FONT></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>A <b>run</b> button and a simulation (<b>Dry</b>) check-box. You can start the execution of all the tasks included in a profile by using these.</FONT></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>An <b>information window</b>. It can be shown/hidden by using the arrows icon at its top left corner.</FONT></FONT></P> </UL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-bottom: 0cm"><FONT COLOR="#000080"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><B>...Playing around</B></FONT></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/MainWindowFull.png" NAME="graphics4" ALIGN=MIDDLE BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <A NAME="MainTasks"></a> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Tasks</B></FONT></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>All task related actions are accomplished via the "task area":</FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/MainWindow_task.png" NAME="graphics22" ALIGN=BOTTOM BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>or the menu → Task:</FONT></FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/menuTask.png" NAME="graphics49" ALIGN=BOTTOM BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Add</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Add a new task to the current profile.</FONT></FONT></P> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Press the add button for the <A HREF="#propertiesSimple">task properties dialog</A> to appear.</FONT></FONT></P> </UL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Remove</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Remove an existing task from the current profile:</FONT></FONT></P> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Click on an task name, inside the task list, to highlight it.</FONT></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Press the remove button.</FONT></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Answer yes to the dialog that will appear to permanently remove the task.</FONT></FONT></P> </UL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Modify</B> </FONT></FONT> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Modify an existing task to your liking:</FONT></FONT></P> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Click on an task name, inside the task list, to highlight it.</FONT></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Press the modify button for the <A HREF="#propertiesSimple">modify task dialog</A> to appear.</FONT></FONT></P> </UL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Duplicate</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Create a duplicate of the highlighted task and add it to the current profile.</FONT></FONT></P> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Select Task-> <b>Create Duplicate Task</b> from the menu.</FONT></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Change anything (if) you wish at the <A HREF="#propertiesSimple"><FONT FACE="FreeSans, sans-serif"><B>task properties dialog</B></FONT></A> that will appear and click ok:</FONT></FONT></P> </UL><p></p> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/OperationPropertiesDuplicate.png" NAME="taskDuplicate" ALIGN=BOTTOM BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Create <b>Restore</b> task</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Create a restore task of the highlighted task and add it to the current profile.</FONT></FONT></P> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Select Task-> <b>Create Restore Task</b> from the menu.</FONT></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Please have a look at the <A HREF="#restore"><FONT FACE="FreeSans, sans-serif"><B>restore section</B></FONT></A> of this manual for full reference to the restore procedures.</FONT></FONT></P> </UL><p></p> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><A NAME="MainProfiles"></A> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Profiles</B></FONT></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>All profile related actions are accomplished via the toolbar:</FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/toolBar.png" NAME="graphics22" ALIGN=BOTTOM BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>or the menu → profile:</FONT></FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/menuProfile.png" NAME="graphics49" ALIGN=BOTTOM BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Current Profile – profile load</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>The profile you are currently using is displayed at the drop-down list, on the left of the toolbar.</FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>To change the current profile simple select another one from the list.</FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>The information window will display a message:</FONT></FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/InfoWindow_ProfileLoaded.png" NAME="graphics50" ALIGN=BOTTOM WIDTH=576 HEIGHT=157 BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Save</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>To save the profile you are currently using, press the save button at the toolbar, or select profile → save from the menu, or press ctrl+S.</FONT></FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/InfoWindow_ProfileSaved.png" NAME="graphics54" ALIGN=BOTTOM WIDTH=579 HEIGHT=157 BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Default profile</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>The default profile is the profile loaded as soon as luckyBackup starts.</FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Normaly the name of the default profile is “default”. To change that, select profile → Default from the menu.</FONT></FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/InfoWindow_ProfileDefault.png" NAME="graphics51" ALIGN=BOTTOM WIDTH=577 HEIGHT=155 BORDER=0></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Rename</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>To rename the profile you are currently using, select profile → rename from the menu.</FONT></FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/popup_ProfileRename.png" NAME="graphics52" ALIGN=BOTTOM WIDTH=310 HEIGHT=150 BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Delete</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>To delete the profile you are currently using, press the delete button at the toolbar, or select profile → delete from the menu.</FONT></FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/popup_ProfileDelete.png" NAME="graphics20" ALIGN=BOTTOM WIDTH=376 HEIGHT=105 BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>New</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Create a new profile:</FONT></FONT></P> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><SPAN STYLE="font-weight: normal">Press the “new profile” button </SPAN></FONT></FONT><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><U><SPAN STYLE="font-weight: normal">or</SPAN></U></FONT></FONT> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><SPAN STYLE="font-weight: normal">select “Profile → new” from the menu </SPAN></FONT></FONT><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><U><SPAN STYLE="font-weight: normal">or</SPAN></U></FONT></FONT> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><SPAN STYLE="font-weight: normal">press ctrl+N.</SPAN></FONT></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Enter the name of the new profile at the dialog that will appear and press ok.</FONT></FONT></P> </UL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Duplicate</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Create a duplicate of the current profile:</FONT></FONT></P> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><SPAN STYLE="font-weight: normal">Select “Profile → Duplicate” from the menu </SPAN></FONT></FONT> </P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Enter the name of the new duplicate profile at the dialog that will appear and press ok.</FONT></FONT></P> </UL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>View/Edit Description</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>View or edit the profile's description:</FONT></FONT></P> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><SPAN STYLE="font-weight: normal">Select “Profile → View/Edit Description” from the menu </SPAN></FONT></FONT> </P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Enter any text to use as a profile description and press ok.</FONT></FONT></P> </UL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Export</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>You can export the current profile with the same or different file name at any location :</FONT></FONT></P> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Select “Profile → export” from the menu.</FONT></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>The following dialog will appear</FONT></FONT></P> </UL> <OL START=0> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#000080"><IMG SRC="data/popup_ProfileExport.png" NAME="graphics19" ALIGN=BOTTOM WIDTH=634 HEIGHT=451 BORDER=0></FONT></P> </OL> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Navigate to the directory you wish to export the profile to.</FONT></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Type a file-name for your profile or select an already existent profile to replace it.</FONT></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Press the save button</FONT></FONT></P> </UL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><U>Note</U> that you do not have to type the “.profile” extension. It will be added automatically.</FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Also have in mind that the <B>default directory </B>where profiles are located is inside the user's home directory, under the folder “<B>~/.luckyBackup/profiles</B>”.</FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Import</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>To Import a profile from another location:</FONT></FONT></P> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Select “Profile → import” from the menu.</FONT></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>The following dialog will appear.</FONT></FONT></P> </UL> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/popup_ProfileImport.png" NAME="graphics21" ALIGN=BOTTOM WIDTH=634 HEIGHT=451 BORDER=0></P> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Navigate to the directory you wish to import the profile from.</FONT></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Select the profile you wish to import.</FONT></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Click the open button to finish the procedure.</FONT></FONT></P> </UL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Refresh</B></FONT></FONT></P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>To refresh the current view, simply click the refresh button, or select profile → refresh from the menu or press F5.</FONT></FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/InfoWindow_Refresh.png" NAME="graphics53" ALIGN=BOTTOM WIDTH=581 HEIGHT=157 BORDER=0></P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><A NAME="MainSchedule"></A> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Schedule</B></FONT></FONT></FONT></P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Create new, modify or remove existing luckyBackup schedules</FONT></FONT></P> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Click the schedule button at the toolbar or select profile → schedule from the menu, for the <A HREF="#cronIt">schedule dialog</A> to appear</FONT></FONT></P> </UL> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><A NAME="MainStart"></A> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B><FONT COLOR="#800080">Run</FONT> </B></FONT></FONT> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Start the execution of all included tasks of the current profile.</FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>You have 2 options to do this:</FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>a. Normal </B>execution. For real data transferring</FONT></FONT></P> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Click the “Run” button.</FONT></FONT></P> </UL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>b. simulation</B>. Perform a dry-run execution of all included tasks of the current profile.</FONT></FONT></P> <P STYLE="margin-bottom: 0cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>If you are unsure of the effects on your data when executing an rsync command try the dry-run option. luckyBackup will perform a trial run that doesn't make any changes (and produces mostly the same output as a real run).</FONT></FONT></P> <P STYLE="margin-bottom: 0.2cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><U>Note</U>: The progress-bar might be misleading when using this.</FONT></FONT></P> <P STYLE="margin-bottom: 0.2cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>WARNING</B>: Any pre/post task execution commands, will run normaly, not simulated.</FONT></FONT></P> <UL> <LI><P STYLE="margin-bottom: 0.3cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Check the “<B>Dry</B>” <B>check-box </B><SPAN STYLE="font-weight: normal">to enable this option.</SPAN></FONT></FONT></P> <LI><P STYLE="margin-bottom: 0.3cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Click the “run” button</FONT></FONT></P> </UL> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><A NAME="MainHelp"></A> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Help</B></FONT></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>about</B> </FONT></FONT> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Display the “about” dialog</FONT></FONT></P> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Select “Help → about” from the menu.</FONT></FONT></P> </UL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/about.png" NAME="graphics5" ALIGN=MIDDLE BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Do not forget that <B>this is free software.</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Help</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Display this manual</FONT></FONT></P> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Select Help → Help from the menu or</FONT></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Press F1.</FONT></FONT></P> </UL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <A NAME="MainSettings"></A> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Language</B></FONT></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>If you wish to change the language of the application:</FONT></FONT></P> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Select Settings → Language from the menu</FONT></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Click on the language you wish to use</FONT></FONT></P> </UL> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/menuLanguage.png" NAME="language5" ALIGN=MIDDLE BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Toolbar settings</B></FONT></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Change the display of the toolbar:</FONT></FONT></P> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Select Settings → Toolbars from the menu</FONT></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Select the options you wish.</FONT></FONT></P> </UL> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/menuToolbars.png" NAME="toolbarmenu" ALIGN=MIDDLE BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><A NAME="MainQuit"></A> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Quit</B></FONT></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>In order to exit luckybackup:</FONT></FONT></P> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Click the EXIT button, located at the actions toolbar or</FONT></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Select Profile → Quit from the profile menu or</FONT></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Press ctrl+X</FONT></FONT></P> </UL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Do not worry about losing your profile if not saved when exiting the application.<BR>You will be prompted accordingly.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border-top: none; border-bottom: 1px solid #000000; border-left: none; border-right: none; padding-top: 0cm; padding-bottom: 0.07cm; padding-left: 0cm; padding-right: 0cm"><A NAME="propertiesSimple"></A> <BR><BR> </P> <H1><A HREF="#top"><IMG SRC="data/up.png" NAME="graphics6" ALIGN=LEFT WIDTH=24 HEIGHT=24 BORDER=0><BR CLEAR=LEFT></A><FONT COLOR="#800000"><!-- ********************************* operaion properties (simple) ***********************************************--><FONT FACE="FreeSans, sans-serif">task properties (the simple way)</FONT></FONT></H1> <P><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">As already seen at a previous chapter the basic properties of a task are its name and its include state.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Of course this specific task actually does something (e.g transfers data from the source to the destination). Although this might seem simple, a lot of parameters are involved in the way this can be accomplished.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Let's have a deeper look at a task's properties by...</FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#000080"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><B>creating a new task</B></FONT></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">As soon as you click the “add” task button the following dialog appears:</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <OL START=0> <P ALIGN=CENTER><IMG SRC="data/OperationPropertiesSimpleEmpty.png" NAME="graphics23" ALIGN=BOTTOM BORDER=0></P> </OL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><A NAME="OperationName"></A> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><B>name</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">First thing you have to do is enter a name for this new task.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Click on the “Task name” text field and type a name for the task. For example if you wish to backup the home directory of your sidux distribution, a good name would be “Back up my sidux home directory”.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Actually, there is no such thing as a “good name”. Type anything that suits you best with no restrictions :-)</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <A NAME="OperationType"></A> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><B>type</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif">The next thing you have to define is the task type. There are 2 types available:</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif"><B>1. Backup source inside destination</B></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif">Select this type to create a backup of the source inside the destination directory.<br> Depending on the state of the following checkbox, you can define whether an extra directory will be created inside the destination or not.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif"><br></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif"><B>do NOT create extra directory</B> check box</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif"><b>Check</b> the box to backup the contents of a directory, not the directory itself.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif">In simple words, to copy over, all the data that the source contains inside the destination.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif">Leave the box <b>unchecked</b> to backup the source directory by name.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif">This means that a new directory with the same name as the source will be created (if not already there) inside the destination.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif"><U>Example:</U></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT FACE="FreeSans, sans-serif">Let's assume that you create a task and declare:</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT FACE="FreeSans, sans-serif">source = /home/luckyb/photos/ (that contains a large number of files)</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT FACE="FreeSans, sans-serif">destination = /media/backups/pictures/</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT FACE="FreeSans, sans-serif">If you check the “do NOT create extra directory” box, then all files and folders from inside /home/luckyb/photos/, will be copied inside /media/backups/pictures/.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT FACE="FreeSans, sans-serif">If you leave the box unchecked, then you will end up with the directory /media/backups/pictures/photos/ (the whole source directory will be copied inside the destination).</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif"><br><B>2. synchronize source & destination</B></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif">Use this task type in order to sync the source with the destination by keeping the most recent files at both of them.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif">It can prove really useful if you modify specific files from different locations.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif"><U>Example</U>:</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif">Let's assume that you are working on a project. You have created the directory /home/luckyb/project at your home PC and save all relevant files in there. At the same time there is a need to work on some of these files at another PC, so you copy them at your usb flash drive (location: /media/myUSB/project).</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif">There are times when you do not remember which file you edited when and from where. So you create a task declaring:</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif">source: /home/luckyb/project/</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif">destination: /media/myUSB/project/</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif">task type: “sync directories”</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif">This will result in a 2-way transfer. Newest modified files will be transfered from source to destination or the other way round. Also freshly created files at one of the locations will be copied over to the other.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif">Please <U>note</U> that if you delete files at either the source or the destination and you perform this task, you will end up with these files created again because they still exist at the other location.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><A NAME="OperationSource"></A> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><B>source</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">After defining the name and the type of the task, you have to define the source. That means the directory that holds the data that are going to be backed-up. You can do that in <U>2 ways</U>:</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>1. </B>Click on the “source” text field and type the full path of the source directory. For example /home/luckyb.<br> Auto-completion as you type is enabled by default.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>2.</B> Click the “<B>browse locally</B>” button, located at the right of the source text entry field. A normal file dialog will appear. Navigate to the directory you wish to use as a source and press the “<B>choose</B>” button</FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><A NAME="OperationDestination"></A> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><B>destination</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif">Declare a directory to use as a destination, the same way as the source declaration procedure. This is the directory where the source will be backed-up to. For the “Backup my sidux home directory” example this could be /media/backups/siduxHome.</FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><A NAME="OperationRemoteNot"></A> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><B>why can't I declare my remote place ??</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif"><br>Today's file managers like nautilus, konqueror or dolphin have the ability to directly support some remote filesystem protocols such as smb/cifs or nfs.<br> You might be able to browse some remote places via your filebrowser but cannot find a way to declare those as source or destination.<br> This does not necessarily mean that the remote place is locally mounted. You can distinguish such a situation by observing the full path address of the remote folder. If it does not start with <b>"/"</b> but with eg <b>smb://</b> then you are using the direct filesystem browser support. <br><br>The solution to this issue is to mount the remote place locally.<br> This involves, adding a line at the file <b>/etc/fstab</b> so that the remote directory can be visible under a specific mount point eg /media/my-Remote-Place/<br><br> It is not the purpose of this document to describe every possible mount procedure. Please refer to your distro's documentation or support web pages for guidelines. </FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><A NAME="OperationKeepSnapshots"></A> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><B>Snapshots to keep</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif">Every time a task is run the source data are backed-up as they are at that specific time.<br> This is called a snapshot !!<br> luckyBackup can hold a number of snapshots so that it is possible to revert to any one of them.<br> Define the maximum number of snapshots you wish to keep, by clicking on the arrows of the spin-box.<br> If that number is reached, older snapshots will be deleted when the task is run again.<br> The default number of snapshots to keep is <b>1</b>.</FONT></P> <P><A NAME="OperationDoneErrorsCheck"></A><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif">Below is a screenshot of the task properties dialog, with the name, source and destination fields, ready.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <IMG SRC="data/OperationPropertiesSimpleBackup.png" NAME="graphics13" ALIGN=MIDDLE BORDER=0></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif">As soon as you are finished declaring all appropriate fields, click the “<B>okay</B>” button.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif">If there are errors, you will be informed by the application.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <IMG SRC="data/Message_OperaionPropertiesSpecifyFollowing.png" NAME="graphics24" ALIGN=MIDDLE BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif">For safety reasons, if you have chosen "Backup the contents of the source directory" as task type, you will face the following WARNING message:</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <IMG SRC="data/Message_CloneWarning.png" NAME="messagecloneWarn" ALIGN=MIDDLE BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif">This is a reminder that the destination directory will finaly become a "clone" of the source. Any irrelevant-to-the-source data it might contain, will be lost !!</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif">Next, the main window will regain focus, displaying the task you just created.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif"><U>Note</U> that the default <B>include state</B> of a freshly created task is FALSE (not included)</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT COLOR="#000080"><IMG SRC="data/MainWindowFirstEntryAdded.png" NAME="graphics25" ALIGN=MIDDLE BORDER=0></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border-top: none; border-bottom: 1px solid #000000; border-left: none; border-right: none; padding-top: 0cm; padding-bottom: 0.07cm; padding-left: 0cm; padding-right: 0cm"><A NAME="propertiesAdvanced"></A> <BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <H1><A HREF="#top"><IMG SRC="data/up.png" NAME="graphics7" ALIGN=LEFT WIDTH=24 HEIGHT=24 BORDER=0><BR CLEAR=LEFT></A><FONT COLOR="#800000"> <!-- ********************************* operaion properties (advanced) ************************************************--> <FONT FACE="FreeSans, sans-serif">task properties (for the unsatisfied)</FONT></FONT></H1> <P><BR><BR> </P> <P><FONT FACE="FreeSans, sans-serif">The task properties, as discussed at the previous chapter, are quite simple and straightforward. Now, it's time to have a much deeper look. If you haven't done it already (out of curiosity), do it now. Go ahead and press the <B>advanced </B>pushbutton at the “task properties” window. This will result in a resizing of the window and a display of much more information.</FONT></P> <P><FONT FACE="FreeSans, sans-serif">It is not as complicated as it looks !!</FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT COLOR="#000080"><IMG SRC="data/OperationPropertiesAdvancedEmpty10.png" NAME="TaskAdvanced10" ALIGN=BOTTOM BORDER=0></IMG></FONT></P> <P><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"><A NAME="OperationAdvancedDescription"></A> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><B>Description</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"> You can optionaly add a description for the current task here.<br> This description will be displayed at the main window, as soon as a task is selected and can provide useful information without the need to open the task-properties dialog. </FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT COLOR="#000080"><IMG SRC="data/OperationPropertiesAdvancedDescription.png" NAME="taskDescription" ALIGN=BOTTOM BORDER=0></FONT></P> <P><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"><A NAME="OperationAdvancedExclude"></A> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><B>Exclude</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">This feature, allows the exclusion of certain file(s), folder(s), pattern(s) from the task. Everything declared here, will not be a part of the data transfer. It will be skipped.</FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT COLOR="#000080"><IMG SRC="data/OperationPropertiesAdvancedEmpty1.png" NAME="TaskAdvanced1" ALIGN=BOTTOM BORDER=0></FONT></P> <P><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">The Exclude tab is divided to:</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#000080"><FONT FACE="FreeSans, sans-serif"><B>1. Templates</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Use the checkboxes to exclude the following at will:</FONT></P> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Temp folders.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">All folders named <B>tmp</B><SPAN STYLE="text-decoration: none">. These are directories that are used for storing temporary data that you would not mind losing. For example /tmp.</SPAN></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><SPAN STYLE="text-decoration: none">pattern used: </SPAN><U>**/*tmp*/</U></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; text-decoration: none"> <FONT FACE="FreeSans, sans-serif">cache folders.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; text-decoration: none"> <FONT FACE="FreeSans, sans-serif">All folders named <B>cache</B>. These folders are used by various application or systems for storing cache data. Your browser for example, uses a cache folder.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; text-decoration: none"> <FONT FACE="FreeSans, sans-serif">pattern used: <U>**/*cache*/</U> & <U>**/*Cache*/</U></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; text-decoration: none"> <FONT FACE="FreeSans, sans-serif">backup files.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; text-decoration: none"> <FONT FACE="FreeSans, sans-serif">Backup files created by various applications. These are files whose filenames have a trailing “<B>~</B>”<SPAN STYLE="font-weight: normal">. For example if you open the text file “LotsOfText.txt” for editing, make changes and save it, then apart from the main file, another one will be created named “LotsOfText.txt~”. This is identical to the pre-modified “LotsOfText.txt” and is created automatically for backup/safety purposes.</SPAN></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><SPAN STYLE="font-weight: normal">pattern used: </SPAN><U><SPAN STYLE="font-weight: normal">**~</SPAN></U></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; text-decoration: none"> <FONT FACE="FreeSans, sans-serif">mount directories.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; text-decoration: none"> <FONT FACE="FreeSans, sans-serif">System normal mount points. These would be <B>/media</B> and <B>/mnt</B><SPAN STYLE="font-weight: normal">. If you decide to use your “</SPAN><B>/</B>” <SPAN STYLE="font-weight: normal">directory as source, then it would by wise to check this for various reasons. The most important one is to avoid backing up the destination onto its self!! Usually, the destination is a hard disk partition, different from the one that your distro is installed and your root directory (“/”) is located. This will be normally mounted at point /media or /mnt.</SPAN></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif">Please see the WARNING at the end of this chapter.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><SPAN STYLE="font-weight: normal">patterns used: </SPAN><U><SPAN STYLE="font-weight: normal">/mnt/*/**</SPAN></U> <SPAN STYLE="font-weight: normal">& /media/*/**</SPAN></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; text-decoration: none"> <FONT FACE="FreeSans, sans-serif">lost+found.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; text-decoration: none"> <FONT FACE="FreeSans, sans-serif">System folders named <B>lost+found</B>.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; text-decoration: none"> <FONT FACE="FreeSans, sans-serif">pattern used: <U>**/lost+found*/</U></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; text-decoration: none"> <FONT FACE="FreeSans, sans-serif">system folders.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; text-decoration: none"> <FONT FACE="FreeSans, sans-serif">These would be <B>/var</B>, <B>/proc</B>, <B>/dev </B>and <B>/sys</B><SPAN STYLE="font-weight: normal">. Again, you can use this option if you decide to backup your root folder (“</SPAN><B>/</B>”<SPAN STYLE="font-weight: normal">). If it does not suit you and you want your own defined directories to be excluded, feel free to leave this unchecked and use the “user defined” way to declare anything.</SPAN></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><SPAN STYLE="font-weight: normal">patterns used: </SPAN><U><SPAN STYLE="font-weight: normal">/var/**</SPAN></U><SPAN STYLE="font-weight: normal">, </SPAN><U><SPAN STYLE="font-weight: normal">/proc/**</SPAN></U> <SPAN STYLE="font-weight: normal">, </SPAN><U><SPAN STYLE="font-weight: normal">/dev/**</SPAN></U> <SPAN STYLE="font-weight: normal">& </SPAN><U><SPAN STYLE="font-weight: normal">/sys/**</SPAN></U></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; text-decoration: none"> <FONT FACE="FreeSans, sans-serif">Trash.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; text-decoration: none"> <FONT FACE="FreeSans, sans-serif">Directories named <B>trash</B>. These are directories where files that you delete are stored.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; text-decoration: none"> <FONT FACE="FreeSans, sans-serif">patterns used: <U>**/*trash*/</U> & <U>**/*Trash*/</U></FONT></P> </UL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT FACE="FreeSans, sans-serif">Example of an “Exclude” tab :</FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT COLOR="#000080"><IMG SRC="data/OperationProperties_ExcludeFull1.png" NAME="graphics27" ALIGN=BOTTOM BORDER=0></FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#000080"><FONT FACE="FreeSans, sans-serif"><B>2. User defined</B></FONT></FONT></P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>You can declare anything you wish to be excluded from the task by adding it to the “exclude list” in the following way:</FONT></FONT></P> <OL> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Use the text field located next to the add button to enter what is going to be excluded. If you find it handy, use the "launch pattern editor" button, located at the right of the text field, to open the graphical <A HREF="#OperationAdvancedPatternEditor"><b>pattern editor</b></A>.</FONT></FONT></P> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Press the <B>add </B>button (or ENTER), to add the entered text to the exclude list.</FONT></FONT></P> </OL> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Remove an item:</FONT></FONT></P> <UL> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>click on it to highlight it </FONT></FONT> </P> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>click the <B>remove</B> button.</FONT></FONT></P> </UL> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Edit an item:</FONT></FONT></P> <UL> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>click on it to highlight it </FONT></FONT> </P> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>click the <B>edit</B> button.</FONT></FONT></P> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Change the item by using the keyboard.</FONT></FONT></P> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>click the <B>done</B> button.</FONT></FONT></P> </UL> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Move an item:</FONT></FONT></P> <UL> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>click on it to highlight it </FONT></FONT> </P> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>click the <B>move up or down</B> button.</FONT></FONT></P> </UL> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT COLOR="#000080"><IMG SRC="data/OperationProperties_ExcludeFull2.png" NAME="graphics28" ALIGN=BOTTOM BORDER=0></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Patterns can also be read from a file !!<br> <ul><li>Check the <b>Read File</b> box.</li> <li>Define, at the line-edit on its right, the full path of the exclusions file (use the "browse locally" button if you wish).</li></ul> This file must contain one exclude pattern per line. Blank lines and lines starting with ‘;’ or ‘#’ are ignored. </FONT></FONT></P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>An exclusion can be a file, a directory or a list of files/directories that follows a pattern.</FONT></FONT></P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <SPAN STYLE="text-decoration: none"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><SPAN STYLE="font-weight: normal">Anything you add as an exclusion must follow the</SPAN></FONT></FONT></SPAN><SPAN STYLE="text-decoration: none"><SPAN STYLE="background: transparent"> </SPAN></SPAN><SPAN STYLE="text-decoration: none"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><SPAN STYLE="font-weight: normal"><SPAN STYLE="background: transparent"> <A HREF="#OperationAdvancedPatternRules"><b>pattern rules</b>,</A> </SPAN></SPAN></FONT></FONT></SPAN><SPAN STYLE="text-decoration: none"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><SPAN STYLE="font-weight: normal">as described at the end of the chapter.</SPAN></FONT></FONT></SPAN></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#ff3333"><FONT FACE="FreeSans, sans-serif"><B>WARNING</B></FONT></FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>DO NOT FORGET TO EXCLUDE THE DESTINATION</B></FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">It is possible sometimes, for the destination to be included in the source. Meaning that the destination directory is a part of the source hierarchy of files.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">examples:</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">source is your root directory (“<B>/</B>”) and destination is /media/backups/</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">source is your home directory and destination is /home/username/backup/</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">This will result in unwanted data transfer. The destination will be backed-up onto itself !!</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><U>To avoid such circumstances, do not forget, to add as an exclusion the destination directory or a folder that contains the destination directory.</U></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <!-- ********************************************** Include ********************************************************************************************* --> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"><A NAME="OperationAdvancedOnlyInclude"></A> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><B>Include</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"> Use this feature, to define specific file(s), folder(s) or pattern(s) to be included by the transfer. <br><br> There are 2 modes of operation available:<br></FONT></P> <A NAME="OperationAdvancedOnlyIncludeMode"></A> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><font color="#0000FF" face="FreeSans, sans-serif"> 1. Only include</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"> Use this mode to backup/sync only specific file(s), folder(s) or pattern(s).</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">For example, you might not want to backup a whole directory structure but just a single file</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">...or a single directory </FONT> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">...or 2 single files and all the open-office writer documents within this directory structure</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Please note, that everything that you declare here, <U>and only that</U>, will be taken into consideration when performing data transfers of the specific task and nothing more.</FONT></P> <A NAME="OperationAdvancedNormalIncludeMode"></A> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><font color="#0000FF" face="FreeSans, sans-serif"> 2. Normal include</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"> Use this mode, to define file(s), folder(s) or pattern(s) that will not be excluded by the transfer.<br><br> <b>concept - theory</b>:<br> As the list of files/directories to transfer is built, luckybackup checks each name to be transferred against the list of include/exclude patterns in turn, and the first matching pattern is acted on: <br>if it is an exclude pattern, then that file is<b> skipped</b>; <br>if it is an include pattern then that filename is <b>not skipped</b>; <br>if no matching pattern is found, then the filename is <b>not skipped</b>.<br><br> Note that, when using the "<b>recurse into directories</b>" option, every subcomponent of every path is visited from the top down, so include/exclude patterns get applied recursively to each subcomponent's full name (e.g. <b>to include “/foo/bar/baz” the subcomponents “/foo” and “/foo/bar” must not be excluded</b>). <br> The exclude patterns actually short-circuit the directory traversal stage when luckybackup finds the files to send. If a pattern excludes a particular parent directory, it can render a deeper include pattern ineffectual because luckybackup did not descend through that excluded section of the hierarchy. This is particularly important when using a trailing ‘*’ rule. For instance, this <b>won't work</b>:<br><br> include: /some/path/this-file-will-not-be-found <br> include: /file-is-included <br> exclude: * <br><br> This fails because the parent directory “some” is excluded by the ‘*’ rule, so luckybackup never visits any of the files in the “some” or “some/path” directories. One solution is to ask for all directories in the hierarchy to be included by using a single rule: “<b>include: */</b>”, and perhaps use the <b>--prune-empty-dirs</b> option.<br> This technique is used at the <a href="#OperationAdvancedOnlyIncludeMode">only include mode</a>. Another solution is to add specific include rules for all the parent dirs that need to be visited. For instance, this set of rules <b>works</b> fine: <br><br> include: /some/ <br> include: /some/path/ <br> include: /some/path/this-file-is-found<br> include: /file-also-included <br> include: *<br> </FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/OperationPropertiesAdvancedEmpty3.png" NAME="graphics32" ALIGN=BOTTOM BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#000080"><FONT FACE="FreeSans, sans-serif"><B>Add</B></FONT></FONT></P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>You can declare anything you wish to be included by the task, by adding it to the “include list” in the following way:</FONT></FONT></P> <OL> <LI VALUE=1><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Use the text field located next to the add button to enter what is going to be included. If you find it handy, use the "launch pattern editor" button, located at the right of the text field, to open the graphical <A HREF="#OperationAdvancedPatternEditor"><b>pattern editor</b></A>.</FONT></FONT></P> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Press the <B>add </B>button (or press ENTER), to add the entered text to the “only include” list.</FONT></FONT></P> </OL> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/OperationProperties_OnlyIncludeFull.png" NAME="OnlyInclude" ALIGN=BOTTOM BORDER=0></P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif" COLOR="#000080"><FONT SIZE=3>Remove an item:</FONT></FONT></P> <UL> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>click on it to highlight it </FONT></FONT> </P> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>click the <B>remove</B> button.</FONT></FONT></P> </UL> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif" COLOR="#000080"><FONT SIZE=3>Edit an item:</FONT></FONT></P> <UL> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>click on it to highlight it </FONT></FONT> </P> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>click the <B>edit</B> button.</FONT></FONT></P> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Change the item by using the keyboard.</FONT></FONT></P> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>click the <B>done</B> button.</FONT></FONT></P> </UL> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif" COLOR="#000080"><FONT SIZE=3>Move an item:</FONT></FONT></P> <UL> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>click on it to highlight it </FONT></FONT> </P> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>click the <B>move up or down</B> button.</FONT></FONT></P> </UL> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT COLOR="#000080"><FONT FACE="FreeSans, sans-serif"><B>Read from file</B></FONT></FONT></P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Include patterns can also be read from a file !!<br> <ul><li>Check the <b>Read File</b> box.</li> <li>Define, at the line-edit on its right, the full path of the inclusions file (use the "browse locally" button if you wish).</li></ul> This file must contain one include pattern per line. Blank lines and lines starting with ‘;’ or ‘#’ are ignored. </FONT></FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>An inclusion can be a file, a directory or a list of files/directories that follows a pattern.</FONT></FONT></P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <SPAN STYLE="text-decoration: none"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><SPAN STYLE="font-weight: normal">Anything you add as an inclusion must follow the </SPAN></FONT></FONT></SPAN><A HREF="#OperationAdvancedPatternRules"><SPAN STYLE="text-decoration: none"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><SPAN STYLE="font-weight: normal"><SPAN STYLE="background: transparent">pattern rules</SPAN></SPAN></FONT></FONT></SPAN></A><SPAN STYLE="text-decoration: none"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><SPAN STYLE="font-weight: normal">, as described at the end of the chapter.</SPAN></FONT></FONT></SPAN></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"><A NAME="OperationAdvancedOptions"></A> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><B>Options</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">luckyBackup uses some default rsync options to perform tasks. That is not obligatory. You can remove any option and add others as you wish by using the C<B>ommand Options</B> tab. This is divided in 2 sections</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/OperationPropertiesAdvancedEmpty5.png" NAME="graphics33" ALIGN=BOTTOM BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <!-- <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#000080"><FONT FACE="FreeSans, sans-serif"><B>backend</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT COLOR="#000000"><FONT FACE="FreeSans, sans-serif">This is not used</FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> --> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#000080"><FONT FACE="FreeSans, sans-serif"><B>Templates</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Here, you will find normal checkboxes. These refer to some typical rsync options.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Simply click a box to change its check state, so that to use or not the option(s) it refers to.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">The checkboxes provided and the relevant options they refer to are as follows:</FONT></P> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>Skip newer destination files</B> <SPAN STYLE="font-weight: normal">refers to:</SPAN></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>-u, --update</B></FONT></P> </UL> <DL> <DD><FONT FACE="FreeSans, sans-serif">This forces rsync to skip any files which exist on the destination and have a modified time that is newer than the source file. (If an existing destination file has a modification time equal to the source file's, it will be updated if the sizes are different.) </FONT> </DD><DD STYLE="margin-bottom: 0.5cm"> <FONT FACE="FreeSans, sans-serif">Note that this does not affect the copying of symlinks or other special files. Also, a difference of file format between the sender and receiver is always considered to be important enough for an update, no matter what date is on the objects. In other words, if the source has a directory where the destination has a file, the transfer would occur regardless of the timestamp.</FONT></DD></DL> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"> <FONT FACE="FreeSans, sans-serif"><B>Delete files on the destination</B> <SPAN STYLE="font-weight: normal">refers to:</SPAN></FONT></P> <DT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>--delete</B></FONT></DT></UL> <DL> <DD><FONT FACE="FreeSans, sans-serif">This tells rsync to delete extraneous files from the destination side (ones that aren't on the source side), but only for the directories that are being synchronized. You must have asked rsync to send the whole directory (e.g. “dir” or “dir/”) without using a wildcard for the directory's contents (e.g. “dir/*”) since the wildcard is expanded by the shell and rsync thus gets a request to transfer individual files, not the files' parent directory.</FONT></DD><DD> <FONT FACE="FreeSans, sans-serif">Files that are excluded from the transfer are NOT excluded from being deleted because of the automatic use of the <B>--delete-excluded</B> option. </FONT> </DD><DD> <FONT FACE="FreeSans, sans-serif">This option can be dangerous if used incorrectly! It is a very good idea to first try a run using the <B>--dry-run</B> option (<B>-n</B>) to see what files are going to be deleted. </FONT> </DD><DD STYLE="margin-bottom: 0.5cm"> <FONT FACE="FreeSans, sans-serif">If the sending side (source) detects any I/O errors, then the deletion of any files at the destination will be automatically disabled. This is to prevent temporary filesystem failures (such as NFS errors) on the sending side causing a massive deletion of files on the destination. You can override this with the <B>--ignore-errors</B> option.</FONT></DD></DL> <UL> <DT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"> <FONT FACE="FreeSans, sans-serif"><B>--delete-after</B></FONT></DT></UL> <DL> <DD STYLE="margin-bottom: 0.5cm"><FONT FACE="FreeSans, sans-serif">Request that the file-deletions on the destination be done after the transfer has completed. This is useful if you are sending new per-directory merge files as a part of the transfer and you want their exclusions to take effect for the delete phase of the current transfer. It also forces rsync to use the old, non-incremental recursion algorithm that requires rsync to scan all the files in the transfer into memory at once (see –<B>recursive</B>).</FONT></DD></DL> <OL> <DT STYLE="margin-bottom: 0.5cm"> <FONT FACE="FreeSans, sans-serif"><B>--delete-excluded</B></FONT></DT></OL> <DL> <DD><FONT FACE="FreeSans, sans-serif">In addition to deleting the files on the receiving side that are not on the sending side, this tells rsync to also delete any files on the receiving side that are excluded.</FONT></DD><DD> <FONT FACE="FreeSans, sans-serif">This option is added only if the “exclude groupbox” is activated.</FONT></DD><DD STYLE="margin-bottom: 0.5cm"> <BR><BR> </DD></DL> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"> <FONT FACE="FreeSans, sans-serif"><B>Recurse into directories</B> <SPAN STYLE="font-weight: normal">refers to:</SPAN></FONT></P> <DT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>-r, --recursive</B></FONT></DT></UL> <DL> <DD><FONT FACE="FreeSans, sans-serif">This tells rsync to copy directories recursively.</FONT></DD><DD> <FONT FACE="FreeSans, sans-serif">Beginning with rsync 3.0.0, the recursive algorithm used is now an incremental scan that uses much less memory than before and begins the transfer after the scanning of the first few directories have been completed. This incremental scan only affects our recursion algorithm, and does not change a non-recursive transfer. It is also only possible when both ends of the transfer are at least version 3.0.0. </FONT> </DD><DD> <FONT FACE="FreeSans, sans-serif">Some options require rsync to know the full file list, so these options disable the incremental recursion mode. These include: <B>--delete-before</B>, <B>--delete-after</B>, <B>--prune-empty-dirs</B>, and <B>--delay-updates</B>.</FONT></DD><DD STYLE="margin-bottom: 0.5cm"> <FONT FACE="FreeSans, sans-serif">Incremental recursion can be disabled using the <B>--no-inc-recursive</B> option or its shorter <B>--no-i-r</B> alias.</FONT></DD></DL> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"> <FONT FACE="FreeSans, sans-serif"><B>Preserve ownership, times</B> <SPAN STYLE="font-weight: normal">refers to:</SPAN></FONT></P> <DT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>-o, --owner</B></FONT></DT></UL> <DL> <DD><FONT FACE="FreeSans, sans-serif">This option causes rsync to set the owner of the destination file to be the same as the source file, but <B>only if the receiving rsync is being run as the super-user</B> (see also the <B>--super</B> and <B>--fake-super</B> options at the rsync man page). Without this option, the owner of new and/or transferred files are set to the invoking user on the receiving side. </FONT> </DD><DD STYLE="margin-bottom: 0.5cm"> <FONT FACE="FreeSans, sans-serif">The preservation of ownership will associate matching names by default, but may fall back to using the ID number in some circumstances. </FONT> </DD></DL> <UL> <DT STYLE="margin-bottom: 0.5cm"> <FONT FACE="FreeSans, sans-serif"><B>-g, --group</B></FONT></DT></UL> <DL> <DD><FONT FACE="FreeSans, sans-serif">This option causes rsync to set the group of the destination file to be the same as the source file. If the receiving program is not running as the super-user (or if <B>--no-super</B> was specified), only groups that the invoking user on the receiving side is a member of will be preserved. Without this option, the group is set to the default group of the invoking user on the receiving side. </FONT> </DD><DD STYLE="margin-bottom: 0.5cm"> <FONT FACE="FreeSans, sans-serif">The preservation of group information will associate matching names by default, but may fall back to using the ID number in some circumstances. </FONT> </DD></DL> <UL> <DT STYLE="margin-bottom: 0.5cm"> <FONT FACE="FreeSans, sans-serif"><B>-t, --times</B></FONT></DT></UL> <DL> <DD STYLE="margin-bottom: 0.5cm"><FONT FACE="FreeSans, sans-serif">This tells rsync to transfer modification times along with the files and update them on the remote system. Note that if this option is not used, the optimization that excludes files that have not been modified cannot be effective; in other words, a missing <B>-t</B> will cause the next transfer to behave as if it used <B>-I</B>, causing all files to be updated (though rsync's delta-transfer algorithm will make the update fairly efficient if the files haven't actually changed, you're much better off using <B>-t</B>).</FONT></DD></DL> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"> <FONT FACE="FreeSans, sans-serif"><B>Preserve permissions</B> <SPAN STYLE="font-weight: normal">refers to:</SPAN></FONT></P> <DT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>-p, --perms</B></FONT></DT></UL> <DL> <DD><FONT FACE="FreeSans, sans-serif">This option causes the receiving rsync to set the destination permissions to be the same as the source permissions.</FONT></DD><DD STYLE="margin-bottom: 0.5cm"> <FONT FACE="FreeSans, sans-serif">When this option is <I>off</I>, permissions are set as follows: </FONT> </DD><DL> <DT> <FONT FACE="FreeSans, sans-serif">o</FONT></DT><DD> <FONT FACE="FreeSans, sans-serif">Existing files (including updated files) retain their existing permissions, though the <B>--executability</B> option might change just the execute permission for the file. </FONT> </DD><DT> <FONT FACE="FreeSans, sans-serif">o</FONT></DT><DD STYLE="margin-bottom: 0.5cm"> <FONT FACE="FreeSans, sans-serif">New files get their “normal” permission bits set to the source file's permissions masked with the receiving directory's default permissions (either the receiving process's umask, or the permissions specified via the destination directory's default ACL), and their special permission bits disabled except in the case where a new directory inherits a setgid bit from its parent directory. </FONT> </DD></DL> <DD> <FONT FACE="FreeSans, sans-serif">Thus, when <B>--perms</B> and <B>--executability</B> are both disabled, rsync's behavior is the same as that of other file-copy utilities, such as cp and tar. </FONT> </DD><DD> <FONT FACE="FreeSans, sans-serif">In summary: to give destination files (both old and new) the source permissions, use <B>--perms</B>. </FONT> </DD><DT STYLE="margin-bottom: 0.5cm"> <BR><BR> </DT></DL> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"> <FONT FACE="FreeSans, sans-serif"><B>Preserve symlinks</B> <SPAN STYLE="font-weight: normal">refers to:</SPAN></FONT></P> <DT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>-l, --links</B></FONT></DT></UL> <DL> <DD STYLE="margin-bottom: 0.5cm"><FONT FACE="FreeSans, sans-serif">When symlinks are encountered, recreate the symlink on the destination.</FONT></DD></DL> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"> <FONT FACE="FreeSans, sans-serif"><B>Preserve device, special files</B> <SPAN STYLE="font-weight: normal">refers to:</SPAN></FONT></P> </UL> <UL> <DT STYLE="margin-bottom: 0.5cm"><FONT FACE="FreeSans, sans-serif"><B>-D</B></FONT></DT></UL> <DL> <DD STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">The <B>-D</B> option is equivalent to <B>--devices</B> –<B>specials</B>.</FONT></DD><DD STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"> <FONT FACE="FreeSans, sans-serif"><B>--devices</B></FONT></DD><DD STYLE="margin-bottom: 0.5cm"> <FONT FACE="FreeSans, sans-serif">This option causes rsync to transfer character and block device files to the remote system to recreate these devices. This option has <U>no effect if the receiving rsync is not run as the super-user.</U> </FONT> </DD></DL> <UL> <DT STYLE="margin-bottom: 0.5cm"> <FONT FACE="FreeSans, sans-serif"><B>--specials</B></FONT></DT></UL> <DL> <DD STYLE="margin-bottom: 0.5cm"><FONT FACE="FreeSans, sans-serif">This option causes rsync to transfer special files such as named sockets and fifos. </FONT> </DD></DL> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"> <FONT FACE="FreeSans, sans-serif"><B>Preserve hard links</B> <SPAN STYLE="font-weight: normal">refers to:</SPAN></FONT></P> <DT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>-H, --hard-links</B></FONT></DT></UL> <DL> <DD><FONT FACE="FreeSans, sans-serif">This tells rsync to look for hard-linked files in the transfer and link together the corresponding files on the receiving side. Without this option, hard-linked files in the transfer are treated as though they were separate files. </FONT> </DD><DD> <FONT FACE="FreeSans, sans-serif">When you are updating a non-empty destination, this option only ensures that <U>files that are hard-linked together on the source are hard-linked together on the destination.</U> It does NOT currently endeavor to break already existing hard links on the destination that do not exist between the source files. Note, however, that if one or more extra-linked files have content changes, they will become unlinked when updated (assuming you are not using the <B>--inplace</B> option). </FONT> </DD><DD> <FONT FACE="FreeSans, sans-serif">Note that <U>rsync can only detect hard links between files that are inside the transfer set.</U> If rsync updates a file that has extra hard-link connections to files outside the transfer, that linkage will be broken. If you are tempted to use the <B>--inplace</B> option to avoid this breakage, be very careful that you know how your files are being updated so that you are certain that no unintended changes happen due to lingering hard links (and see the <B>--inplace</B> option for more caveats). </FONT> </DD><DD STYLE="margin-bottom: 0.5cm"> <FONT FACE="FreeSans, sans-serif">If incremental recursion is active (see <B>--recursive</B>), rsync may transfer a missing hard-linked file before it finds that another link for that contents exists elsewhere in the hierarchy. This does not affect the accuracy of the transfer, just its efficiency. One way to avoid this is to disable incremental recursion using the <B>--no-inc-recursive</B> option.</FONT></DD></DL> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"> <FONT FACE="FreeSans, sans-serif"><B>Ignore files the CVS way</B> <SPAN STYLE="font-weight: normal">refers to:</SPAN></FONT></P> <DT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>-C, --cvs-exclude</B></FONT></DT></UL> <DL> <DD><FONT FACE="FreeSans, sans-serif">This is a useful shorthand for excluding a broad range of files that you often don't want to transfer between systems. It uses a similar algorithm to CVS to determine if a file should be ignored. </FONT> </DD><DD STYLE="margin-bottom: 0.5cm"> <FONT FACE="FreeSans, sans-serif">The exclude list is initialized to exclude the following items (these initial items are marked as perishable — see the FILTER RULES section): </FONT> </DD><DL> <DD STYLE="margin-bottom: 0.5cm"> <FONT FACE="FreeSans, sans-serif">RCS SCCS CVS CVS.adm RCSLOG cvslog.* tags TAGS .make.state .nse_depinfo *~ #* .#* ,* _$* *$ *.old *.bak *.BAK *.orig *.rej .del-* *.a *.olb *.o *.obj *.so *.exe *.Z *.elc *.ln core .svn/ .git/ .bzr/ </FONT> </DD></DL> <DD> <FONT FACE="FreeSans, sans-serif">then, files listed in a $HOME/.cvsignore are added to the list and any files listed in the CVSIGNORE environment variable (all cvsignore names are delimited by whitespace). </FONT> </DD><DD> <FONT FACE="FreeSans, sans-serif">Finally, any file is ignored if it is in the same directory as a .cvsignore file and matches one of the patterns listed therein. Unlike rsync's filter/exclude files, these patterns are split on whitespace. See the </FONT><A HREF="man:cvs(1)"><FONT FACE="FreeSans, sans-serif"><B>cvs</B></FONT></A><FONT FACE="FreeSans, sans-serif">(1) manual for more information. </FONT> </DD><DD> <FONT FACE="FreeSans, sans-serif">If you're combining <B>-C</B> with your own <B>--filter</B> rules, you should note that these CVS excludes are appended at the end of your own rules, regardless of where the <B>-C</B> was placed on the command-line. This makes them a lower priority than any rules you specified explicitly. If you want to control where these CVS excludes get inserted into your filter rules, you should omit the <B>-C</B> as a command-line option and use a combination of <B>--filter=:C</B> and <B>--filter=-C</B> (either on your command-line or by putting the “:C” and “-C” rules into a filter file with your other rules). The first option turns on the per-directory scanning for the .cvsignore file. The second option does a one-time import of the CVS excludes mentioned above</FONT></DD> <DD> <BR> </DD> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"> <FONT FACE="FreeSans, sans-serif"><B>Destination is FAT/NTFS</B> <SPAN STYLE="font-weight: normal">refers to:</SPAN></FONT></P> <DT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>-t, --modify-window=1</B></FONT></DT></UL> <DD><FONT FACE="FreeSans, sans-serif">This is a useful when the destination file system is FAT/NTFS (windows).</FONT></DD> <DD><FONT FACE="FreeSans, sans-serif">When that is the case, many errors are encountered because windows file systems do not support all file atrributes that xNIX file systems do.<br> Moreover, rsync will compare the timestamps of files and decide if it will trigger a transfer. These timestamps are treated as being equal if they differ by no more than the modify-window value. Windows filesystems represent times with a 2-second resolution. This sometimes leads to rsync always performing data transfer although it shouldn't. To avoid this, the modify-window is set to a larger value.</FONT></DD> <DD><FONT FACE="FreeSans, sans-serif"><br><b>Note</b> that the following options:</FONT></DD> <DD><FONT FACE="FreeSans, sans-serif"> Preserve ownership, times</FONT></DD> <DD><FONT FACE="FreeSans, sans-serif"> Preserve permissions</FONT></DD> <DD><FONT FACE="FreeSans, sans-serif">are automaticaly disabled.</FONT></DD> <DD><FONT FACE="FreeSans, sans-serif"><br></FONT></DD> <DD><FONT FACE="FreeSans, sans-serif"><b>NOTE 2</b>: FAT/NTFS partitions should be mounted using the options "shortname=mixed" and "utf8=true" (if UTF8 file names are used) to avoid further errors.</FONT></DD> <DL> <DD STYLE="margin-bottom: 0.5cm"> <BR><BR> </DD></DL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"> <FONT COLOR="#000080"><FONT FACE="FreeSans, sans-serif"><B>User defined options</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>Add</B></FONT></P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>You can add any rsync option you wish by adding it to the <B>options</B> <B>list</B> in the following way:</FONT></FONT></P> <OL> <LI VALUE=1><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Use the text field located next to the add button to enter the option you would like to add.</FONT></FONT></P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Type the option, starting with a “<B>-</B>” or a “<B>--</B>” (without the quotes), followed by the appropriate string. Do not enter spaces.</FONT></FONT></P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Example: “ <B>--xattrs</B> ”</FONT></FONT></P> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Press the <B>add </B>button (or press ENTER), to add the entered option to the “options” list.</FONT></FONT></P> </OL> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <IMG SRC="data/OperationProperties_OptionsChanged2.png" NAME="graphics34" ALIGN=BOTTOM BORDER=0></P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif"><B>Remove</B></FONT></P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif" COLOR="#000080"><FONT SIZE=3>Remove an item:</FONT></FONT></P> <UL> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>click on it to highlight it </FONT></FONT> </P> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>click the <B>remove</B> button.</FONT></FONT></P> </UL> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif" COLOR="#000080"><FONT SIZE=3>Edit an item:</FONT></FONT></P> <UL> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>click on it to highlight it </FONT></FONT> </P> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>click the <B>edit</B> button.</FONT></FONT></P> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Change the item by using the keyboard.</FONT></FONT></P> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>click the <B>done</B> button.</FONT></FONT></P> </UL> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif" COLOR="#000080"><FONT SIZE=3>Move an item:</FONT></FONT></P> <UL> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>click on it to highlight it </FONT></FONT> </P> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>click the <B>move up or down</B> button.</FONT></FONT></P> </UL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><U><B>NOTE:</B></U> Please refer to the <B>man page of rsync </B>for a complete reference of all possible options.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"><A NAME="OperationAdvancedRemote"></A> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><B>Remote</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">It is possible to use luckyBackup, not only for local transfers, but also for remote ones.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Data transferring either to or from a remote host is possible.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Tasks between 2 remote hosts is not supported.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">To use this feature, simply check the <b>Use remote host</b> box located on top of the Remote <SPAN STYLE="font-weight: normal">tab.</SPAN></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/OperationPropertiesAdvancedEmpty4.png" NAME="graphics35" ALIGN=BOTTOM BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#000080"><FONT FACE="FreeSans, sans-serif"><B>Source or Destination</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">First, specify whether you want to use a remote host for your source or destination data by choosing an appropriate radio-button, located at the top of the <B>Remote</B> groupbox.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Please <U>note</U>, that the directory located at the remote host and will be used by luckyBackup as source or as destination, has to be declared at the appropriate text-edit fields, labeled <B>source</B> or <B>destination</B> <SPAN STYLE="font-weight: normal">accordingly, that are visible at “task properties - simple mode”.</SPAN></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#000080"><FONT FACE="FreeSans, sans-serif"><B>user</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Enter your username for the remote host at the <B>user</B> text-field.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#000080"><FONT FACE="FreeSans, sans-serif"><B>host</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Enter the name of the remote host you would like to connect to, at the <B>@Host</B> text-field.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Note that a host name can also be an ip address.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">host names examples:</FONT></P> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">freehosting.net</FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">89.70.191.201</FONT></P> </UL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#000080"><FONT FACE="FreeSans, sans-serif"><B>remote module</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Connecting to an rsync module.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">If you are contacting an rsync daemon at the remote system directly via TCP, then check the <B>Remote module</B> box.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Some modules on the remote daemon may require authentication.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">luckyBackup, does not support either the definition of passwords as a task property (for <b>security</b> reasons), or the entry of passwords when prompted at the stage of a task execution (because it is possible for the specific task to be <b>scheduled</b>).</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">If a password is required by the remote daemon, then you have to create a <B>password file</B> and declare it at the relevant text-field (use the browse button to open a graphical file dialog and select your already created file).</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><U>The password file must not be world readable </U>and it should contain just the password as a single line.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Please do not confuse the password to connect to an rsync module with the password needed if you use ssh as a transport shell.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#000080"><FONT FACE="FreeSans, sans-serif"><B>ssh</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">If you use ssh as a transport shell to connect to the remote host then check the <B>ssh</B> box.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">As clearly stated above (at the remote module section):</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">luckyBackup, does not support either the definition of passwords as a task property (for <b>security</b> reasons), or the entry of passwords when prompted at the stage of a task execution (because it is possible for the specific task to be <b>scheduled</b>).</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">For an ssh connection to become possible, you have to do all actions needed for a <U><B>password-less connection</B></U>, using an OpenSSH key pair.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><I>However, if you still wish to <B>use a direct password or protect your key with a passphrase</B>, then you have to either:<br> <b>1. </b><a href="#waysArguments">Execute luckybackup from a terminal</a>. Then, you will be prompted to enter your password/passphrase at that terminal and not via the gui. or...<br> <b>2. </b>Use the <b>ssh-askpass</b> tool (other variations such as ksshaskpass or ssh-askpass-gnome are possible). </I></FONT></P> <p align="center"><IMG SRC="data/ssh-askpass.png" NAME="sshAskpass36" ALIGN=MIDDLE BORDER=0></p> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Some helpful <SPAN STYLE="font-weight: normal">information on this ssh authentication scheme </SPAN>follows:</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><I>The <B>public key authentication scheme </B>is based on public-key cryptography, using cryptosystems where encryption and decryption are done using separate keys, and it is unfeasible to derive the decryption key from the encryption key.</I></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><I>The idea is that each user creates a public/private key pair for authentication purposes. The server knows the public key, and only the user knows the private key. <B>ssh </B>implements public key authentication protocol automatically, using either the RSA or DSA algorithms. The file ~/.ssh/authorized_keys lists the public keys that are permitted for logging in. When the user logs in, the <B>ssh</B> program tells the server which key pair it would like to use for authentication. The client proves that it has access to the private key and the server checks that the corresponding public key is authorized to accept the account.</I></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><I><B>example:</B></I></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><I>To create an appropriate public-private key pair, use the command</I></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=2><I><B><SPAN STYLE="background: #99ccff">$ ssh-keygen</SPAN></B></I></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><I>When prompted to enter a passphrase, just press “ENTER” twice (<U>no passphrase</U>).</I></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><I>This stores the private key in ~/.ssh/identity (protocol 1), ~/.ssh/id_dsa (protocol 2 DSA), or ~/.ssh/id_rsa (protocol 2 RSA) and stores the public key in ~/.ssh/identity.pub (protocol 1), ~/.ssh/id_dsa.pub (protocol 2 DSA), or ~/.ssh/id_rsa.pub (protocol 2 RSA) in your home directory.</I></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><I>Then copy the public key to ~/.ssh/authorized_keys in your home directory on the remote machine. The authorized_keys file corresponds to the conventional ~/.rhosts file, and has one key per line, though the lines can be very long. After this, you can log in without giving the password.</I></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><I>Please refer to the man page of ssh for a complete reference of ssh connections.</I></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Enter the full path of your private key file at the <B>private key file</B> text-field (use the <B>browse</B> button to open a graphical file dialog if you wish).</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Finally, specify the port to connect to, on the remote host, by entering its number at the <B>port</B> text-field. Leave it blank for the default ssh port (normally no.22).</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/OperationProperties_RemoteFull.png" NAME="graphics41" ALIGN=MIDDLE BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"><A NAME="OperationAdvancedAlsoExecute"></A> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><B>Also Execute</B></FONT></FONT></P> <p><br><br></p> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal"> <FONT COLOR="#000000"><FONT FACE="FreeSans, sans-serif">This option is used for the situation that you wish to run some commands before and/or after the task execution.</FONT></FONT></P> <p><br></p> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal"> <FONT COLOR="#000000"><IMG SRC="data/OperationPropertiesAdvancedEmpty8.png" NAME="graphics40" ALIGN=BOTTOM BORDER=0></FONT></P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal"> <FONT COLOR="#000000"><FONT FACE="FreeSans, sans-serif"> <p><br><br></p> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#000080"><FONT FACE="FreeSans, sans-serif"><B>add</B></FONT></FONT></P> <UL> <LI><FONT FACE="FreeSans, sans-serif">Select the “before” or “after” section according to whether you wish commands to be executed before or after the task.</FONT></LI> <LI><FONT FACE="FreeSans, sans-serif">Type the full name of the command, as well as any arguments at the text field.</FONT></li> <LI><FONT FACE="FreeSans, sans-serif">Click the <b>add</b> button, to add it to the list.</FONT></li> </FONT></FONT> </UL></P> <p><br></p> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/OperationPropertiesAlsoExecuteBefore.png" NAME="AlsoExecute36" ALIGN=MIDDLE BORDER=0></P> <p><br><br></p> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif" COLOR="#000080"><FONT SIZE=3>Remove an item:</FONT></FONT></P> <UL> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>click on it to highlight it </FONT></FONT> </P> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>click the <B>remove</B> button.</FONT></FONT></P> </UL> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif" COLOR="#000080"><FONT SIZE=3>Edit an item:</FONT></FONT></P> <UL> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>click on it to highlight it </FONT></FONT> </P> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>click the <B>edit</B> button.</FONT></FONT></P> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Change the item by using the keyboard.</FONT></FONT></P> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>click the <B>done</B> button.</FONT></FONT></P> </UL> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif" COLOR="#000080"><FONT SIZE=3>Move an item:</FONT></FONT></P> <UL> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>click on it to highlight it </FONT></FONT> </P> <LI><P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>click the <B>move up or down</B> button.</FONT></FONT></P> </UL> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal"> <A NAME="ByPassWarning"></A><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#000080"><FONT FACE="FreeSans, sans-serif"><B>STOP check boxes</B></FONT></FONT></P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal"> <FONT COLOR="#000000"><FONT FACE="FreeSans, sans-serif">On the left side of every command, there is a check-box available.<br> Check this to stop the task execution if the command exits with an error.</font></font></p> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal"> <A NAME="ByPassWarning"></A><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#000080"><FONT FACE="FreeSans, sans-serif"><B>by-pass warning</B></FONT></FONT></P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal"> <FONT COLOR="#000000"><FONT FACE="FreeSans, sans-serif">Checking this box means that all security checks that refer to this task will be skipped.<br> The task will run even if it appears with a WARNING message.<br> The checks by-pass, can be used when some pre-task execution commands can overcome possible warnings (eg mount a partition).</font></font></p> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal"> <FONT COLOR="#FF0000"><FONT FACE="FreeSans, sans-serif"><b>BEWARE</b></font></font>: <FONT COLOR="#000000"><FONT FACE="FreeSans, sans-serif">Only use this option if you really (I mean <b>really</b>) know what you are doing. </font></font></p> <P STYLE="margin-bottom: 0.2cm; font-weight: normal"><FONT color="#FF0000" face="FreeSans, sans-serif"><FONT SIZE=3><B>WARNING</B></font></font> <FONT face="FreeSans, sans-serif"><FONT SIZE=3>: The <A HREF="#startDryRun">Dry-run feature</A> only affects the main task and <b>NOT</b> pre/post command which are going to be executed normaly !!.</FONT></FONT></P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal"> <A NAME="ComplexAlsoExecuteCommands"></A><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#000080"><FONT FACE="FreeSans, sans-serif"><B>complex commands</B></FONT></FONT></P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal"> <FONT COLOR="#000000"><FONT FACE="FreeSans, sans-serif">Please note that luckybackup only supports the direct declaration of a command and its arguments. Complex command syntax is not (yet) supported. <br>This includes the use of pipelines (|) or backtits (`) or even redirect of a command's output with ">".<br> If you wish to use a "complex" syntax please create a bash script that contains your command(s) and enter the name of the script at the "also execute" field.</font></font></p> <p><br><br></p> <A NAME="OperationAdvancedValidate"></A> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><B>Validate</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">The </FONT><FONT FACE="FreeSans, sans-serif"><B>validate</B></FONT> <FONT FACE="FreeSans, sans-serif">pushbutton can prove useful, if you wish to perform some initial checks to all the fields you have declared at the task properties window.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">As soon as you click the </FONT><FONT FACE="FreeSans, sans-serif"><B>validate </B></FONT><FONT FACE="FreeSans, sans-serif">button, a pop-up message will apear, informing you of any errors or warnings found.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/Message_validate.png" NAME="graphics36" ALIGN=MIDDLE BORDER=0></P> <p><br></p> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">In addition to this, it will display the actual command that is going to be executed.<br> Click the <b>copy command to clipboard</b> button to be able to paste it wherever...<br><br> Click the <b>Okay</b> button to close this dialog.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"><A NAME="OperationAdvancedPatternRules"></A> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><B>Pattern rules</B></FONT></FONT></P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><SPAN STYLE="background: transparent">Patterns entered in the “Task properties” window must follow these rules:</SPAN></FONT></FONT></P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <UL> <LI><DD> <FONT FACE="FreeSans, sans-serif">If the pattern <B>starts with a /</B></FONT></DD><DD> <FONT FACE="FreeSans, sans-serif">then it is anchored to a particular spot in the hierarchy of files, otherwise it is matched against the end of the pathname. This is similar to a leading ^ in regular expressions.</DD><DD> Thus “/foo” would match a name of “foo” at the “<B>root of the transfer</B>". If you think of the transfer as a subtree of names that are being sent from sender to receiver, the transfer-root is where the tree starts to be duplicated in the destination directory. Because the matching is relative to the transfer-root, changing the <b>type of the backup affects</b> the path you need to use in your matching.</DD> <DD>An unqualified “foo” would match a name of “foo” anywhere in the tree because the algorithm is applied recursively from the top down; it behaves as if each path component gets a turn at being the end of the filename. Even the unanchored “sub/foo” would match at any point in the hierarchy where a “foo” was found within a directory named “sub”. </FONT> </DD> <LI><DD> <FONT FACE="FreeSans, sans-serif">if the pattern <B>ends with a /</B> </FONT> </DD><DD> <FONT FACE="FreeSans, sans-serif">then it will only match a directory, not a regular file, symlink, or device. </FONT> </DD><LI><DD> <FONT FACE="FreeSans, sans-serif">choosing between doing a <B>simple string match</B> and <B>wildcard matching</B> is done by checking if the pattern contains one of these 3 wildcard characters: ‘<B>*</B>’, ‘<B>?</B>’, and ‘<B>[</B>’. </FONT> </DD><LI><DD> <FONT FACE="FreeSans, sans-serif"><B>*</B></FONT></DD><DD> <FONT FACE="FreeSans, sans-serif">matches any non-empty path component (it stops at slashes). </FONT> </DD><LI><DD> <FONT FACE="FreeSans, sans-serif"><B>**</B></FONT></DD><DD> <FONT FACE="FreeSans, sans-serif">matches anything, including slashes. </FONT> </DD><LI><DD> <FONT FACE="FreeSans, sans-serif"><B>?</B></FONT></DD><DD> <FONT FACE="FreeSans, sans-serif">matches any character except a slash (/). </FONT> </DD><LI><DD> <FONT FACE="FreeSans, sans-serif"><B>[</B></FONT></DD><DD> <FONT FACE="FreeSans, sans-serif">introduces a character class, such as [a-z] or [[:alpha:]]. </FONT> </DD><LI><DD> <FONT FACE="FreeSans, sans-serif">in a wildcard pattern, a <B>backslash </B>can be used to escape a wildcard character, but it is matched literally when no wildcards are present. </FONT> </DD><LI><DD> <FONT FACE="FreeSans, sans-serif">if the pattern <B>contains a /</B> <SPAN STYLE="font-weight: normal">(not counting a trailing /) </SPAN>or a “<B>**</B>”</FONT></DD><DD> <FONT FACE="FreeSans, sans-serif">then it is matched against the full pathname, including any leading directories. If the pattern doesn't contain a / or a “**”, then it is matched only against the final component of the filename. (Remember that the algorithm is applied recursively so “full filename” can actually be any portion of a path from the starting directory on down.) </FONT> </DD><LI><DD> <FONT FACE="FreeSans, sans-serif">trailing “<B>dir_name/***</B>”</FONT></DD><DD STYLE="margin-bottom: 0.5cm"> <FONT FACE="FreeSans, sans-serif">matches both the directory (as if “dir_name/” had been specified) and everything in the directory (as if “dir_name/**” had been specified). You need rsync version 2.6 or later for this option.</FONT></DD></UL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"><A NAME="OperationAdvancedPatternEditor"></A> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><B>The pattern editor</B></FONT></FONT></P> <p><br></p> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><SPAN STYLE="background: transparent"> The pattern editor makes the definition of patterns much easier (...for some people).<br> You can just select the options you wish, using a graphical user interface (gui) and a pattern will be produced automatically and displayed at the <b>final pattern</b> field.<br> After having all the relevant fields of the gui filled, click the <b>okay</b> button to insert the final pattern at its final destination (eg an exclude/include pattern).<br> Click the <b>reset</b> button, any time, to reset all fields of the editor.<br><br> Have in mind the its <b>abilities</b> are <b>restricted</b> to simple and most frequently used patterns. <br> Not all possible <A HREF="#OperationAdvancedPatternRules">pattern rules</A> can be defined by this editor.</SPAN></FONT></FONT><br><br> <FONT FACE="FreeSans, sans-serif"><font size="3" color="#FF0000"><SPAN STYLE="background: transparent"><b>NOTE</b>: </SPAN></FONT></FONT> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><SPAN STYLE="background: transparent"> The patterns that the pattern editor produces are for <b>specific source and task type</b>. If these change, the patterns have to be re-declared. </SPAN></FONT></FONT> </P> <p><br></p> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#000080"><FONT FACE="FreeSans, sans-serif"><B> Specific directory</B></FONT></FONT></P> <p><br></p> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/PatternEditor1.png" NAME="PatternEditor1" ALIGN=MIDDLE BORDER=0></P> <p><br></p> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><SPAN STYLE="background: transparent"> Use this if you want the pattern to refer to a specific directory.<br> Click the <b>browse localy</b> button to select the directory you want the pattern to refer to.<br> eg /home/luckyb/Downloads/<br><br> Check the <b>Directory contents</b> box for the pattern to refer to the contents of this directory.<br> eg The contents of directory /home/luckyb/Downloads/<br><br> <FONT FACE="FreeSans, sans-serif"><font size="3" color="#FF0000"><SPAN STYLE="background: transparent"><b>NOTE</b>: </SPAN></FONT></FONT> If you use the pattern editor to define an <b>only include</b> directory, the <b>Directory contents</b> box has to be checked. </SPAN></FONT></FONT></P><p><br></p> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#000080"><FONT FACE="FreeSans, sans-serif"><B> Specific file</B></FONT></FONT></P> <p><br></p> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/PatternEditor2.png" NAME="PatternEditor2" ALIGN=MIDDLE BORDER=0></P> <p><br></p> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><SPAN STYLE="background: transparent"> Use this if you want the pattern to refer to a specific file.<br> Click the <b>browse localy</b> button to select the file you want the pattern to refer to.<br> eg /home/luckyb/Downloads/video.avi<br><br> <p><br></p> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#000080"><FONT FACE="FreeSans, sans-serif"><B> Set of directories</B></FONT></FONT></P> <p><br></p> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/PatternEditor4.png" NAME="PatternEditor4" ALIGN=MIDDLE BORDER=0></P> <p><br></p> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><SPAN STYLE="background: transparent"> Use this if you want the pattern to refer to a set of directories that their names have something in common, no matter their location inside the directory tree.<br> eg To refer to :<br> * all the directories that their name contains the characters "videos" (videos, videos_1, videos_2, my_videos etc): Type <b>videos</b> at the<b> contains :</b> field.<br> * all the directories that their name starts with the characters "vid" (videos, videos_1, videos_2, vids etc): Type <b>vid</b> at the<b> starts with :</b> field.<br> * all the directories that their name is exactly "videos" (videos...): Type <b>videos</b> at the<b> is exactly :</b> field.<br> <br> <p><br></p> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><SPAN STYLE="background: transparent"> If you wish to anchor the pattern to the root of the transfer, check the <b>use absolute path</b> box.<br><br> eg<br> To refer to all directories that their name contains the characters "videos" and are inside "/home/luckyb/Downloads" :<br> 1. Check the "use absolute path" box.<br> 2. Use the "browse localy" button to select the directory "/home/luckyb/Downloads".<br> 3. Type "videos" at the "contains :" field.<br> <br> <p><br></p> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><SPAN STYLE="background: transparent"> When the <b>use absolute path</b> box is selected, the pattern will only take into consideration, directories that are one level below the declared folder.<br> To refer to deeper levels of the directory tree, use the <b>go deeper in path by</b> spinbox.<br><br> eg:<br> The diredtory "/home/luckyb/Downloads", contains 3 sub-directories:<br> * Loukas (/home/luckyb/Downloads/Loukas/)<br> * Dimitra (/home/luckyb/Downloads/Dimitra/)<br> * Maria (/home/luckyb/Downloads/Maria/)<br><br> Each one of those 3, contain lots of stuff amongst whom one directory named "music".<br> To refer to all these directories that their name is "music" and are one level below "/home/luckyb/Downloads" :<br> 1. Check the "use absolute path" box.<br> 2. Use the "browse localy" button to select the directory "/home/luckyb/Downloads".<br> 3. Type "music" at the "is exactly :" field.<br> 4. Select "1" at the "go deeper in path by :" spin-box.<br> <br><br> You can also check the <b>any</b> box to go deeper in path by any level. <p><br></p> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#000080"><FONT FACE="FreeSans, sans-serif"><B> Set of files</B></FONT></FONT></P> <p><br></p> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/PatternEditor3.png" NAME="PatternEditor3" ALIGN=MIDDLE BORDER=0></P> <p><br></p> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><SPAN STYLE="background: transparent"> Use this if you want the pattern to refer to a set of files that their names have something in common, no matter their location inside the directory tree.<br> eg<br> To refer to all files that have ".avi" as an extension, type<b> .avi</b> at the <b>ends with :</b> field.<br><br> All options mentioned at the <b>Set of directories</b> section are valid, except the "Directory contents". </SPAN></FONT></FONT></P><p><br></p> <!-- ********************************* NOT JUST READY YET ************************************************--> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border-top: none; border-bottom: 1px solid #000000; border-left: none; border-right: none; padding-top: 0cm; padding-bottom: 0.07cm; padding-left: 0cm; padding-right: 0cm"><A NAME="notReady"></A> <BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <H1 STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><A HREF="#top"><IMG SRC="data/up.png" NAME="graphics14" ALIGN=LEFT WIDTH=24 HEIGHT=24 BORDER=0><BR CLEAR=LEFT></A><FONT COLOR="#800000"><FONT FACE="FreeSans, sans-serif">not just ready yet</FONT></FONT></H1> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-bottom: 0.1cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>So, you have managed to create a number of tasks and you are ready to execute all or some of them.</FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/MainWindowFull.png" NAME="graphics16" ALIGN=MIDDLE BORDER=0></P> <P STYLE="margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-bottom: 0.1cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Before doing so, you might want to review the following:</FONT></FONT></P> <P ALIGN=CENTER STYLE="margin-bottom: 0.1cm"><A NAME="NotReadyIncludeState"></A> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Include state</B></FONT></FONT></FONT></P> <P STYLE="margin-bottom: 0.1cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Change the include state of any existing task</FONT></FONT></P> <UL> <LI><P STYLE="margin-bottom: 0.1cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Just click on an include checkbox, at the left of an task's name to change its state to included (checked) or not included (unchecked)</FONT></FONT></P> </UL> <P STYLE="margin-bottom: 0.1cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Have in mind that only included tasks will be executed.</FONT></FONT></P> <P STYLE="margin-bottom: 0.1cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Also note that the include state is a basic property of a task, together with its name. Both these properties are saved inside a profile.</FONT></FONT></P> <P STYLE="margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-bottom: 0.1cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>As soon as you “include” a task you will notice that there is an icon at the left of the task's name as well as some text displaying in the information window:</FONT></FONT></P> <P STYLE="margin-bottom: 0.1cm; font-weight: normal"><BR><BR> </P> <A NAME="startDeclaredDataCheck"></A> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><B>declared data check</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>A directories check will be performed instantly. All declared folders will be checked to see if they are empty or if they exist and luckyBackup will warn you accordingly.</FONT></FONT></P> <P ALIGN=CENTER STYLE="margin-bottom: 0.3cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>This task is performed to protect your data, either source or already made backups.</B></FONT></FONT></P> <P ALIGN=CENTER STYLE="margin-bottom: 0.3cm"><BR><BR> </P> <P STYLE="margin-bottom: 0.3cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Please note that directory pairs statuses are divided into 3 categories:</FONT></FONT></P> <P STYLE="margin-bottom: 0.3cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>1. </B><FONT COLOR="#008000"><B>ok</B></FONT><B>:</B> Both dirs are ok.</FONT></FONT></P> <P STYLE="margin-bottom: 0.3cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>You are ready to go as far as this pair is concerned.</FONT></FONT></P> <P ALIGN=CENTER STYLE="margin-bottom: 0.3cm; font-weight: normal"> <IMG SRC="data/InfoWindow_TaskOk.png" NAME="graphics42" ALIGN=BOTTOM WIDTH=578 HEIGHT=158 BORDER=0></P> <P STYLE="margin-bottom: 0.3cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>2. </B><FONT COLOR="#b80047"><B>WARNING</B></FONT><B>:</B> This task will be skipped to avoid doing something stupid with your data !!</FONT></FONT></P> <P STYLE="margin-bottom: 0.3cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>The declared source directory does not contain any data or does not exist at all. Most possible situation, is that you have forgotten to mount a partition or have just mistyped a path. You wouldn't like the foolish rsync command to make your already existent 500GB backup (that took 2 days to create), vanish in a second so as to look the same with an empty directory !!</FONT></FONT></P> <P ALIGN=CENTER STYLE="margin-bottom: 0.3cm; font-weight: normal"> <IMG SRC="data/InfoWindow_TaskWarning.png" NAME="graphics55" ALIGN=BOTTOM WIDTH=577 HEIGHT=156 BORDER=0></P> <P STYLE="margin-bottom: 0.3cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>3. </B><FONT COLOR="#b3b300"><B>CRITICAL</B></FONT><B>:</B> This task will <U>NOT BE SKIPPED</U>. </FONT></FONT> </P> <P STYLE="margin-bottom: 0.3cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>The declared destination directory does not contain any data or does not exist at all. Most possible situation, is that you have forgotten to mount a partition or have just mistyped a path. Of course it might be the first time you perform the specific task, and you just want you destination folder to be created or fill with new data if it's empty.</FONT></FONT></P> <P STYLE="margin-bottom: 0.3cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Beware if it's not the first time you perform this task.</B></FONT></FONT></P> <P ALIGN=CENTER STYLE="margin-bottom: 0.3cm"><IMG SRC="data/InfoWindow_TaskCritical.png" NAME="graphics56" ALIGN=BOTTOM WIDTH=579 HEIGHT=159 BORDER=0></P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3 STYLE="font-size: 13pt"><SPAN STYLE="text-decoration: none"><B>ADVICE:</B></SPAN><SPAN STYLE="text-decoration: none"> Spend some time and have a good look at this window. Then decide wisely whether to “</SPAN><SPAN STYLE="text-decoration: none"><B>Go on</B></SPAN><SPAN STYLE="text-decoration: none">” and execute a bunch of rsync commands, or not and try to fix the errors that cause the “bad” status messages.</SPAN></FONT></FONT></P> <P ALIGN=CENTER STYLE="margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-bottom: 0.1cm"><A NAME="NotReadyExecutionOrder"></A> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Execution order</B></FONT></FONT></FONT></P> <P STYLE="margin-bottom: 0.1cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Tasks of a profile are executed sequentially, one by one at the order that they appear at the task list.</FONT></FONT></P> <P STYLE="margin-bottom: 0.1cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>You can change the execution order of the tasks within a profile:</FONT></FONT></P> <UL> <LI><P STYLE="margin-bottom: 0.1cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Click on an task to highlight it.</FONT></FONT></P> <LI><P STYLE="margin-bottom: 0.1cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Press the up/down arrow keys located at the right of the “Task List” to change its position inside the list.</FONT></FONT></P> </UL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-bottom: 0.1cm"><A NAME="NotReadySaveProfile"></A> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>Save profile</B></FONT></FONT></FONT></P> <P STYLE="margin-bottom: 0.1cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Now is good time (actually, every time you change something regarding a profile is a good time) to save the profile you created.</FONT></FONT></P> <UL> <LI><P STYLE="margin-bottom: 0.1cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Click on the “save” button or select “Profile → save” from the menu or just press ctrl+S .</FONT></FONT></P> </UL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <!-- ********************************* RUN ************************************************--> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border-top: none; border-bottom: 1px solid #000000; border-left: none; border-right: none; padding-top: 0cm; padding-bottom: 0.07cm; padding-left: 0cm; padding-right: 0cm"> <A NAME="purpleButton"></A> <BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <H1><A HREF="#top"><IMG SRC="data/up.png" NAME="graphics15" ALIGN=LEFT WIDTH=24 HEIGHT=24 BORDER=0><BR CLEAR=LEFT></A><FONT COLOR="#800000"> <FONT FACE="FreeSans, sans-serif">run</FONT></FONT></H1> <P STYLE="margin-bottom: 0.1cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>After all this preparation you are ready to have a go.</FONT></FONT></P> <P STYLE="margin-bottom: 0.1cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>Well, just a final thought that might save you from a lot of trouble. That would be a...</FONT></FONT></P> <P STYLE="margin-bottom: 0.1cm"><BR><BR> </P> <A NAME="startDryRun"></A> <P ALIGN=CENTER STYLE="margin-bottom: 0cm; font-weight: normal"><FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>simulation</B> execution</FONT></FONT></FONT></P> <P STYLE="margin-bottom: 0cm"><BR> </P> <P ALIGN=CENTER STYLE="margin-bottom: 0cm"><IMG SRC="data/MainWindow_DryRun.png" NAME="graphics48" ALIGN=BOTTOM BORDER=0></P> <P STYLE="margin-bottom: 0cm"><BR> </P> <P STYLE="margin-bottom: 0cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>If you are unsure of the effects on your data when executing an rsync command try the simulation option. luckyBackup will perform a trial run that doesn't make any changes (and produces mostly the same output as a real run).</FONT></FONT></P> <P STYLE="margin-bottom: 0.2cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><U>Note</U>: The progress-bar might be misleading when using this.</FONT></FONT></P> <P STYLE="margin-bottom: 0.2cm; font-weight: normal"><FONT color="#FF0000" face="FreeSans, sans-serif"><FONT SIZE=3><B>WARNING</B></font></font> <FONT face="FreeSans, sans-serif"><FONT SIZE=3>: The Dry-run feature only affects the main task and <b>NOT</b> <A HREF="#OperationAdvancedAlsoExecute">pre/post commands</A> which are going to be executed normaly !!.</FONT></FONT></P> <UL> <LI><P STYLE="margin-bottom: 0.3cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><SPAN STYLE="font-weight: normal">Check the “</SPAN><B>dry</B><B>” </B><SPAN STYLE="font-weight: normal">check-box </SPAN><SPAN STYLE="font-weight: normal">to enable this option.</SPAN></FONT></FONT></P> </UL> <P STYLE="margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><FONT SIZE=3><SPAN STYLE="font-weight: normal">Go on now. Click on that big purple button button that is clearly labeled: </SPAN></FONT><FONT COLOR="#800080"><FONT SIZE=3><B>Run</B></FONT></FONT><FONT SIZE=3><SPAN STYLE="font-weight: normal">.</SPAN></FONT></FONT></FONT></P> <P STYLE="margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-bottom: 0.1cm"><BR><BR> </P> <A NAME="startOperationsListCheck"></A> <P ALIGN=CENTER STYLE="margin-bottom: 0.1cm"><FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>task list check</B></FONT></FONT></FONT></P> <P ALIGN=CENTER STYLE="margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-bottom: 0.1cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>For safety reasons, luckybackup will first check the task list for “errors” and pop up a relevant warning message if something is found unsatisfactory.</FONT></FONT></P> <P STYLE="margin-bottom: 0.1cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>For example if you haven't included any tasks, you will get a warning message at the information window.</FONT></FONT></P> <P STYLE="margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><FONT SIZE=3><SPAN STYLE="font-weight: normal">The most important check of all is the one of </SPAN></FONT><FONT SIZE=3><B>many tasks that share the same destination</B></FONT><FONT SIZE=3><SPAN STYLE="font-weight: normal">.</SPAN></FONT></FONT></FONT></P> <P STYLE="margin-bottom: 0.1cm; text-decoration: none"><FONT FACE="FreeSans, sans-serif">When luckyBackup performs a task the “normal” way (meaning, you were not tempted to click that “advanced” button and change stuff), you end up with a destination directory that is identical to the source. Any file that existed at the destination and did not at the source, <U>will be deleted</U>. </FONT> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT FACE="FreeSans, sans-serif">Now imagine the situation of creating a number of tasks with different sources, the same destination (for example /media/backups) and “backup dir contents” as task type.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT FACE="FreeSans, sans-serif">The first task will execute ok resulting to a “cloned source” destination.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT FACE="FreeSans, sans-serif">The second task will clone the source again (which is different this time) to the same destination directory. This means the first task's backup will be lost. The second task will cancel the first.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> “<FONT FACE="FreeSans, sans-serif">backup dir by name” should have been selected as task type, so as to end up with the destination directory containing all the sources of your tasks as sub-folders.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>So do not be surprised if you face the following warning message as soon as you press the “start” button.</FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT COLOR="#000080"><IMG SRC="data/Message_SameDestinationWarning.png" NAME="graphics39" ALIGN=MIDDLE WIDTH=510 HEIGHT=335 BORDER=0></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <!-- ********************************* NORMAL RUN ************************************************--> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border-top: none; border-bottom: 1px solid #000000; border-left: none; border-right: none; padding-top: 0cm; padding-bottom: 0.07cm; padding-left: 0cm; padding-right: 0cm"> <A NAME="rsyncIt"></A> <BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <H1><A HREF="#top"><IMG SRC="data/up.png" NAME="graphics9" ALIGN=LEFT WIDTH=24 HEIGHT=24 BORDER=0><BR CLEAR=LEFT></A> <FONT COLOR="#800000"><FONT FACE="FreeSans, sans-serif">normal run</FONT></FONT></H1> <P STYLE="margin-bottom: 0.1cm"><BR><BR> </P> <P><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><SPAN STYLE="font-weight: normal">Well, you've done it. You wisely chose to </SPAN></FONT>“<FONT SIZE=3><B>Run</B></FONT>” <FONT SIZE=3><SPAN STYLE="font-weight: normal"> and let the party begin. The main window fills with scrolling data calculating and transferring, messages and the progress-bar shows the progress of the current task (not in <A HREF="#startDryRun">simulation mode</A>):</SPAN></FONT></FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT COLOR="#000080"><IMG SRC="data/rsync_InAction.png" NAME="graphics43" ALIGN=MIDDLE BORDER=0></FONT></P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"><b>NOTE</b> : The application window cannot be closed while task execution is in progress. If the window close button is clicked, luckyBackup will minimize to the tray area just like in <a href="#silentMode">silent mode</a>. <BR><BR> </P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><FONT SIZE=3><SPAN STYLE="font-weight: normal">Smash the “</SPAN></FONT><FONT SIZE=3><B>ABORT</B></FONT>” <FONT SIZE=3><SPAN STYLE="font-weight: normal">pushbutton any time during the execution of tasks if you feel like something is going wrong (or just want to see what will happen :-p).</SPAN></FONT></FONT></FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT COLOR="#000080"><IMG SRC="data/rsync_operations_aborted.png" NAME="graphics44" ALIGN=MIDDLE BORDER=0></FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><FONT SIZE=3><SPAN STYLE="font-weight: normal">Press the "</SPAN></FONT><FONT SIZE=3><B>shutdown</B></FONT>” <FONT SIZE=3><SPAN STYLE="font-weight: normal">pushbutton down to shutdown your system as soon as the execution of all tasks finishes.</SPAN></FONT></FONT></FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT COLOR="#000080"><IMG SRC="data/rsync_shutdown_button.png" NAME="shutdown-button" ALIGN=MIDDLE BORDER=0></FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><B>All done</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=3>As soon as all tasks are complete you will face the following window.</FONT></FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT COLOR="#000080"><IMG SRC="data/rsync_operations_completed.png" NAME="graphics45" ALIGN=MIDDLE BORDER=0></FONT></P> <A NAME="normalLog"></A> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><FONT SIZE=3><SPAN STYLE="font-weight: normal">Please notice that a </SPAN></FONT><FONT SIZE=3><B>log file</B></FONT> <FONT SIZE=3><SPAN STYLE="font-weight: normal">is created every time you come along this window. It is hosted in your home directory under </SPAN></FONT><FONT SIZE=3><B>~/.luckyBackup/logs</B> and can be viewed easily by using the <a href="#manageLogViewer">luckybackup logviewer</a> or any text file viewer.</FONT></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"><BR><BR></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR></P> <!-- ******************************************** SILENT MODE ******************************************************************** --> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border-top: none; border-bottom: 1px solid #000000; border-left: none; border-right: none; padding-top: 0cm; padding-bottom: 0.07cm; padding-left: 0cm; padding-right: 0cm"> <A NAME="silentMode"></A> <BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <H1><A HREF="#top"><IMG SRC="data/up.png" NAME="graphics9" ALIGN=LEFT WIDTH=24 HEIGHT=24 BORDER=0><BR CLEAR=LEFT></A> <FONT COLOR="#800000"><FONT FACE="FreeSans, sans-serif">silent mode</FONT></FONT></H1> <P STYLE="margin-bottom: 0.1cm"><BR><BR> </P> <P><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><SPAN STYLE="font-weight: normal"> <b>Silent</b>, as the word describes, is that mode when luckybackup is executed in a discrete way.<br> The application main window is not shown at all.<br> Instead, an icon appears at the tray notification area, together with a bubble message that informs the user of current action.<br> kde users will get feedback via their graphical environment's tray notification system. </SPAN></FONT></FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT COLOR="#000080"><IMG SRC="data/trayWithBubble.png" NAME="graphics43" ALIGN=MIDDLE BORDER=0></FONT></P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR></P> <P><FONT FACE="FreeSans, sans-serif"><FONT SIZE=3><SPAN STYLE="font-weight: normal"> Silent mode can be invoked by using the <b>--silent</b> argument. eg:</SPAN></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=2><B><SPAN STYLE="background: #99ccff"> luckybackup --silent [profile]</SPAN></B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif">Please refer to the <a href="#waysArguments">terminal arguments</a> chapter for a full <a href="#waysArgumentsOptions">[options]</a> and <a href="#waysArgumentsProfile">[profile]</a> description and usage.<br><br> After the profile execution is finished, the tray notification icon will stay there for a few seconds and then disappear, freeing the system's memory from any luckybackup process.<br> In simple words, the app will exit.<br><br> Click on the icon, any time during profile execution for the main application window to show.<br> <b>NOTE</b> that if you do, luckybackup will not exit as it would normaly do.<br><br> The silent mode can prove quite useful when executing luckybackup via <b>cron</b> or <b>anacron</b> or as <b>part a bash script</b>.<br> Each time the job is run, you will be informed by the icon and the bubble message. </FONT></P> <P ALIGN=LEFT STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <!-- ******************************************** COMMAND-LINE MODE ******************************************************************** --> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border-top: none; border-bottom: 1px solid #000000; border-left: none; border-right: none; padding-top: 0cm; padding-bottom: 0.07cm; padding-left: 0cm; padding-right: 0cm"> <A NAME="terminal"></A> <BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <H1><A HREF="#top"><IMG SRC="data/up.png" NAME="graphics11" ALIGN=LEFT WIDTH=24 HEIGHT=24 BORDER=0><BR CLEAR=LEFT></A> <FONT COLOR="#800000"><FONT FACE="FreeSans, sans-serif">terminal lovers</FONT></FONT></H1> <P><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">For those of you that for any reason would like to execute luckyBackup without a graphical user interface (gui), it is possible to run it in...<br></FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT COLOR="#800080"><br><B>command-line mode</B></FONT> </FONT> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"><BR><BR></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT COLOR="#000080"><IMG SRC="data/CommandLine.png" NAME="graphics37" ALIGN=MIDDLE BORDER=0></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif">Command-line mode can be quite useful at systems where <b>a graphical desktop is not available</b> (eg servers).<br> Note, that no graphical libraries are needed when running luckybackup in this mode.<br> It can safely be used at a terminal.<br><br> The creation of profiles, using this mode is not supported.<br> First, you have to have an already created profile by using the gui.<br> Then, just type the command:</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=2><B><SPAN STYLE="background: #99ccff"> luckybackup [options] [profile]</SPAN></B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <FONT FACE="FreeSans, sans-serif">Please refer to the <a href="#waysArguments">terminal arguments</a> chapter for a full <a href="#waysArgumentsOptions">[options]</a> and <a href="#waysArgumentsProfile">[profile]</a> description.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT COLOR="#000080"><IMG SRC="data/CommandLine_Profile_loaded.png" NAME="graphics46" ALIGN=MIDDLE BORDER=0></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"><FONT FACE="FreeSans, sans-serif"> The options that invoke the command-line mode are:</FONT></P> <ul> <li><font color="#0000FF" face="FreeSans, sans-serif"><b>-c</b></font></li> <li><font color="#0000FF" face="FreeSans, sans-serif"><b>--no-questions</b></font></li> </ul> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT COLOR="#000080"><IMG SRC="data/CommandLine_dirs_check.png" NAME="graphics47" ALIGN=MIDDLE BORDER=0></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"><FONT FACE="FreeSans, sans-serif"> When the execution of a profile at command-line mode finishes, the application provides the following <b>error codes</b>:<br><br> <b>1</b>: Something wrong with the arguments given at CL<br> <b>2</b>: The profile failed to load for a reason<br> <b>3</b>: Something is wrong with the task list (eg there is nothing to execute)<br> <b>4</b>: Something is wrong withe the declared directories<br> <b>6</b>: Errors found at rsync execution (or pre/post commands execution if any)<br> <b>0</b>: No errors - Everything went ok<br> </FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <!-- ******************************************** cron IT ******************************************************************** --> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border-top: none; border-bottom: 1px solid #000000; border-left: none; border-right: none; padding-top: 0cm; padding-bottom: 0.07cm; padding-left: 0cm; padding-right: 0cm"><A NAME="cronIt"></A> <BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <H1><A HREF="#top"><IMG SRC="data/up.png" NAME="graphics10" ALIGN=LEFT WIDTH=24 HEIGHT=24 BORDER=0><BR CLEAR=LEFT></A> <FONT COLOR="#800000"><FONT FACE="FreeSans, sans-serif">schedule</FONT></FONT></H1> <P><FONT FACE="FreeSans, sans-serif">It is possible for luckyBackup to “make arrangements” for specific profiles to be executed at regular intervals automatically, without the need to run the gui of the application.</FONT></P> <P><FONT FACE="FreeSans, sans-serif">If you wish to take advantage of that feature, click on the <FONT COLOR="#800080"><B>schedule</B></FONT> button located at the toolbar of the main window or select schedule from the <a HREF="#MainProfiles">profile</a> menu.</FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT COLOR="#000080"><IMG SRC="data/scheduleEmpty.png" NAME="graphics30" ALIGN=BOTTOM BORDER=0></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><A NAME="cronItAdd"></A> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><B>add</B></FONT></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">To add a new schedule, click the <B>add</B> button and define the following<SPAN STYLE="font-weight: normal">:</SPAN></FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/scheduleAdd.png" NAME="graphics57" ALIGN=BOTTOM BORDER=0></P> <OL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> </P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>Profile declaration</B></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><SPAN STYLE="font-weight: normal">Select an already existent profile from the </SPAN><B>Profile </B><SPAN STYLE="font-weight: normal">list</SPAN><SPAN STYLE="font-weight: normal">.</SPAN></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>Skip critical</B></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><SPAN STYLE="font-weight: normal">As described earlier, before the actual execution of tasks, luckyBackup first checks all declared data for errors and produces relevant messages. Those, that appear with a WARNING message are skipped anyway to protect your data. But those with a </SPAN><B>CRITICAL</B> <SPAN STYLE="font-weight: normal">message, although suspect, are not going to be skipped. If you wish the latter to be skipped at schedules then check the </SPAN><B>skip critical </B><SPAN STYLE="font-weight: normal">box.</SPAN></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><SPAN STYLE="font-weight: normal">The default and advised state of this check-box is </SPAN><U><SPAN STYLE="font-weight: normal">checked </SPAN></U><SPAN STYLE="font-weight: normal">(meaning skip all tasks that appear with a critical message).</SPAN></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif">Please refer to chapter <a HREF="#startDeclaredDataCheck">declared data check</a> for more information about messages.</FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>Console-mode</B></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"> <SPAN STYLE="font-weight: normal">Check this box if you wish this schedule to be executed in <a href="#terminal">command-line mode</a>.<br> Use this if there is no graphical environment available at your system (eg server).<br> Also use this option if there is a graphical environment available but you wish not to grant permission, to the user that runs luckybackup, to use it. This is almost always true for the super-user (see also <a href="#cronItTroubleshoot">troubleshooting</a>).</SPAN></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>Execute every</B></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">It is possible to schedule a specific profile to execute at a specific time, at specific intervals by declaring the following:</FONT></P> </OL> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><U>Month & day of month</U></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Declare the specific date you wish your profile to be executed, by selecting the relevant <B>month</B> & <B>day of month</B> (for example every February the 26<SUP>th</SUP>).</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">If you do not wish to use this option leave both listboxes to <B>Any</B>.</FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><U>Day of week</U></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Choose the day of week, you wish your profile to be executed (for example every Sunday). If you do not wish to use this option leave it to <B>Any</B>.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>NOTE</B>: If you use both “Month & day of month” and “Day of Week” then the profile will be executed when at least one of them matches the relevant time criteria. For example if you declare “every February the 26<SUP>th</SUP> “ as well as “every Sunday”, the schedule will run every Sunday <B>and</B> every February 26<SUP>th</SUP>.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>TIP</B>: If you wish the schedule to run <B>every day</B>, leave all 3 fields to <B>Any</B>.</FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><U>Time</U></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Declare the specific time at which you want a profile to be executed by entering appropriate data at the <B>hour</B> & <B>minute </B>boxes. Use the up/down arrows if you find them handy. e.g. for execution at time 17:45, enter hour:<B>17 </B>& minute:<B>45</B>.</FONT></P> </UL> <OL START=6> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>@reboot</B></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif">For the profile to be executed once, at system startup, check the <B>@reboot</B><B> </B>box.<br> Adjust the delay minutes to give your system enough time to settle.</FONT></P> </OL> <OL START=7> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>add</B></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif">To finish the procedure of adding a new schedule, click the <B>okay</B><B> </B>pushbutton.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif">A new line will appear at the window above “Profile execution details”, stating the profile you have chosen and when this is scheduled for execution.</FONT></P> </OL><p></p> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/scheduleAdded.png" NAME="graphics58" ALIGN=BOTTOM BORDER=0></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><A NAME="cronItModify"></A> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><B>modify</B></FONT></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">To modify an existing schedule:</FONT></P> <OL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Select a schedule at the window, so that it is highlighted and <SPAN STYLE="font-weight: normal">click the </SPAN><B>modify</B><SPAN STYLE="font-weight: normal"> button.</SPAN></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> <FONT FACE="FreeSans, sans-serif">Change everything at your will and click the <B>okay </B>button when you're finished.</FONT></P> </OL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><A NAME="cronItRemove"></A> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><B>remove</B></FONT></FONT></FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT COLOR="#000080"><IMG SRC="data/scheduleFull.png" NAME="graphics31" ALIGN=BOTTOM BORDER=0></FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <OL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Click on a schedule at the window to highlight it.</FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Click the <B>remove</B> pushbutton.</FONT></P> </OL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><A NAME="cronItCronIt"></A> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><B>cronIT</B></FONT></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Whenever you have finished adding, modifying, removing schedules click the <B>cronIT </B>pushbutton for the changes to take effect at your system.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT COLOR="#000080"><IMG SRC="data/scheduleUpdated.png" NAME="schedule_updated" ALIGN=BOTTOM BORDER=0></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><A NAME="cronItCrontabInfo"></A> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><B>crontab info</B></FONT></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">luckyBackup uses the <U>current user's</U> <FONT COLOR="#800080"><B>crontab</B></FONT> to schedule the execution of profiles.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Please do not confuse that with the file /etc/crontab <U>or</U> anacron. If you wish to use these instead, you must manually alter relevant configuration files by adding lines that will execute luckyBackup in <A HREF="#silentMode">silent</a> or <A HREF="#terminal">command-line mode</a>.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">See the man pages of cron and crontab (1 & 5) for more details.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"> To display the current crontab, click the <b>view current crontab</b> pushbutton located at the bottom left of the dialog.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT COLOR="#000080"><IMG SRC="data/scheduleViewCrontab.png" NAME="schedule_updated" ALIGN=BOTTOM BORDER=0></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">luckyBackup uses the <U>current user's</U> <FONT COLOR="#800080"><B>crontab</B></FONT> to schedule the execution of profiles.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><A NAME="cronItTroubleshoot"></A> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><B>Troubleshooting sheduled backups</B></FONT></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>1</B>: cron user permissions<br> If the <I>/etc/cron.allow</I> file exists, then you must be listed there in order to be allowed to use this feature. If the <I>/etc/cron.allow</I> file does not exist but the <I>/etc/cron.deny</I> file does exist, then you must <B>not</B> be listed in the <I>/etc/cron.deny</I> file in order to use this feature. If neither of these files exist, then depending on system-dependent configuration parameters, only the super user, or all users will be able to use this feature. For standard Debian systems, all users may use this feature.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Some useful (terminal/console) commands:</FONT></P> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=2><B><SPAN STYLE="background: #99ccff">crontab -l</SPAN></B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">causes the current crontab to be displayed on standard output.</FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=2><B><SPAN STYLE="background: #99ccff">crontab -r</SPAN></B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">causes the current crontab to be removed.</FONT></P> </UL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>2</B>: X-Server user permissions<br> It is essential for a user to execute luckybackup in <A HREF="#silentMode">silent mode</a> via cron, to be <b>allowed to connect to the X-server</b>.<br> For security issues, this is most of the times NOT the case for the<b> super user</b> and will be reported at the cronLogfile (see log-file below) as: <br><FONT FACE="FreeSans, sans-serif"><FONT SIZE=2><B><SPAN STYLE="background: #99ccff">Invalid MIT-MAGIC-COOKIE-1</b></span></font></font><br> or<br> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=2><B><SPAN STYLE="background: #99ccff">No protocol specified<br> luckybackup: cannot connect to X server :0</b></span></font></font><br> Please refer to unix/linux commands <b>XAUTH</b> and <b>XHOST</b> for a full understanding of X-Server access control issues.<br><br> If you do NOT wish to use the X-server, the <a href="#cronItAdd">console-mode option</a> is a nice workaround. Please note that no visual feeback will be available during profile execution. </FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>3</B>: cron locale settings <br> If one or more profiles or tasks contain specific language characters (eg Greek, Cyrillic etc) then it is possible for a cronjob regarding these specific profile(s) or task(s) to <b>NOT</b> execute correctly, leaving a precess named "luckybackup" running with no results.<br> This is due to cron locale settings and can be confirmed by running the command: <br><FONT FACE="FreeSans, sans-serif"><FONT SIZE=2><B><SPAN STYLE="background: #99ccff">locale</b></span></font></font> <br> both directly at a terminal and via a cronjob. The ouptut of the terminal command will look normal (eg <i>LC_CTYPE="en_US.UTF-8"</i>) but the output of the cronjob will not (eg <i>LC_CTYPE="POSIX"</i>).<br><br> <b>workaround</b>:<br>Create (if not already present) the file <b>/etc/environment </b>and add the following line <br><FONT FACE="FreeSans, sans-serif"><FONT SIZE=2><B><SPAN STYLE="background: #99ccff">LANG=en_US.UTF-8</b></span></font></font><br> The cron process will read this file when it starts, so you need to restart it in order to apply the change: <br><FONT FACE="FreeSans, sans-serif"><FONT SIZE=2><B><SPAN STYLE="background: #99ccff">service cron restart</b></span></font></font><br> </FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>4</B>: luckyBackup own cron config file<br> luckyBackup saves all the information of the “schedule dialog” at its own configuration file every time you click the cronIT button. That is irrelevant with the system's crontab and has the following effects:</FONT></P> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">luckyBackup does not interfere with other (if any) entries of your crontab. It just adds/changes/removes its own entries without affecting anything.</FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">If you alter or remove your crontab manually and accidentally delete luckyBackup entries, you can still open the “schedule dialog” (all the information will appear) and click “cronIT” for the deleted entries to recover.</FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">If you wish to delete all luckyBackup entries from your crontab, open the “schedule dialog”, “remove” everything and click “cronIT”.</FONT></P> </UL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><A NAME="cronItLogFile"></A> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><B>log-file</B></FONT></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">The output of execution of scheduled profiles is saved in the following log file located at your home directory:</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>~/.luckyBackup/logs/PROFILENAME-LastCronLog.log</B><br><br> This is different from the <a href="#normalLog">normal log-file</a> which will be created as well.<br> The cron logfile can prove handy to extract information about the cronjob itself </FONT></P> <!-- ******************************************** e-mail******************************************************************** --> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border-top: none; border-bottom: 1px solid #000000; border-left: none; border-right: none; padding-top: 0cm; padding-bottom: 0.07cm; padding-left: 0cm; padding-right: 0cm"> <A NAME="email"></A> <BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <H1><A HREF="#top"><IMG SRC="data/up.png" NAME="graphics10" ALIGN=LEFT WIDTH=24 HEIGHT=24 BORDER=0><BR CLEAR=LEFT></A> <FONT COLOR="#800000"><FONT FACE="FreeSans, sans-serif">e-mail</FONT></FONT></H1> <P><FONT FACE="FreeSans, sans-serif">luckyBackup can use already installed tools to send e-mail reports after a profile execution.</FONT></P> <P><FONT FACE="FreeSans, sans-serif">If you wish to take advantage of that feature, click on the <FONT COLOR="#800080"><B>email</B></FONT> button located at the toolbar of the main window or select email from the <a HREF="#MainProfiles">profile</a> menu.<br> After having finished editing the fields, click the "Okay" button to accept any changes and close the dialog. </FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT COLOR="#000080"><br><IMG SRC="data/eMailDialog.png" NAME="emaildialog" ALIGN=BOTTOM BORDER=0></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><A NAME="emailCommand"></A> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><B>command</B></FONT></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"> This field is used to define the full command with arguments to run so that an email is sent.<br><br></p> Although luckyBackup uses "sendemail" as default, you can use any command-line email tool you wish. Some examples follow: <ul> <li>sendemail (default)</li> <li>mail</li> <li>mutt</li> <li>pine</li> </ul> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><br> To revert this field to the default value which is: <br> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=2><B><SPAN STYLE="background: #99ccff">sendemail -f %f -t %t -u %s -m %b -a %l -s %v</b></span></font></font><br> click the <b>use default</b> button, on the right</FONT><br><br> <b>See also</b> the <a HREF="#emailArguments">arguments</a> section of this chapter.<br></P> <p><br></p> <p><b>NOTE on cron</b>: Depending on your distro, the mail command (eg sendemail) may not execute via cron due to a different location !!<br> eg cron is set up to only look at /usr/bin/ but sendemail is located under /user/local/bin/<br> workaround: Create a symlink eg # ln -sf /usr/local/bin/sendEmail /usr/bin/sendEmail</p> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><A NAME="emailConditions"></A> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><B>conditions</B></FONT></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"> Define here, various conditions that have to be met for an email message to be sent.</FONT></P> <OL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> </P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>Never</B></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><SPAN STYLE="font-weight: normal"> Check this to never send a message.<br> Leave unchecked to enable email sending after a profile run.</SPAN></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>Error(s) occurred</B></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><SPAN STYLE="font-weight: normal"> Check this to only send an email when errors occurred during a profile run.<br> If the total number of errors is zero, no message will be sent</SPAN></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>Scheduled</B></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><SPAN STYLE="font-weight: normal"> Check this to only send an email when the profile is run from within a <a href="#cronIt">cronjob</a>.</SPAN></FONT></P> </OL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><A NAME="emailArguments"></A> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><B>arguments</B></FONT></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"> Instead of typing normal text at the provided fields, you can type the percentage symbol (<b>%</b>), followed by a letter, to use one of the available variables.<br> In simple words, if you use a %[VARIABLE] syntax, this will be replaced by the corresponding value.<br> <b>eg</b> instead of typing the profile name, you can just enter <b>%p</b><br><br> These variables are divided to 2 categories <ol> <li><b>Editable</b></li> The value of these variables is defined by the user. <li><b>pre-defined</b></li> These refer to system or application defined variables that the user cannot change. </ol> <br><b>Note</b> that it is possible to use a variable inside a definition of another variable.<br> eg see "body"<br><br></p> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT COLOR="#000080"><IMG SRC="data/eMailMessage.png" NAME="emailmessage" ALIGN=BOTTOM BORDER=0></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><br><b>Available variables</b>: </FONT></P> <UL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; font-weight: normal"> </P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>from</B></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><SPAN STYLE="font-weight: normal"> reference: <b>%f</b><br> Enter the email address of the sender at the available field and use it as the variable value. </SPAN></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>to</B></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><SPAN STYLE="font-weight: normal"> reference: <b>%t</b><br> Enter the email address of the recipient at the available field to and use it as the variable value.</SPAN></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>subject</B> </FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><SPAN STYLE="font-weight: normal"> reference: <b>%s</b><br> Enter the subject of the message at the available field to and use it as the variable value.<br><br> To revert this field to the default value which is: <br> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=2><B><SPAN STYLE="background: #99ccff">luckyBackup report</b></span></font></font><br> click the <b>use default</b> button, on the right</SPAN></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>smtp</B></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><SPAN STYLE="font-weight: normal"> reference: <b>%v</b><br> Use the available field to enter the smtp server address and use it as the variable value.</SPAN></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>body</B></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><SPAN STYLE="font-weight: normal"> reference: <b>%b</b><br> Use the available field to enter the body of the message and use it as the variable value.<br><br> To revert this field to the default value which is: <br> <FONT FACE="FreeSans, sans-serif"><FONT SIZE=2><B><SPAN STYLE="background: #99ccff">Profile: %p<br> Date: %d<br> Time: %i<br> Errors found: %e</b></span></font></font><br> click the <b>use default</b> button, on the right</SPAN></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>logfile</B></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><SPAN STYLE="font-weight: normal"> reference: <b>%l</b><br> The value of this variable reflects the actual (full path) filename of the logfile.<br> <br><b>Note</b> that normally individual logfiles for each task are created after a profile run.<br> These are merged into a single one before the send process.</SPAN></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>date</B></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><SPAN STYLE="font-weight: normal"> reference: <b>%d</b><br> The date at the specific moment the profile run.</SPAN></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>time</B></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><SPAN STYLE="font-weight: normal"> reference: <b>%i</b><br> The time at the specific moment the profile run.</SPAN></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>profile name</B></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><SPAN STYLE="font-weight: normal"> reference: <b>%p</b><br> The profile name.</SPAN></FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><B>No of errors</B></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><SPAN STYLE="font-weight: normal"> reference: <b>%e</b><br> The value of this variable reflects the total number of errors that occured during the profile run.</SPAN></FONT></P> </UL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><A NAME="emailTest"></A></p> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><B>test</B></FONT></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"> Use the <b>test</b> button any time to send a message with the arguments provided.<br> The message will be sent as soon as the button is clicked.<br> A dialog will provide feedback about the email command run result.</FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT COLOR="#000080"><IMG SRC="data/eMailTest.png" NAME="emailtest" ALIGN=BOTTOM BORDER=0></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><A NAME="emailLogfile"></A></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"> <FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><FONT SIZE=4><B>logging</B></FONT></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"> A couple of logfiles are available after an email is sent and located at the user's home directory (~): <b>~/.luckyBackup/logs</b> <ol> <li><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><b>profile run output</b><br> This contains all the task's commands output.<br> It's contents are exactly the same with the <a href="#rsyncIt">command's output window</a>.<br> It's filename is <b>[PROFILE_NAME]-email.log</b></font></p></li> <li><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><b>email run output</b><br> The contents of this logfile contain the result of the last email attempt.<br> It's filename is <b>[PROFILE_NAME]-email-LastLog.log</b></ol></FONT></P></li> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <!-- ******************************************** MANAGE ******************************************************************** --> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border-top: none; border-bottom: 1px solid #000000; border-left: none; border-right: none; padding-top: 0cm; padding-bottom: 0.07cm; padding-left: 0cm; padding-right: 0cm"> <A NAME="manageMain"></A> <BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <H1><A HREF="#top"><IMG SRC="data/up.png" NAME="graphics12" ALIGN=LEFT WIDTH=24 HEIGHT=24 BORDER=0><BR CLEAR=LEFT></A><FONT COLOR="#800000"> <FONT FACE="FreeSans, sans-serif">The manage backup/sync task</FONT></FONT></H1> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"> This feature is used to manage already created backups.<br> Various tasks can be accomplished through the manage dialog, such as:</FONT></P> <ul> <li>Browse the destination and source</li> <li>View the log of a backup/sync task</li> <li>Delete a backup</li> <li>Restore</li> </ul> <P ALIGN=CENTER STYLE="margin-top: 0.5cm; margin-bottom: 0cm"> <IMG SRC="data/menuTask.png" NAME="manu_task" ALIGN=BOTTOM BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><br><br> To launch the manage dialog:</FONT></p> <P ALIGN=CENTER STYLE="margin-top: 0.5cm; margin-bottom: 0cm"> <IMG SRC="data/menuTask.png" NAME="manu_task" ALIGN=BOTTOM BORDER=0></P> <FONT FACE="FreeSans, sans-serif"><ol> <li>Highlight the task you wish to manage its backups.</li> <li>Select task -> <b>Manage Backup</b> from the main window <a href="#MainTasks">menu</a></li> </ol></FONT> <P ALIGN=CENTER STYLE="margin-top: 0.5cm; margin-bottom: 0cm"> <IMG SRC="data/manage_main_withSource.png" NAME="manage_main" ALIGN=BOTTOM BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><br><br> At the top of the window, the current profile and task are displayed.<br><br> On the left top side, there is a list of the backup snapshots of the task created so far.<br> You can select a snapshot by left clicking on the corresponding date-time field.<br><br> On the right, two browsers display the contents of the destination and source.<br> <b>NOTE</b> that the destination refers to the selected snapshot.<br> It is possible to change the browsers view so as only destination is visible, by checking the <b>hide source</b> box. </FONT></p> <P ALIGN=CENTER STYLE="margin-top: 0.5cm; margin-bottom: 0cm"> <IMG SRC="data/manage_main_withoutSource.png" NAME="manage_main2" ALIGN=BOTTOM BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><br><br> Beneath the snapshots area there are buttons that perform various actions.<br> These actions refer to the selected snapshot. </FONT></p> <A NAME="manageLogViewer"></A> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#000080"><FONT FACE="FreeSans, sans-serif"><B>View log</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"> Click the <b>view log</b> button to launch the log viewer for the selected snapshot</FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.5cm; margin-bottom: 0cm"> <IMG SRC="data/manage_logViewer.png" NAME="manage_logviewer1" ALIGN=BOTTOM BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><br> All the task execution progress of the specific snapshot is displayed.<br> Use the window scroll bar to navigate within the logfile.</FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.5cm; margin-bottom: 0cm"> <IMG SRC="data/manage_logViewer2.png" NAME="manage_logviewer2" ALIGN=BOTTOM BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"> <br> If there were errors during the task execution, you can jump to them by using the <b>next/previous</b> error buttons.</FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.5cm; margin-bottom: 0cm"> <IMG SRC="data/manage_logViewer_withError.png" NAME="manage_logviewer3" ALIGN=BOTTOM BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"> <br> <font color="#FF0000">Errors</FONT> are displayed in red color.<br> <font color="#A020F0">Information lines</FONT> are displayed in magenta or blue color.</FONT></P> <A NAME="manageCalcDifs"></A> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#000080"><FONT FACE="FreeSans, sans-serif"><B>Calculate differences</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"> Click the <b>Calculate differences</b> button for all the differneces between the source and the selected snapshot to be displayed.</FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.5cm; margin-bottom: 0cm"> <IMG SRC="data/manage_calcDifferences.png" NAME="manage_calcDifferences1" ALIGN=BOTTOM BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><br> There are <b>3</b> different categories of differences:<br><br> <font color="#0000FF">Snapshot data that also exists at the source and is different</FONT> <br> These snapshot data displayed in blue color, will replace the relevant source data during a RESTORE procedure<br><br> <font color="#00FF00">Snapshot data that do NOT exist at the source</FONT> <br> These snapshot data displayed in green color, will be transfered over at the source during RESTORE<br><br> <font color="#A020F0">Source data that do NOT exist at the snapshot</FONT> <br> These data that belongs to the source and is displayed in magenta color, will be deleted during RESTORE only if you enable the option: "<b>delete existing source data that do not exist at the backup</b>"</FONT></FONT></P> <A NAME="manageDelete"></A> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#000080"><FONT FACE="FreeSans, sans-serif"><B>delete backup</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"> Click the <b>delete</b> pushbutton to wipe out the selected snapshot.<br><br> You will first be WARNED by a dialog. This is the <b>first and last WARNING</b> you will receive.</FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.5cm; margin-bottom: 0cm"> <IMG SRC="data/manage_delete.png" NAME="manage_delete" ALIGN=BOTTOM BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><br><br> Click the start button to proceed to backup data deletion.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><br><br> <b>NOTE</b>:<br> <b>1. </b>If more than one snapshots exist, you can ONLY delete the earliest made snapshot.<br> <b>2. </b>If only one snapshot exists, the whole backup wil be deleted.</FONT></P> <A NAME="manageRestore"></A> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#000080"><FONT FACE="FreeSans, sans-serif"><B>restore</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"> The <b>restore</b> button's purpose is to transfer your data<br> <b>from</b> the selected backup created at a specific date & time (snapshot),<br> back <b>to</b> its original location (source).<br><br> </FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.5cm; margin-bottom: 0cm"> <IMG SRC="data/manage_restore.png" NAME="manage_restore" ALIGN=BOTTOM BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><br><br> Before you click the <b>start</b> button for the transfer to take place, take a minute to consider the following options:<br><br> <b>1. Delete existing source data that do not exist at the backup</b><br> This option is disabled by default.<br><br> If you leave it unchecked, the backup files will replace the corresponding source files.<br> Any source files that do not exist at the backup (eg files created after the snapshot) will <b>not</b> be deleted.<br><br> If you enable this option, all source data will be replaced by the backup.<br> You will end up with the source being identical to the snapshot.<br> That means that your original data will become exactly the same as it was at the moment you created the snapshot.<br> </FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.5cm; margin-bottom: 0cm"> <IMG SRC="data/manage_restore2.png" NAME="manage_restore2" ALIGN=BOTTOM BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><br><br> <b>2. Simulation</b><br> Check this option to perform a dry-run.<br> You will be presented by (mostly) the same output as a real run, but <b>no</b> data transfer will take place.<br> </FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"><br><br> <b>3. Change the restore path</b><br> It is possible to not restore the backup to its original place but anywhere.<br> Click the <b>change</b> pushbutton for a file browser to appear.<br> Select the new directory to restore the backup snapshot to and click ok. </FONT></P> <!-- ******************************************** restore procedure ******************************************************************** --> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border-top: none; border-bottom: 1px solid #000000; border-left: none; border-right: none; padding-top: 0cm; padding-bottom: 0.07cm; padding-left: 0cm; padding-right: 0cm"> <A NAME="restore"></A> <BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <H1><A HREF="#top"><IMG SRC="data/up.png" NAME="graphics12" ALIGN=LEFT WIDTH=24 HEIGHT=24 BORDER=0><BR CLEAR=LEFT></A><FONT COLOR="#800000"> <FONT FACE="FreeSans, sans-serif">restore</FONT></FONT></H1> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">The main goal of luckyBackup, as its name states, is the creation of backups of your data.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Somebody once said:</FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#800080">“ <FONT FACE="FreeSans, sans-serif"><B>if you haven't backed up your data is like not having them at all !! ”</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">That is because, based at the laws of probability, some time, for some reason, something will happen and you will lose valuable data. Another guy once said:</FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#800080">“ <FONT FACE="FreeSans, sans-serif"><B>computer users can be divided into 2 categories:</B></FONT></FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><B>Those that have lost data</B></FONT></FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#800080"><FONT FACE="FreeSans, sans-serif"><B>...and those that have not lost data YET ”</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">I really wish you to never come to that situation.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">But if you do, then I hope that you backed up your data the very last minute either by using this application or not :-)<br><br> luckybackup offers you 2 ways to restore your data:</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR></P> <A NAME="restoreWizard"></A> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#000080"><FONT FACE="FreeSans, sans-serif"><B>restore wizard</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"> This method is thoroughly described at the <a href="#manageMain">manage backup</a> - <a href="#manageRestore">restore chapter</a> of this manual.</FONT></P> <A NAME="restoreTask"></A> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT COLOR="#000080"><FONT FACE="FreeSans, sans-serif"><B>restore task</B></FONT></FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"> The second restore procedure that luckyBackup utilizes is actually a normal task that is created from the original one with some crucial changes:</FONT></P> <UL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">The <B>task</B><B> name</B> is changed so that it is distinguished from the original.</FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">A swap between the <B>source</B> and the <B>destination</B> is performed so that the destination becomes the source and the other way round.</FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">The “<B>skip newer destination files</B>” box, at the “options” groupbox of the modify task widow, is unchecked so that every file of the backup replaces the one that exists at the original data.</FONT></P> </UL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif"> The advantage of this method over the <a href="#restoreWizard">restore wizard</a> is that you have full control of the situation.<br> Modify the restore task as you wish by using the <a href="#propertiesAdvanced">modify dialog</a>.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">If you wish to create a restore task then proceed to the following:</FONT></P> <OL> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">At the application's main window, click on a task to highlight it and then select <b>Create Restore Task</b> from the <a href="#MainTasks">task menu</a>.</FONT></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><IMG SRC="data/menuTask.png" NAME="menuTask2" ALIGN=BOTTOM BORDER=0></P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">You will face the following message box:</FONT></P> </OL> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm; text-decoration: none"> <FONT COLOR="#000080"><IMG SRC="data/Message_CreateRestore.png" NAME="graphics29" ALIGN=MIDDLE BORDER=0></FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <OL START=3> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Click ok to proceed.</FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Another “task properties” window will appear. This is the restore task and it differs from the original at the 3 points just stated (name, source & destination, “skip newer files” option).</FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Change anything at your will (or just leave it as it is) and click the “Okay” button to create the RESTORE task.</FONT></P> <LI><P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><FONT FACE="FreeSans, sans-serif">Execute the RESTORE task as usual to restore your data at its original place.</FONT></P> </OL> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><BR><BR> </P> <!-- ******************************************** EPILOGUE ******************************************************************** --> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border-top: none; border-bottom: 1px solid #000000; border-left: none; border-right: none; padding-top: 0cm; padding-bottom: 0.07cm; padding-left: 0cm; padding-right: 0cm"> <A NAME="thanks"></A> <BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm; border: none; padding: 0cm"> <BR><BR> </P> <P STYLE="margin-top: 0.1cm; margin-bottom: 0.1cm"><A HREF="#top"><IMG SRC="data/up.png" NAME="graphics17" ALIGN=LEFT WIDTH=24 HEIGHT=24 BORDER=0><BR CLEAR=LEFT></A><BR><BR> </P> <H1 ALIGN=CENTER STYLE="margin-top: 0.1cm"><FONT COLOR="#800000"><FONT FACE="FreeSans, sans-serif">Epilogue</FONT></FONT></H1> <P ALIGN=CENTER STYLE="margin-top: 1.5cm"><FONT FACE="FreeSans, sans-serif"><B>Wish you good, fast, reliable, safe and usable backups</B></FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.2cm; font-weight: normal"><FONT FACE="FreeSans, sans-serif">(no matter if you use luckyBackup or not)</FONT></P> <P ALIGN=CENTER STYLE="margin-top: 0.5cm; margin-bottom: 0cm"><IMG SRC="data/luckyb.png" NAME="graphics8" ALIGN=BOTTOM WIDTH=48 HEIGHT=48 BORDER=0></P> <P ALIGN=CENTER><FONT FACE="FreeSans, sans-serif"><B>luckyb :-)</B></FONT></P> <P><FONT FACE="FreeSans, sans-serif"><BR></FONT><BR><BR> </P> <!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~` END PASTE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ --> </div> <!--content--> </div> <!--body --> <!-- ***************************** footer ******************************************************************* --> <div id="footer" class="clear"> <a class="gototop" title="go to top" href="#"> </div> <!-- ***************************** end footer ******************************************************************* --> </div> <!--wrapper--> </body> </html>