admbackup(1M) DG/UX R4.11MU05 admbackup(1M)
NAME
admbackup - manage backup and recovery of file systems
SYNOPSIS
admbackup -o create [ -f tape ] [ -M medium ] [ -n ] [ -O
dump2-option ] [ -p ] [ file-system ... ]
admbackup -o list [ -qv ] [ -f tape ]
admbackup -o restore [ -i ] [ -d directory ] [ -f tape ] [ -M medium
] file-system [ file ... ]
DESCRIPTION
The admbackup command manages the archiving and recovery of file
systems.
Backups are typically performed daily, weekly, and monthly. In order
to recreate the state of any file or file system, restore (with -o
restore) the previous monthly dump, each of the month's weekly dumps
in order, and each of the week's daily dumps in order.
A cycle list is maintained by admdumpcycle to keep track of which
type of backup (daily, weekly, or monthly) is to be performed next.
If at some point during the month the position in the cycle is
inaccurate, the position operation of admdumpcycle must be executed
to set the current position to the correct entry in the table.
Archives are created with dump2(1M) and restored with restore(1M).
Operations
create Create a backup tape (using dump2(1M)) of all appropriate
file systems. The dump cycle list is used to determine the
level of the dump being performed today (this level can be
overridden by specifying a dump level with the -O
dump2-option option). If no file systems are given on the
command line, or the special keyword all is used, the file
system table (see fstab(4)) is used to determine which file
systems match the current cycle entry. If the -n option is
not used, and no file-systems are given on the command
line, the current position in the dump cycle list is
advanced to the next position.
Backup tapes can be either "packed" or "not packed".
Packed tapes contain as many file systems as possible, one
after the other. This uses the smallest possible number of
tapes for the backup. Backup tapes which are not packed
have only one file system per tape. Unpacked tapes
minimize risk of lost data if one of the tapes becomes
unreadable; it also allows faster recovery of data because
there is less data on each tape.
list The list operation with no options lists the file systems
which need to be backed up today. In this case, admbackup
consults the dump cycle table to determine the current
cycle entry, and then searches the file system table to
determine which file systems belong to the current cycle
entry. If the -f tape option is given, the tape in drive
tape is read to determine which file systems are archived
on that tape; these file systems are listed to stdout.
restore Use restore(1M) to restore one or more files or an entire
file system from a tape created with -o create. The
interactive mode of restore (specified with the -i option)
is useful for perusing the directories on the backup tape
and extracting individual files. The non-interactive mode
is useful for recovering individual files or an entire file
system.
If no files are given, the entire file system is recovered.
Otherwise, only the named files are extracted. The files
must be specified relative to the root of the file-system.
Options
-d directory
Place the recovered files in directory. If this option is
not given, the files are placed in the current directory.
-f tape Use tape as the tape drive. The default is "/dev/rmt/0".
-i Use the interactive mode of the restore(1M) command. This
allows you to move through the directories on the backup
tape, selecting which files will be recovered.
-M medium Use medium as the medium name. When this option is used
with -o restore, the medium must be the same as for the
corresponding -o create. The medium must be a name from
the dump device table (see dumptab(4)). The default is
"default".
-n Do not update the database files which keep track of when
backups occur. This option is useful when an administrator
wants to perform an extra backup without disrupting the
normal backup schedule.
-O dump2-option
Append dump2-option to the list of options passed to the
dump2 program.
-p Pack as many file systems onto each tape as possible.
Otherwise, each file system is put onto a separate tape.
-q Use quiet mode. Headers for the list output are not
displayed
-v Use verbose mode. Headers for the list output are
displayed. This is the default behavior.
Output
The list operation writes its output on stdout. The restore
operation in interactive mode reads from stdin and writes to stdout.
During the create operation, output from the dump2(1M) command will
be written to stdout and to the /var/adm/log/backup.log file.
FILES
/etc/sysadm/dumpcycle
The default dump cycle for the system.
/etc/fstab
File system table used to determine which file systems are
eligible for create.
/var/adm/log/backup.log
Log file for dump2(1M)'s output.
DIAGNOSTICS
Exit Codes
0 The operation was successful.
1 The operation was unsuccessful.
2 The operation failed due to access restrictions.
3 There was an error in the command line.
SEE ALSO
admdumpcycle(1M), admdumpdevice(1M), dump2(1M), restore(1M),
sysadm(1M), dumpcycle(4M), dumptab(4), fstab(4),
appropriate_privilege(5).
cap_defaults(5).
NOTES
You must have appropriate privilege to perform the create and restore
operations. On a traditional DG/UX system, appropriate privilege is
granted by having an effective UID of 0 (root). See the
appropriate_privilege(5) man page for more information.
On a system with DG/UX information security, appropriate privilege is
granted by having one or more specific capabilities enabled in the
effective capability set of the user. See cap_defaults(5) for the
default capabilities for this command.
Licensed material--property of copyright holder(s)