Topic Content |
FTP Account Additional File Filter Modify Files Before Transfer to This Target Transfer Options File Options Miscellaneous |
| |
This option defines Target properties for FTP (file transport protocol) servers and folders. |
| |
FTP Account |
| Select a name of a pre-configured FTP account from the drop down list. If there is none, or you need to create a new one, access FTP account properties as described below. |
| Click the 'Edit' button to access the FTP Accounts manager where you can create and configure your FTP accounts. Detailed information about this can be found here. |
| a name of the FTP server directory, where files from Source are to be transferred to. That should be a full path from the server's root but excluding the FTP server address. Example: /FTP/IN/DATA/ A note on VMS FTP servers:
| ▪ | Notation: AnyFileBackup recognises whether a remote server runs VMS and automatically converts UNIX/Linux notation into appropriate VMS notation. Therefore, you must use usual UNIX/Linux notation for pointing to the remote directory ('/FTP/IN/DATA/') instead of VMS notation ('[FTP.IN.DATA]'). |
| ▪ | Passive mode: use FTP passive mode when connecting to a VMS-based FTP server. |
|
| When AnyFileBackup transfers Source files to Target, it does not create a Source folder itself in Target. However, this may be changed. A simple example will illustrate the difference. Example: | ▪ | Source and its content: C:Datareadme.txt |
| ▪ | Target and its content after file transfer: |
-- Outcome 1 (Target path is not modified): D:Backupreadme.txt -- Outcome 2 (Target path is modified by adding the Source folder name): D:BackupDatareadme.txt Modifying Target path may be necessary when multiple Source folders are being transferred to a single Target. |
| |
Additional File Filter |
Additional File Filter distinguishes files by mask. The following operators and wildcards may be used: | ▪ | * (asterix): means ANY number of ANY symbols |
| ▪ | ? (question mark): means ANY SINGLE ONE symbol |
| ▪ | . (dot): means a delimiter which is normally used to separate a filename and a file extension |
| ▪ | ; (semicolon): means a delimiter which is used to separate one file mask from another; no space is necessary either before or after it |
Combinations of the above are also allowed: see Example No.3 below. The below examples describe a situation of a file being included. All these equally work in relation to files being excluded. | | Example No.1: | ▪ | Included files: file*.docx (that means that any file that has its filename starting with a word 'file' and has a 'docx' extension will be included) |
| ▪ | Files that will be included: file-01-01-2012.docx, file120101.docx, file1Jan2012.docx |
| ▪ | Files that will NOT be included: file01.01.12.doc |
| Example No.2: | ▪ | Included files: file??????.docx (that means that any file that has its filename starting with a word 'file', has a 'docx' extension and has any six symbols between a ford 'file' and a dot will be included) |
| ▪ | Files that will be included: file120101.docx |
| ▪ | Files that will NOT be included: file-01-01-2012.docx, file1Jan2012.docx, file01.01.12.doc |
| | | Example No.3: | ▪ | file????2012.* : any file that has its filename starting with a word 'file', has any four symbols between a word 'file' and '2012' and has any extension will be included (note that if a file has neither an extension nor a dot after '2012' it will NOT be included because a dot ('.') symbol is an essential part of its filename). |
| ▪ | file*201?.* : any file that has its filename starting with a word 'file', has any number of symbols between a word 'file' and '201', ends with any one undefined symbol and has any extension will be included (note that if a file has neither an extension nor a dot after '201[ANY-SYMBOL]' it will NOT be included because a dot ('.') symbol is an essential part of its filename). |
| ▪ | file????2012.doc? : any file that has its filename starting with a word 'file', has any four symbols between a word 'file' and '2012' and has extension that starts with 'doc' with any single one symbol at the end (or even none at all, so 'file01012012.doc' is also covered) will be included. |
|
|
| A list of file masks that describe files to be transferred to this particular Target. Please note, that these masks should somehow overlap with masks specified in SOURCE > Additional File Filter > Included Files (if in use) and should not be completely excluded by masks specified in SOURCE > Additional File Filter > Included Files (if in use). Otherwise, no files will be transferred to this Target. |
| A list of file masks that describe files not to be transferred to this particular Target. |
| |
Modify Files Before Transfer to This Target |
This option (previously known as 'Pre-processing') applies to all files before they are transferred to this Target. The underlying idea is that files may be transferred to some Targets as usual (without any modifications: compression, encryption, etc), and to other Targets (for which this option is enabled) in compressed and (or) encrypted form. Equally, if files are already compressed and (or) encrypted, they may be uncompressed and (or) decrypted before being transferred to Target(s). File modification may take additional time when large files or significant number of files are processed. |
| A type of modification that is applied to each file before it is transferred to Target. The following options are available: | ▪ | 'Compress': compress each file reducing its size using ZIP compression algorithm. Compression options can be configured in the Modification options window (described below). File Compression extension is required to use this option. |
| ▪ | 'Uncompress': extract each file from an archive using ZIP compression algorithm. It has no options. File Compression extension is required to use this option. |
| ▪ | 'Encrypt': encrypt each file using an encryption algorithm and password selected in the Modification options window (described below). File Encryption extension is required to use this option. |
| ▪ | 'Decrypt': decrypt each file using an encryption algorithm and password selected in the Modification options window (described below). File Encryption extension is required to use this option. |
| ▪ | 'Compress and encrypt': this option combines the compression and encryption functions. First, AnyFileBackup compresses a file using ZIP algorithm and then, secondly, encrypts the compressed file with a supported encryption algorithm. Additional compression and encryption options can be configured in the Modification options window (described below). File Compression and File Encryption extensions are required to use this option |
| ▪ | 'Decrypt and uncompressed': performs decryption and uncompression operations in a manner described in the 'Compress and encrypt' option above but in a reverse order. |
|
| Click the 'Configure' button to access the Modification Options. Encryption / Decryption Options | ▪ | 'Encryption type': An encryption method that is used to encrypt or decrypt files. The following types are currently available: AES, Blowfish, DES, PGP, Triple-DES, and ZIP. |
| ▪ | 'Account name': A name of a pre-configured account that contains a password (for AES, Blowfish, DES, Triple-DES, and ZIP encryption types) or a PGP key with password (for a PGP encryption type). |
| ▪ | 'Account properties': Opens a properties window for the selected account. If no account is selected, the Account Manager window that fits the selected encryption type will be opened. |
Compression Options '--' (=none): file will be archived 'as is', without any folders; 'Relative': file will be archived with folder where it is located; 'Full': file will be archived with full path (but excluding drive and server names). | ▪ | 'Make timestamp of archive and file the same': if enabled, an archive will have timestamp identical to that of a file inside of it. |
| ▪ | 'To a single archive': if enabled, all files that are within task's scope will be packed into a single archive file. The archive's filename can be set in the 'Archive name' field below. |
| ▪ | 'Archive name': a name of a single archive into which all Source files are packed. If left blank, the default template will be used which is ${DATE=yyyy.mm.dd}-${TIME=hh-nn-ss} and the resulting archive filename will look like '2014.05.25-10.30.00.zip'. You may use both macros and other symbols to define the archive name. |
|
| |
Transfer Options |
| ▪ | Skip locked or inaccessible files |
| When enabled, AnyFileBackup will skip files that cannot be accessed for whatever reason. These files will be marked as not copied and AnyFileBackup will attempt to transfer them during the next scheduled task execution. When disabled, the whole situation will be considered as an error. What will happen next depends on default and task-specific Error handling rules. The task will either: | ▪ | continue execution (the default setting), or |
| ▪ | stop until the next scheduled start, or |
| ▪ | deactivate until the next Task Processor restart or manual task activation. |
This option is incompatible with Two-Way Synchronization mode. |
| ▪ | Use FTP compression (MODE Z) |
| When enabled, activates compression of any traffic transmitted between AnyFileBackup and FTP server. This reduces overall file transfer time. |
| This is the maximum incoming speed of file transfer to Target set in bytes per second. When left blank, the speed is unlimited. You can also configure outgoing speed of file transfer from Source in the Source settings. |
| When transferring large files with identical filenames from Source to Target(s), AnyFileBackup can ensure that a file in Target will not be replaced by a file from Source until such Source file is fully transferred to Target. This file transfer method is known as a 'safe transfer' and, when FTP is concerned, it can work in either of two modes: | ▪ | 'Type 1': First, the Source file is transferred to Target with a temporary name (different from that of the Target file). Secondly, when the Source file is fully transferred to Target, its filename is changed to its proper [Source] name replacing the Target file. |
| ▪ | 'Type 2': First, the Source file is transferred to Target with a temporary name (different from that of the Target file). Secondly, when the Source file is fully transferred to Target, the Target file is deleted (this may be necessary due to permissions' restriction on file renaming). Thirdly, and finally, the Source file's name is changed to its proper [Source] name. |
Select 'None' to disable safe transfer. The main advantage of this method is full protection from accidental interruptions during file transfer process which otherwise may cause only partial transfer of files. This method of transfer also has certain disadvantages: | ▪ | it reduces AnyFileBackup overall performance because of additional copying and renaming operations, and |
|
| This option defines what happens to files that have been uploading to FTP sever but have not been uploaded because of connection interruption. | ▪ | 'Re-upload (restart upload)': after interruption files will be uploaded again from the beginning. It is recommended to use this option for binary files. |
| ▪ | 'Restore (resume upload)': after connection the upload will resume and those parts of files that [parts] have already been uploaded will not be uploaded again. This option may save upload time and traffic. |
|
| ▪ | Use server-to-server transfer |
| This data transfer method connects two FTP servers with another another without routing data through the client computer / server. The advantage is avoiding time losses and maximizing transfer speed which [speed] does not depend on the client connection speed limit but only on the connection speed between the two FTP servers. The requirements of these method are that both FTP servers: | ▪ | support PASV (passive) mode |
| ▪ | allow PORT command for foreign hosts |
This transfer method can NOT be used with either of these: | ▪ | Secure Protocol Extension |
|
| |
File Options |
| When enabled, changes the filename case in Target as follows: | ▪ | - (=none): no changes to the filename, or |
All letters in both the filename and extension will be converted to upper or lower case as the case may be. |
| ▪ | Set original file timestamp |
| If enabled, Target file will have exactly the same timestamp as its Source counterpart. If disabled, Target file will have timestamp that reflects time of its transfer to Target. |
| If enabled, Source full subfolder structure will be transferred to Target with Source files allocated to their respective subfolders. If disabled, all Source files will transferred to Target as if Source files were in one single folder; no subfolders are transferred to Target. |
| This option is visible only when Source is also FTP. If enabled, FTP file permissions set for a Source file will be set for a Target file. If disabled, Target FTP default permissions will apply which depend on the configuration of Target FTP server. |
| This options allows to set file permissions in numeric format for users of FTP Target. The following combinations are most common: 0000 | no permissions | 0111 | execute | 0222 | write | 0333 | write & execute | 0444 | read | 0555 | read & execute | 0666 | read & write | 0777 | read, write, & execute |
For more information please read a very helpful article on Wikipedia. |
| |
Miscellaneous |
| ▪ | Notify if server is inaccessible |
| If AnyFileBackup cannot read the Source's content for whatever reason (e.g., Source does not exist, access to Source is blocked by a firewall policies, etc), AnyFileBackup can notify you about this error by e-mail. Notification settings can be set up in 'Program Settings' > 'Error Handling'. |
| Press the 'Start' button to direct AnyFileBackup to immediately launch this action. This will verify whether all above settings were entered correctly; all errors, if any, will be displayed in a log window. |
| If enabled, this action is active and will be used in Scenario. If disabled, it will remain in the Task Scenario but will be completely ignored by task. To distinguish it from enabled actions, disabled actions are strokeout and coloured in gray. |
| This is a custom name that will be displayed in the Task Scenario instead of the default title. Press the 'Apply' button for changes to take effect. |