.de IN
.in +.5i
..
.de BK
.in -.5i
..
.de BL
.nf
.ft B
..
.de BE
.fi
.ft R
..
.ce
\fB\s+2Using the Backup Program\s-2\fR
.sp 1
.NH
Introduction
.PP
The exabyte backup program is used to save files to the exabyte tapes.  This
document describes how the use the backup program.
.NH
Starting Backup
.LP
To start the backup program, log into the machine \*Qparis\*U as root.  This
can be accomplished from the \*QLogin:\*U prompt, or by using \*Qsu\*U while
logged in as the operator.  The computer does not have to be down in order to
run backup.  Once you are logged in as root, type:
.LP
.BL
     cd /usr/local/etc/ss
     ./backup
.BE
.LP
The program will initialize itself, which may take a few seconds.  It
will then ask you to insert a tape into the tape drive.
.NH
Inserting a Tape
.LP
When the backup program wants you to insert a tape it will put up a message
like the following:
.LP
.BL
     Insert the first Week3-Tuesday tape into the tape drive
     Type \*Qok\*U when the tape drive is ready
.BE
.LP
This is asking you to insert the tape that is labeled
\*Q\fBWeek3-Tuesday #1\fR\*U.  The program may later ask you to
insert the \*Q\fBsecond Week3-Tuesday\fR\*U tape, which refers to the
tape labeled \*Q\fBWeek3-Tuesday #2\fR\*U.  As usual if a tape that
is asked for doesn't exist, you should get a new tape, label it and use it.
The name of the tape that the program asks for will change from day to day
(i.e., next Wednesday, it may ask for \*Q\fBWeek4-Wednesday\fR\*U).
.LP
After you have inserted the tape, make sure to wait until the tape drive has
loaded the tape.  You will know that the tape has been loaded when the green
light on the tape drive turns on.  When the tape is done loading, type the
word \fIok\fR on the console, and the backups will begin.
.NH
Saves
.LP
After the tape has been inserted, the backup program will start performing
saves.  The program will only end when all saves have been finished or
when some unrecoverable error comes up.  You will be notified of
which saves are being performed with a message like:
.LP
.BL
     Save on host *blanche* beginning Tue Feb 14 17:25:21 1989
         Doing INCREMENTAL on path /usr/public
.BE
.LP
This lets you know that a save is being performed on the host \*Qblanche\*U and
that the files being backed up are in the path \*Q/usr/public\*U.
As soon as this save is done, a message like this one will be printed out:
.LP
.BL
         Save completed Tue Feb 14 17:26:56 1989
.BE
.LP
This lets you know that the save on blanche has been completed.  The backup
program will then go on and do the next save that needs to be done.  Note
that at any time during a save, the program may ask you to insert another
tape.  It will not always ask for tape changes between saves.
.NH
Handling Errors
.LP
Normally, your only job will be to change tapes on the tape drive.
Occasionally, errors will occur that will need your attention.
When this happens the program will print a message of the form \*QAn error has
occurred during this save\*U.  It will then print lines that contain the
options that you have.   You will then be asked to type in the action that
you want to take.
.LP
The choices that are printed out are structured so that the choice that you
should most likely make is at the top of the list.  If this is the first
error you have seen in a while, typing the first option is a good idea.  If,
however, the same error message keeps coming up, you should choose a more
drastic option, such as skipping or aborting saves.
.LP
The errors that could occur are as follows:
.NH 2
Tape Open Error
.LP
.BL
     The tape can't be opened for writing.
     Type \*Qretry\*U to try again
     Type \*Qabort\*U to abort all saves
.BE
.LP
This error indicates that the program couldn't gain access to the tape.  It
may be that you typed \*Qok\*U before the tape drive was finished loading or the
tape may be write protected.  Typing \fIretry\fR will cause the program to
try to open the tape again.  Typing \fIabort\fR will cause the backup program
to exit.
.NH 2
Read Error
.LP
.BL
     An error occurred while reading the files to be saved.
     Type \*Qretry\*U to try this save again.
     Type \*Qskip\*U to skip this save
     Type \*Qabort\*U to abort all saves
.BE
.LP
This indicates that something went wrong on the host where the files were
being read.  This may mean that there was some internal error in the program
or that the machine on which that save was taking place went down.  Typing
\fIretry\fR here will cause the tape to rewind (it may also ask you to change
tapes), and try doing the save again.  Typing \fIskip\fR will cause backup to
skip this save and go on to the next one.  \fIAbort\fR will cause the backup
program to exit.
.NH 2
Write Error
.LP
.BL
     An error occurred while writing to the tape.
     Type \*Qretry\*U to try this save again on the same tape.
     Type \*Qnew\*U to try this save again on a new tape.
     Type \*Qabort\*U to abort all saves
.BE
.LP
This indicates that something went wrong on the tape.  There may be a bad
spot on the tape or the heads may be dirty.  If this error comes up, it's a
good idea to retry the save once before concluding that there is something
wrong with the heads or the tape.  Typing \fIretry\fR will rewind the tape
(and possibly ask for a change of tapes), and try doing the save again.
Typing \fInew\fR will cause the backup program to give up on this tape.  It
will prompt you to insert a new tape, and the save will be done on that new
tape.  \fIAbort\fR causes the backup program to exit.
.NH 2
Time Out
.LP
.BL
     This save is taking too much time.  This may mean that some part
     of the save has failed.
     Type \*Qskip\*U to skip this save.
     Type \*Qcontinue\*U to continue with this save.
.BE
.LP
This message will come up after a save has taken too long to finish.  It
usually takes a few hours before the program will print out this message.  If
you agree that the save is taking to long, type \fIskip\fR, otherwise,
continue with the save by typing \fIcontinue\fR.
