Using the restore command

Description

Use the restore command if you want to recover data that was backed up by the filer's dump command. After you recover the data, the files contain the same data as they did when you ran the dump command. You can use the restore command at any time.

Restrictions

This section describes the restrictions of the restore command.

The i function key of the Solaris ufsrestore command

The restore command is similar to the Solaris ufsrestore command, except that the restore command doesn't support the i function key of ufsrestore. This function key enables you to specify interactively individual files and directories to be restored from a tape. However, you can restore individual files and directories using the x argument of the filer restore command.

Incremental-only restores

If you want to restore all files in a backup using the restore r command, you must begin the restoration from a level 0 backup. You can, however, restore a specified file or directory from an incremental backup tape when you use the restore x command.

Parallel restores

The filer supports up to three simultaneous restore commands.

Prerequisites

This section describes the requirements that you must meet for the restore command to be completed successfully.

The space required for the restore command to be completed is about 100 MB more than the amount of data to be restored. The command aborts if it runs out of space. If you want to perform a full restore, the additional space should be in the directory that is the root of the backup. If you want to restore only some data in a backup, the additional space should be in the /etc/tmp directory of the volume where data is to be restored.
The restore command does not restore qtree information. Before you restore a volume containing qtrees, create the qtrees. Refer to "Performing a full restore of a volume containing qtrees" for the procedure for restoring qtrees.
Before you perform a full restore, make sure that the directory into which you restore data does not contain the restore_symboltable file. The restore command uses the restore_symboltable file for incremental restores and for resuming an interrupted restore. If the restore_symboltable file exists in the directory because of an unsuccessful restore, remove the file before starting the full restore, or the full restore fails.

Where you can enter the restore command

You can enter the restore command through the console or through rsh. Entering the restore command through rsh gives you these benefits:

When the restore command is in progress, you can still use the console to manage the filer.
You can start multiple restore commands through rsh.
It is less likely that someone inadvertently terminates the restore command. If you enter a restore command on the console, it could be terminated by a Ctrl-C entered on a host connected to the filer using telnet.

However, if you enter the restore command on the console, you can read and respond to screen messages displayed by the command. For example, the command might prompt you for another tape to complete the recovery.

Steps

Follow these steps to restore files to the filer.


Step	Action
1	Place the tape containing the first tape file of the backup in the tape drive.
2	Enter the `restore` command as follows: *restore [function_key] [options] [arguments] [subtree]*
3	If prompted, insert the next tape in the backup.
4	Repeat Step 3 until the restore is complete.

Part No. 210-02334
File: recover2.htm
Last updated: 02/24/99 12:17:05