Data ONTAP dump can write to its standard output (most useful with rsh(1) from a UNIX system), to a remote tape device on a host that supports the rmt(8) remote tape protocol, or to a local tape drive connected directly to the system (see na_tape(4)).
The tree argument specifies a volume, qtree, or other path name to be dumped. The specified tree may be in the active file system (for example: /vol/vol0/home) or in a snapshot (for example: /vol/vol0/.snapshot/weekly.0/home). If the tree is in the active file system, dump creates a snapshot named snapshot_for_dump.X where X is a sequentially incrementing integer. This naming convention prevents conflicts between concurrently executing dumps. The dump is run on this snapshot so that its output will be consistent even if the node is active. If dump does create a snapshot, it automatically deletes the snapshot when it completes.
If you do not explicitly name the volume of the dump (with the /vol prefix on the tree argument), the root volume is assumed to be specified.
dump 0ufb - 63 /vol/vol0
The following characters may be used to determine the behavior of dump.
It is recommended to be a bit conservative when using this option.
The `B' flag is one way to allow dump to work with remote tape devices that are limited to 2 GB of data per tape file.
X filelist
Specifies an exclude list, which is a comma-separated
list of strings. During a backup, a file is
excluded from the backup, if its name matches one
of the strings in the exclude list. The following
list describes the rules for specifying the
exclude list:
The name of the file must exactly match the string in the exclude list.
An asterisk is considered a wildcard character.
The wildcard character must be the first or last character of the string. Each string can contain up to two wildcard characters.
You cannot have a comma in the file name or pattern.
You can specify up to 32 strings in the exclude list.
b factor
Set the tape blocking factor in k-bytes. The
default is 63 KB. NOTE: Some systems support
blocking factors greater than 63 KB by breaking
requests into 63-KB chunks or smaller using variable
sized records; other systems do not support
blocking factors greater than 63 KB at all. When
using large blocking factors, always check the
system(s) where the potential restore might occur
to ensure that the blocking factor specified in
dump is supported. Data ONTAP restricts the
blocking factor for local tape devices to less
than or equal to 256 KB. Therefore larger blocking
factors should not be used on remote tape
devices if you may want to restore the data on the
tape from a local tape device.
f files
Write the backup to the specified files. files may be:
A list of the names of local tape devices, in the form specified in na_tape(4).
A list of the names of tape devices on a remote host, in the format host:devices. Host can be one of the following - the host name or IP address. An IP address can either be an IPv4 or IPv6 address. An IPv6 address, if used, must be enclosed in square brackets.
The standard output of the dump command, specified as -.
If the user specifies a list of devices, the list may have a single device or a comma-separated list of devices; note that the list must either contain only local devices or only devices on a remote host. In the latter case, the list must refer to devices on one particular remote host, for example:
tapemachine:/dev/rst0,/dev/rst1
Each file in the list will be used for one dump volume in the order listed; if the dump requires more volumes than the number of names given, the last file name will be used for all remaining volumes. In this case, the dump command at the console will prompt the user for media changes.
Use sysconfig -t for a list of local tape devices. See the EXAMPLES section below for an example of a dump to local tape.
For a dump to a tape device on a remote host, the host must support the standard UNIX rmt(8) remote tape protocol.
By default, dump writes to standard output.
n dumpname
Specifies the dumpname for a multi-subtree dump.
Mandatory for multi-subtree dumps.
All restartable dumps are listed by the backup status command.
toaster> dump 0ufbB adminhost:/dev/rst0 63 2097151 /vol/vol0
To make a level 0 dump of the /home directory on volume ``users'' on a 2 GB tape to a remote tape device, use:
toaster> dump 0ufbB adminhost:/dev/rst0 63 2097151 /vol/users/home
To make a level 0 dump of the /home directory on volume ``users'' to a remote tape device using IPv4 address, use:
toaster> dump 0ufbB aa.bb.cc.dd:/dev/rst0 63 2097151 /vol/users/home
To make a level 0 dump of the /home directory on volume ``users'' to a remote tape device using IPv6 address, use:
toaster> dump 0ufbB [xx:xx:xx:xx:xx:xx:xx:xx]:/dev/rst0 63 2097151 /vol/users/home
To make a level 0 dump of the /home directory on volume ``web'' on a 2 GB tape to a local tape drive (no rewind device, unit zero, highest density) use:
toaster> dump 0ufbB nrst0a 63 2097151 /vol/web/home
To make a level 0 dump of the entire file system of the root volume to a local tape drive (no rewind device, unit zero, highest density), with each tape file in the dump being less than 2 GB in size, without operator intervention, using a tape stacker, with four tape files written per tape, assuming that the dump requires no more than 10 GB, use:
toaster> dump 0ufbB nrst0a,nrst0a,nrst0a,urst0a,rst0a 63 2097151 /
This will:
Write the first three files to the norewind device, so that they, and the next dump done after them, will appear consecutively on the tape.
Write the next file to the unload/reload device. This will cause the stacker to rewind and unload the tape after the file has been written and then load the next tape.
Write the last file to the rewind device, so that the tape will be rewound after the dump is complete.
To back up all files and directories in a volume named engineering that are not in a qtree you created, use:
toaster> dump 0ufQ rst0a /vol/engineering
To run the dump command through rsh, enter the following command on a trusted host:
adminhost# rsh toaster dump 0ufbB adminhost:/dev/rst0 63 2097151 /home
To restart a dump on /vol/vol0/home, use:
toaster> dump Rf rst0a,rst1a,rst2a /vol/vol0/home
Client Dump and Restore Capability
If a client is to be used for performing node dump and/or
restore, it is important to check what the maximum dump
and restore capabilities of your client system are before
setting up a dump schedule. There are some client systems
which do not support dump and restore of greater than 2 GB
while others may support very large dumps and restores.
It is especially important to check the restore capability
of your system when using the node local tape dump since
the node supports dumps that are greater than 2 GB.
Tape Capacity and Dump Scheduling
Along with the potential 2-GB restriction of dump or
restore on a client system, it is important to consider
your tape capacity when planning a dump schedule. For the
node local tape option, the Exabyte 8505 supports an
approximate maximum capacity of 10 GB per tape using compression.
If a client system is used as the target for
your dump, the capacity of that tape drive should be
checked for dump planning.
If your node file system exceeds the capacity of the local tape drive or the client system dump/restore, or you choose to dump multiple file system trees to parallelize the restore process with multiple tape drives, you must segment your dump to meet these restrictions.
One way to plan a dump schedule with a UNIX client system is to go to the root mount point of your node and use the du command to obtain sizes of underlying subtrees on your node file system. Depending on the restrictions of your client's dump and restore capability or recording capacity of the tape device being used, you should specify a dump schedule that fits these restrictions. If you choose to segment your dump, the norewind device (see na_tape(4)) can be used to dump multiple tape files to one physical tape (Again, choose a dump size which meets the criteria of your client restore and capacity of your tape drive.).
The following example shows the du output from a node file system on a client that supports dump and restore that are greater than 2 GB:
client% du -s * 4108 etc 21608 finance 5510100 home 3018520 marketing 6247100 news 3018328 users