To use the bak restoreftfamily command to restore individual filesets, specify the name of a file that includes a single entry for each fileset to be restored. The command restores each fileset to the site specified with the fileset's entry in the named file. A file to be used with the command must include entries of the following form:
machine aggregate fileset [comments…]
An entry for a fileset must occupy a single line of the file, and each entry must provide the following information:
machine
Specifies the File Server machine to which the fileset is to be restored. Identify the machine by its DCE path name, its host name, or its IP address.
aggregate
Specifies the aggregate to which the fileset is to be restored. Identify the aggregate by its device name or by its aggregate name.
fileset
Specifies the fileset to be restored. Specify the name of the read/write version of the fileset. (Note that you can specify the name of the backup version of the
fileset if that version was dumped to tape.)
Any comments in the form of additional text are always optional; the command treats all remaining text as a comment and ignores it. Do not use wildcards (.*, for example) in an entry. Note that if a fileset currently exists at a site other than the site you specify, you must remove the existing version of the fileset before issuing the command.
When issued with the -noaction option, the bak restoreftfamily command generates output that, with slight modification, is suitable for use as input to the command's -file option. You can use the -noaction option with the command's -family option to write a list of filesets and their sites to a file. You can then prune the file for restoring only certain filesets from a fileset family or for restoring the filesets to new sites. Note again that the -family option provides information only for filesets that have entries in the FLDB.
To restore individual filesets, do the following:
1. Create a file that contains an entry for each fileset you want to restore. Each entry must name the machine to which the fileset is to be restored, the aggregate to which the fileset is to be restored, and the fileset to be restored. Use a single line in the file for each entry, and use a single entry for each fileset (the command ignores subsequent entries for the same fileset). You can use a text editor to create the file manually, or you can use the -noaction option to write a list of filesets and their sites to a file, which you can then modify for use with the command.
2. If it is not already running, start the Tape Coordinator for the tape drive that you want to use with the operation. See Starting a Tape Coordinator for information on using the butc command to start a Tape Coordinator.)
3. Verify that you are included in the appropriate administrative lists. If necessary, issue the bos lsadmin command to check.
4. At this point, you can issue the bak command at the system prompt to enter interactive mode. This is optional. (See Using the Interactive Interface for the advantages of interactive mode.) The command in the following step assumes that regular command mode is used, not interactive mode.
5. Issue the bak restoreftfamily command with the -file option, as follows
$ bak restoreftfamily -file filename [-tcid tc_number] [-noaction]
The -file filename option provides the full path name of a file that contains an entry for each fileset to be restored.
The -noaction option directs the command to display the list of filesets that would be restored and the tapes necessary to restore them without performing the actual operation.