What is this about ?
********************

This is an interactive script to write the latest backup to tape.

This is designed to be used with RsyncBackup which will have written
backups for one or more machines under /arch.

Installation
************

Copy the file WriteRsyncBackupToTape to /usr/local/bin and make it executable.
Note that this script used the Korn Shell (ksh), you may need to install
this on your machine.


The script writetape should also be copied to /usr/local/bin and made executable.
You may need to tweak it, eg specify the options for the tape device that you have.
This is the script that you tell the end user to run, ie they just type:

	writetape

Edit /etc/sudoers with something like that below. Substitute appropriate user
names and machine name:

	User_Alias BACKUP_ADMINS = john, addw

	BACKUP_ADMINS archive.example.co.uk = NOPASSWD:/usr/local/bin/writetape

You may want a varient of writetape for writing incremental backups.


Logging
*******

A log is written in /var/log/tapebackups/.

Options
*******

    -C dev
    	tape Control device, default /dev/st0

    -I
	Incrememtal backup since last complete tape backup.

	The file /arch/<MachineName>/FullTapeBackup is touched with the time
	of the file RsyncBackupSuccessTime. The file RsyncBackupSuccessTime is touched
	by RsyncBackup with the start time of it's backup.
	An incremental backup is for files newer than FullTapeBackup.

    -L
	Show the tape tabel that would be written to the tape, that is all.

    -l dir
	root Local directory, default is '/arch'.
	This is the directory under which machine specific backup directories will
	be found.

    -o
	Copy output to the current stderr as well as something in /var/log/tapebackups/.

    -m mach
	A space separated list of machines for which to write the Rsync backup to tape.
	Directories for these backups will be found under /arch.

    -N dev
    	tape device (no rewind on close), default /dev/nst0

    -T dev
    	tape device (rewind on close), default /dev/st0

    -v
	Tar verbose option

    -x
	eXplain -- give a help message.


License
*******

This software is copyright (c) Alain Williams <addw@phcomp.co.uk>, 2006.
This software is released under the GPLv3, see:

	http://www.gnu.org/licenses/gpl-3.0.html


Keeping up to date
******************

You may find newer versions of this software at:

	http://www.phcomp.co.uk/downloads.php

Where you will also find references to email lists that relate to this software.



Contributing
************

WriteRsyncBackupToTape is free software (see the license). Free software grows and becomes more
powerful and useful as those who gain by using it contribute their changes back
to the original author.

Contributions to this software are welcome. Please email the author the following:

* your name & email address
* your affiliation (company/institute/...) if any
* the code
* documentation
* a statement that you are legally able to release the code and documentation
* a statement transfering copyright to the Author below giving permission that it
  may be redistributed as part of UserAdmin under an appropriate license

Contributions will be acknowledged in the Contributors file that accompanies this
software. If you do not want to be acknowledged please make that clear.

The author will be pleased to receive your comments, good or bad.




SCCS: @(#)README	1.5 08/21/08 12:34:45

