rmirror - An LCFG component for offline disc mirroring.
This object carries out offline mirroring by invoking rsync.
A list of disks to be rsynced to the local machine.
The host serving the disk tag. The source disk is expected to be accessible to rsync as srchost::tag, so there should be an rsync server daemon running on the source machine, offering the source disk as rsync module tag. This can be set up using the rsync LCFG component.
The local destination directory holding the mirror for disk tag.
When set to true rmirror tells rsync to use the --checksum option. When rsync is deciding which files need to be transferred to bring the mirror up to date, this makes rsync checksum all files before transfer, and transfer any files whose checksum and/or size does not match that of the corresponding file already on the rmirror. This option effectively makes rmirror more meticulous when checking for file corruption.
When set to false checksum-checking will not be used on files whose mirror has the same timestamp and size.
The default value is false.
When set to true this option overrides the current setting of the checksum resource for disk tag only. Its default value is the same as for the checksum resource.
Rmirror normally does a "dry run" of its rsync command to calculate how much of the mirror's current contents it would delete, before going ahead with the mirroring operation (see the description of the safetylimit option below). The rsync command used to perform this dry run is usually identical to the "real" rsync command but with the addition of the rsync --dry-run option. However when inhibitsafetychecksum is set to true rmirror will not use the --checksum option during the rsync dry run. (Of course, if checksum is not set to true, rsync's --checksum option will not be used at all anyway.) Using inhibitsafetychecksum can significantly reduce the time taken to mirror a large collection of files when checksum is set to true, at the expense of getting a less accurate estimate of the number of files to be deleted in cases where files on the mirror have become corrupted (for example by filesystem damage).
The default value is false.
When set to true this option overrides the current setting of the inhibitsafetychecksum resource for disk tag only. Its default value is the same as for the checksum resource.
When set to true, rsync will not copy any files whose existing mirror copies are already the same length and have the same timestamp.
When set to false rmirror tells rsync to use the --ignore-times option, which makes rsync ignore timestamps when deciding which files to copy.
The default value is true.
When set to true this option overrides the current setting of the timestamp resource for disk tag only. Its default value is the same as for the timestamp resource.
When set to true this option tells rsync to use its --whole-file option. This makes rsync copy across whole files which have changed, rather than using its incremental algorithm to copy across only the changes.
When set to false rsync will use its default behaviour, which is to use its incremental algorithm - that is, copying across only the parts of files which have changed - unless both source and target are on the local machine. This option will often result in quicker running of rmirror, but may lead to any temporary corruption of a file on the source machine persisting indefinitely in the target machine's copy of the file.
The default value is false.
When set to true this option overrides the current setting of the wholefiles resource for disk tag only. Its default value is the same as for the wholefiles resource.
When set to true this option makes rmirror tell rsync to use its --delete-after option. This makes rsync delete outdated files on the target system after copying across changes from the source system.
When set to false this option makes rmirror tell rsync to use its default file deletion behaviour, which is to delete outdated files on the target system before copying across changes from the source system.
The default value is false.
When set to true this option overrides the current setting of the deleteafter resource for disk tag only. Its default value is the same as for the deleteafter resource.
This resource is the time, in seconds, before rmirror gives up on an apparently dormant rsync process on a remote machine, times it out, and goes on to the next backup to be performed. The timeout option sets the timeout value for all rmirror backups on this machine. The default value is 3600, meaning one hour. To disable timeouts set this option to 0.
This resource overrides the current setting of the timeout resource for disk tag only. It has the same default value as the timeout resource.
This resource is the maximum percentage of the files in the existing backup copy that it is permissible for an rmirror run to delete. Just before rmirror performs a backup, it calculates what percentage of the files in the existing backup would be deleted by the backup running again; and if this percentage is greater than the maximum allowable percentage in the safetylimit resource, the backup is cancelled and a warning is given. The default value of safetylimit is 10, meaning that a backup will not run if it would mean deleting more than 10% of the existing backup files.
This resource overrides the current setting of the safetylimit resource for disk tag only. It has the same default value as the safetylimit resource.