System Administration Commands ufsdump(1M)
NAME
ufsdump - incremental file system dump
SYNOPSIS
/usr/sbin/ufsdump [options] [arguments] files_to_dump
DESCRIPTION
ufsdump backs up all files specified by files_to_dump (usu-
ally either a whole file system or files within a file sytem
changed after a certain date) to magnetic tape, diskette, or
disk file.
The ufsdump command can only be used on unmounted file sys-
tems, or those mounted read-only. Attempting to dump a
mounted, read-write file system might result in a system
disruption or the inability to restore files from the dump.
Consider using the fssnap(1M) command to create a file sys-
tem snapshot if you need a point-in-time image of a file
system that is mounted.
options is a single string of one-letter ufsdump options.
arguments may be multiple strings whose association with the
options is determined by order. That is, the first argument
goes with the first option that takes an argument; the
second argument goes with the second option that takes an
argument, and so on.
files_to_dump is required and must be the last argument on
the command line. See OPERANDS for more information.
With most devices ufsdump can automatically detect the end-
of-media. Consequently, the d, s, and t options are not
necessary for multi-volume dumps, unless ufsdump does not
understand the way the device detects the end-of-media, or
the files are to be restored on a system with an older ver-
sion of the restore command.
OPTIONS
The following options are supported:
0-9 The "dump level." All files speci-
fied by files_to_dump that have been
modified since the last ufsdump at a
lower dump level are copied to the
dump_file destination (normally a
magnetic tape device). For instance,
if a "level 2" dump was done on Mon-
day, followed by a "level 4" dump on
Tuesday, a subsequent "level 3" dump
on Wednesday would contain all files
modified or added since the "level
2" (Monday) backup. A "level 0" dump
copies the entire file system to the
dump_file.
a archive_file Archive file. Archive a dump table-
of-contents in the specified
archive_file to be used by
ufsrestore(1M) to determine whether
a file is in the dump file that is
being restored.
b factor Blocking factor. Specify the block-
ing factor for tape writes. The
default is 20 blocks per write for
tapes of density less than 6250BPI
(bytes-per-inch). The default block-
ing factor for tapes of density
6250BPI and greater is 64. The
default blocking factor for car-
tridge tapes (c option) is 126. The
highest blocking factor available
with most tape drives is 126. Note:
the blocking factor is specified in
terms of 512-byte blocks, for compa-
tibility with tar(1).
c Cartridge. Set the defaults for car-
tridge instead of the standard
half-inch reel. This sets the den-
sity to 1000BPI and the blocking
factor to 126. Since ufsdump can
automatically detect the end-of-
media, only the blocking parameter
normally has an effect. When car-
tridge tapes are used, and this
option is not specified, ufsdump
will slightly miscompute the size of
the tape. If the b, d, s or t
options are specified with this
option, their values will override
the defaults set by this option.
d bpi Tape density. Not normally required,
as ufsdump can detect end-of-media.
This parameter can be used to keep a
running tab on the amount of tape
used per reel. The default density
is 6250BPI except when the c option
is used for cartridge tape, in which
case it is assumed to be 1000BPI per
track. Typical values for tape dev-
ices are:
1/2 inch tape
6250 BPI
1/4 inch cartridge
1000 BPI The tape densities and
other options are documented in
the st(7D) man page.
D Diskette. Dump to diskette.
f dump_file Dump file. Use dump_file as the file
to dump to, instead of /dev/rmt/0.
If dump_file is specified as -, dump
to standard output.
If the name of the file is of the
form machine:device, the dump is
done from the specified machine over
the network using rmt(1M). Since
ufsdump is normally run by root, the
name of the local machine must
appear in the /.rhosts file of the
remote machine. If the file is
specified as user@machine:device,
ufsdump will attempt to execute as
the specified user on the remote
machine. The specified user must
have a .rhosts file on the remote
machine that allows the user invok-
ing the command from the local
machine to access the remote
machine.
l Autoload. When the end-of-tape is
reached before the dump is complete,
take the drive offline and wait up
to two minutes for the tape drive to
be ready again. This gives autoload-
ing (stackloader) tape drives a
chance to load a new tape. If the
drive is ready within two minutes,
continue. If it is not, prompt for
another tape and wait.
L string Sets the tape label to string,
instead of the default none. string
may be no more than sixteen charac-
ters long. If it is longer, it is
truncated and a warning printed; the
dump will still be done. The tape
label is specific to the ufsdump
tape format, and bears no resem-
blance to IBM or ANSI-standard tape
labels.
n Notify all operators in the sys
group that ufsdump requires atten-
tion by sending messages to their
terminals, in a manner similar to
that used by the wall(1M) command.
Otherwise, such messages are sent
only to the terminals (such as the
console) on which the user running
ufsdump is logged in.
N device_name Use device_name when recording
information in /etc/dumpdates (see
the u option) and when comparing
against information in
/etc/dumpdates for incremental
dumps. The device_name provided can
contain no white space as defined in
scanf(3C) and is case-sensitive.
o Offline. Take the drive offline when
the dump is complete or the end-of-
media is reached and rewind the
tape, or eject the diskette. In the
case of some autoloading 8mm drives,
the tape is removed from the drive
automatically. This prevents another
process which rushes in to use the
drive, from inadvertently overwrit-
ing the media.
s size Specify the size of the volume being
dumped to. Not normally required, as
ufsdump can detect end-of-media.
When the specified size is reached,
ufsdump waits for you to change the
volume. ufsdump interprets the
specified size as the length in feet
for tapes and cartridges, and as the
number of 1024-byte blocks for
diskettes. The values should be a
little smaller than the actual phy-
sical size of the media (for exam-
ple, 425 for a 450-foot cartridge).
Typical values for tape devices
depend on the c option, for car-
tridge devices, and the D option for
diskettes:
1/2 inch tape
2300 feet
60-Mbyte 1/4 inch cartridge
425 feet
150-Mbyte 1/4 inch cartridge
700 feet
diskette
1422 blocks (Corresponds to a
1.44-Mbyte diskette, with one
cylinder reserved for bad block
information.)
S Size estimate. Determine the amount
of space that is needed to perform
the dump without actually doing it,
and display the estimated number of
bytes it will take. This is useful
with incremental dumps to determine
how many volumes of media will be
needed.
t tracks Specify the number of tracks for a
cartridge tape. Not normally
required, as ufsdump can detect
end-of-media. The default is 9
tracks. The t option is not compati-
ble with the D option. Values for
Sun-supported tape devices are:
60-Mbyte 1/4 inch cartridge 9
tracks
150-Mbyte 1/4 inch cartridge 18
tracks
T time_wait[hms] Sets the amount of time to wait for
an autoload command to complete.
This option is ignored unless the l
option has also been specified. The
default time period to wait is two
minutes. Specify time units with a
trailing h ( for hours), m (for
minutes), or s (for seconds). The
default unit is minutes.
u Update the dump record. Add an entry
to the file /etc/dumpdates, for each
file system successfully dumped that
includes the file system name (or
device_name as specified with the N
option), date, and dump level.
v Verify. After each tape or diskette
is written, verify the contents of
the media against the source file
system. If any discrepancies occur,
prompt for new media, then repeat
the dump/verification process. The
file system must be unmounted. This
option cannot be used to verify a
dump to standard output.
w Warning. List the file systems that
have not been backed up within a
day. This information is gleaned
from the files /etc/dumpdates and
/etc/vfstab. When the w option is
used, all other options are ignored.
After reporting, ufsdump exits
immediately.
W Warning with highlight. Similar to
the w option, except that the W
option includes all file systems
that appear in /etc/dumpdates, along
with information about their most
recent dump dates and levels. File
systems that have not been backed up
within a day are highlighted.
OPERANDS
The following operand is supported:
files_to_dump Specifies the files to dump. Usually it
identifies a whole file system by its raw
device name (for example,
/dev/rdsk/c0t3d0s6). Incremental dumps (lev-
els 1 to 9) of files changed after a certain
date only apply to a whole file system.
Alternatively, files_to_dump can identify
individual files or directories. All named
directories that may be examined by the user
running ufsdump, as well as any explicitly-
named files, are dumped. This dump is
equivalent to a level 0 dump of the indi-
cated portions of the filesystem, except
that /etc/dumpdates is not updated even if
the -u option has been specified. In all
cases, the files must be contained in the
same file system, and the file system must
be local to the system where ufsdump is
being run.
files_to_dump is required and must be the
last argument on the command line.
If no options are given, the default is 9uf /dev/rmt/0
files_to_dump.
USAGE
See largefile(5) for the description of the behavior of ufs-
dump when encountering files greater than or equal to 2
Gbyte ( 2**31 bytes).
EXAMPLES
Example 1: Using ufsdump
The following command makes a full dump of a root file sys-
tem on c0t3d0, on a 150-MByte cartridge tape unit 0:
example# ufsdump 0cfu /dev/rmt/0 /dev/rdsk/c0t3d0s0
The following command makes and verifies an incremental dump
at level 5 of the usr partition of c0t3d0, on a 1/2 inch
reel tape unit 1,:
example# ufsdump 5fuv /dev/rmt/1 /dev/rdsk/c0t3d0s6
EXIT STATUS
While running, ufsdump emits many verbose messages. ufsdump
returns the following exit values:
0 Normal exit.
1 Startup errors encountered.
3 Abort - no checkpoint attempted.
FILES
/dev/rmt/0 default unit to dump to
/etc/dumpdates dump date record
/etc/group to find group sys
/etc/hosts to gain access to remote system with
drive
/etc/vfstab list of file systems
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWcsu |
|_____________________________|_____________________________|
SEE ALSO
cpio(1), tar(1), dd(1M), devnm(1M), fssnap(1M), prtvtoc(1M),
rmt(1M), shutdown(1M), ufsrestore(1M), volcopy(1M),
wall(1M), scanf(3C), attributes(5), largefile(5), st(7D)
NOTES
Read Errors
Fewer than 32 read errors on the file system are ignored.
Process Per Reel
Because each reel requires a new process, parent processes
for reels that are already written hang around until the
entire tape is written.
Operator Intervention
ufsdump requires operator intervention on these conditions:
end of volume, end of dump, volume write error, volume open
error or disk read error (if there are more than a threshold
of 32). In addition to alerting all operators implied by the
n option, ufsdump interacts with the operator on ufsdump's
control terminal at times when ufsdump can no longer
proceed, or if something is grossly wrong. All questions
ufsdump poses must be answered by typing yes or no, as
appropriate.
Since backing up a disk can involve a lot of time and
effort, ufsdump checkpoints at the start of each volume. If
writing that volume fails for some reason, ufsdump will,
with operator permission, restart itself from the checkpoint
after a defective volume has been replaced.
Suggested Dump Schedule
It is vital to perform full, "level 0", dumps at regular
intervals. When performing a full dump, bring the machine
down to single-user mode using shutdown(1M). While prepar-
ing for a full dump, it is a good idea to clean the tape
drive and heads. Incremental dumps should be performed with
the system running in single-user mode.
Incremental dumps allow for convenient backup and recovery
of active files on a more frequent basis, with a minimum of
media and time. However, there are some tradeoffs. First,
the interval between backups should be kept to a minimum
(once a day at least). To guard against data loss as a
result of a media failure (a rare, but possible occurrence),
capture active files on (at least) two sets of dump volumes.
Another consideration is the desire to keep unnecessary
duplication of files to a minimum to save both operator time
and media storage. A third consideration is the ease with
which a particular backed-up version of a file can be
located and restored. The following four-week schedule
offers a reasonable tradeoff between these goals.
Sun Mon Tue Wed Thu Fri
Week 1: Full 5 5 5 5 3
Week 2: 5 5 5 5 3
Week 3: 5 5 5 5 3
Week 4: 5 5 5 5 3
Although the Tuesday through Friday incrementals contain
"extra copies" of files from Monday, this scheme assures
that any file modified during the week can be recovered from
the previous day's incremental dump.
Process Priority of ufsdump
ufsdump uses multiple processes to allow it to read from the
disk and write to the media concurrently. Due to the way it
synchronizes between these processes, any attempt to run
dump with a nice (process priority) of `-5' or better will
likely make ufsdump run slower instead of faster.
Overlapping Partitions
Most disks contain one or more overlapping slices because
slice 2 covers the entire disk. The other slices are of
various sizes and usually do not overlap. For example, a
common configuration places root on slice 0, swap on slice
1, /opt on slice 5 and /usr on slice 6.
It should be emphasized that ufsdump dumps one ufs file sys-
tem at a time. Given the above scenario where slice 0 and
slice 2 have the same starting offset, executing ufsdump on
slice 2 with the intent of dumping the entire disk would
instead dump only the root file system on slice 0. To dump
the entire disk, the user must dump the file systems on each
slice separately.
BUGS
The /etc/vfstab file does not allow the desired frequency of
backup for file systems to be specified (as /etc/fstab did).
Consequently, the w and W options assume file systems should
be backed up daily, which limits the usefulness of these
options.
|
|