NAME

backup - suite of commands for archiving volumes with the AFS Backup System. 

SYNOPSIS

backup <option>

Each of the the following operation codes is a valid <option> and has its own set of associated arguments.  See the "OPTIONS" section below for syntax definitions. 

abort - abort a dump
adddump - add dump schedule
addhost - add host to config
addvolentry - add a new volume entry
addvolset - create a new volume set
apropos - search by help text
check - check the status of a dump
deldump - delete dump schedule
delhost - delete host to config
delvolentry - delete a volume set sub-entry
delvolset - delete a volume set
diskrestore - restore partition
dump - start dump
enumtape - list all the volumes on tape
help - get help on commands
jobs - list running jobs
kill - kill running job
labeltape - label a tape
listdumps - list dump schedules
listhosts - list config hosts
listvolsets - list volume sets
quit - leave the program
readlabel - read the label on tape
status - get tape coordinator status
volrestore - restore volume - initialize Tape Coordinator

DESCRIPTION

The commands in the backup suite are an interface to the AFS Backup System, which helps streamline the archiving of file system data onto permanent storage media such as tape.  There are backup commands that allow system administrators to define the sets of volumes to be backed up together and a dependency tree for incremental backups, and to dump volumes to tape and restore them to the file system. 

OPTIONS

abort - abort a dump
syntax: backup abort  -id <dump ID>  -portoffset <TC port offset>  [-help]

adddump - add dump schedule
syntax: backup adddump  -dump <dump schedule name>+  [-parent <parent dump schedule name>]  [-help]

addhost - add host to config
syntax: backup addhost  -tapehost <tape machine name>  [-portoffset <TC port offset>]  [-help]

addvolentry - add a new volume entry
syntax: backup addvolentry  -name <volume set name>  -server <machine name>  -partition <partition name>  -volume <volume name (regular expression)>  [-help]

addvolset - create a new volume set
syntax: backup addvolset  -name <volume set name>  [-help]

apropos - search by help text
syntax: backup apropos  -topic <help string>  [-help]

check - check the status of a dump
syntax: backup check  -id <dump ID>  [-portoffset <TC port offset>]  [-help]

deldump - delete dump schedule
syntax: backup deldump  -dump <dump schedule name>  [-help]

delhost - delete host to config
syntax: backup delhost  -tapehost <tape machine name>  [-portoffset <TC port offset>]  [-help]

delvolentry - delete a volume set sub-entry
syntax: backup delvolentry  -name <volume set name>  -entry <volume set entry index>  [-help]

delvolset - delete a volume set
syntax: backup delvolset  -name <volume set name>+  [-help]

diskrestore - restore partition
syntax: backup diskrestore  -server <machine to restore> -partition <partition to restore>  [-portoffset <TC port offset>]  [-newserver <destination machine>]  [-newpartition <destination partition>]  [-n]  [-help]

dump - start dump
syntax: backup dump  -volumeset <volume set name>  -dump <dump name>  [-portoffset <TC port offset>]  [-help]

enumtape - list all the volumes on tape
syntax: backup enumtape  -name <tape name>  [-help]

help - get help on commands
syntax: backup help  [-topic <help string>+]  [-help]

jobs - list running jobs
syntax: backup jobs  [-help]

kill - kill running job
syntax: backup kill -id <job ID or dump set name>  [-help]

labeltape - label a tape
syntax: backup labeltape  [-name <tape name, defaults to NULL>]  [-size <tape size in Kbytes, defaults to size in tapeconfig>]  [-portoffset <TC port offset>]  [-help]

listdumps - list dump schedules
syntax: backup listdumps  [-help]

listhosts - list config hosts
syntax: backup listhosts  [-help]

listvolsets - list volume sets
syntax: backup listvolsets  [-name <volume set name>]  [-help]

quit - leave the program
syntax: backup quit  [-help]

readlabel - read the label on tape
syntax: backup readlabel  [-portoffset <TC port offset>]  [-help]

status - get tape coordinator status
syntax: backup status  [-portoffset <TC port offset>]  [-help]

volrestore - restore volume
syntax: backup volrestore  -server <destination machine>  -partition <destination partition>   -volume <volume(s) to restore>+  [-extension <new volume name extension>]  [-id <volume ID of restored volume>]  [-date <date from which to restore>]  [-portoffset <TC port offset>]  [-n]  [-help]

  —  Last change: 30 April 1990