bak restoreftfamily(8dfs)

Restores a fileset family or one or more specified filesets from tape

Synopsis

bak restoreftfamily {-family fileset_family_name | -file filename} [-tcid tc_number]
[-noaction] [-help]

Options

-family fileset_family_name
Specifies a fileset family to be restored. The command restores all of the filesets in each of the fileset entries in the specified fileset family. Refer to the topic entitled Using the -family Option for information about using this option. Either this option or the -file option must be specified.

-file filename
Specifies the full path name of a file from which the command is to read the name of each fileset to be restored and the site (File Server machine and aggregate) to which the fileset is to be restored. Specify each fileset and site on a separate line, using the following format:

machine aggregate fileset

Refer to the topic entitled Using the -file Option for information about using this option. Either this option or the -family must be specified.

-tcid tc_number
Specifies the Tape Coordinator ID (TCID) of the Tape Coordinator for the tape drive in which you are placing the necessary tapes. If this option is omitted the TCID defaults to 0 (zero).

-noaction
Directs the command to produce a list of filesets it would restore without actually restoring the filesets. The command also provides additional information, such as the tapes that contain dumps of the filesets and the sites to which the filesets would be restored. Include the other options as you would to actually execute the command. You can use this option with the -family option to write a list of filesets to a file, which you can then modify for use with the -file option. See Output for information about using the -noaction option.

-help
Prints help for this command. All other valid options specified with this option are ignored.

Description
The bak restoreftfamily command restores the contents of specified filesets from tape to the file system. The command performs a full restore of each indicated fileset, restoring data from the last full dump and all subsequent incremental dumps (if any) of each fileset. Use the -family option or the -file option to indicate the filesets to be restored, as follows:

· The -family option lets you restore all of the filesets included in the fileset entries in a specified fileset family. The command reads the Fileset Location Database (FLDB) to determine the filesets to be restored and restores them to their current sites.

· The -file option lets you restore specific individual filesets that have entries in a specified file. The command restores each fileset to the site you specify.

The -noaction option instructs the command to produce a list of the filesets it would restore without actually restoring any filesets. The command also provides information about the tapes that contain dumps of the filesets. You can use the -noaction option without the -file option to determine the tapes required to restore the indicated filesets. You can also use the -noaction option with the -family option to construct a list of filesets that would be restored with a specifies fileset family; you can then modify the list of filesets as necessary to produce a file for use with the -file option.

The bak restoreftfamily command is useful for recovering from catastrophic losses of data, such as the loss of all filesets on multiple aggregates of a File Server machine or the loss of multiple aggregates from multiple File Server machines. In such cases, the command provides a better approach to recovery than the bak restoreft command or the bak restoredisk command because

· It allows you to restore either individual filesets or specialized collections of filesets.

· It allows you to restore different filesets to different sites.

Conversely, the bak restoreft command restores one or more filesets to a single site, and the bak restoredisk command restores all filesets that reside on a single aggregate to a single aggregate. The bak restoreftfamily command provides greater breadth to a restore operation than the other commands that restore data, which instead provide convenient depth.

Regardless of the command used, data can be dumped and restored between different types of file systems. For example, data dumped from a DCE LFS fileset can be restored to a DCE LFS fileset or to any type of non-LFS fileset; likewise, data dumped from a non-LFS fileset can be restored to DCE LFS fileset or to a different type of non-LFS fileset. (See you vendor's documentation to verify the level of support for dump and restore operations between different types of file systems.)

Restored data is translated into the appropriate format for the file system to which it is restored. Note that incompatible information may be lost when a fileset is dumped and restored between different types of file system. For example, ACLs on objects in a DCE LFS fileset may be lost if the fileset is restored to a file system that does not support ACLs.

More:

Using the -family Option

Using the -file Option

Output

Notes

Examples