Restore Backupset

The restore backupset command restores a backup set from the Tivoli® Storage Manager server, a local file, or a local tape device. You can restore the entire backup set, or, in some cases, specific files within the backup set.

Supported Clients

This command is valid for all clients.

Syntax


>>-REStore Backupset--+-------------------------------------+--->
                      +-+-----------------+--sourcefilespec-+   
                      | '-{filespacename}-'                 |   
                      '-SYSTEMSTATE-------------------------'   

>--+---------------------+--+---------+-- -BACKUPSETName= ------>
   '-destinationfilespec-'  '-options-'                      

>--+-backupsetname-+--+--------------------------+-------------><
   +-localfilename-+  '- -LOCation= --+-server-+-'   
   '-tapedevice----'                  +-file---+     
                                      '-tape---'

Parameters

{filespacename}

Specifies the file space (enclosed in braces) on the server that contains the files you want to restore. This is the name on the workstation drive from which the files were backed up, or the virtual file space name for a group.

Specify a file space name when you restore a backup set containing a group.

Specify a file space name when the sourcefilespec does not exist on the target computer. This can occur if the drive label name has changed or if you are restoring files that were backed up from another node that had drive labels that are different from yours.

Note: You must specify a mixed or lowercase NTFS or ReFS file space name that is enclosed in quotation marks and braces. For example, {"NTFSDrive"}. Single quotation marks are valid in loop mode. For example: {"NTFSDrive"} and {'NTFSDrive'} are both valid. In batch mode, only single quotation marks are valid. The single quotation marks requirement is a restriction of the operating system.

sourcefilespec

Specifies the source path of a portion of the backup set. The default is to restore the entire backup set.

SYSTEMSTATE

Specifies that you want to restore the entire backup of the system state from the backup set. You cannot restore individual system state components from the backup set. This parameter is valid only for systems that support system state. To restore individual system state components from a backup set, use the restore systemstate command.

destinationfilespec

Specifies the destination path for the restored files. If you do not specify a sourcefilespec, you cannot specify a destinationfilespec. If you do not specify a destination, Tivoli Storage Manager restores the files to the original source path. If you are restoring more than one file, you must end the file specification with a directory delimiter (/), otherwise, Tivoli Storage Manager assumes that the last name is a file name and reports an error. If you are restoring a single file, you can optionally end the destination file specification with a file name if you want to give the restored file a new name. When the sourcefilespec does not exist on the target workstation, you must specify destinationfilespec.

-BACKUPSETName=

Specifies the name of the backup set from which to perform a restore operation. You cannot use wildcard characters to specify the backup set name. The value of backupsetname depends on the location of the backup set, and corresponds to one of the following three choices:

backupsetname: Specifies the name of the backup set on the server from which to perform a restore operation. If location option is specified, you must set -location=server.
localfilename: Specifies the file name of the first backup set volume. You must set -location=file.
tapedevice: Specifies the name of the tape device containing the backup set volume. You must use a Windows-provided device driver, not the device driver that is provided by Tivoli. You must set -location=tape.

-LOCation=

Specifies the location of the backup set. If you do not specify the location parameter, the Tivoli Storage Manager client searches for backup sets on the Tivoli Storage Manager server. If you specify the location parameter, the value must be one of the following three choices:

server: Specifies that the backup set is on the Tivoli Storage Manager server. Server is the default location.
file: Specifies that the backup set is on an available file system.
tape: Specifies that the backup set is on an available tape device.

Table 1. Restore Backupset command: Related options
Option	Where to use
dirsonly	Command line only.
filesonly	Command line only.
ifnewer	Command line only.
preservepath	Command line only.
quiet	Client options file (dsm.opt) or command line.
quiet	Client user options file (dsm.opt) or command line.
replace	Client options file (dsm.opt) or command line.
replace	Client user options file (dsm.opt) or command line.
skipntpermissions	Client options file (dsm.opt) or command line.
subdir	Client options file (dsm.opt) or command line.
subdir	Client user options file (dsm.opt) or command line.

Examples

Task: Restore the entire backup set called monthly_financial_data.87654321 from the server.

dsmc restore backupset -backupsetname=monthly_financial_data.87654321 -loc=server
Task: Restore the entire backup set contained in the file: /home/budget/weekly_budget_data.ost.
dsmc restore backupset -backupsetname="/home/budget/weekly_budget_data.ost" -loc=file
Task: Restore the entire backup set from the /dev/rmt0 device.
dsmc restore backupset "-backupsetname=/dev/rmt0" -loc=tape
Task: Restore a single file named /home/jones/budget.dev from the /dev/rmt0 tape device, to the original source path.

dsmc restore backupset -backupsetname=/dev/rmt0 "/home/jones/budget.dev" -loc=tape
Task: Restore all files in the budget directory that contain a file extension of .txt from the tapes on the /dev/rmt0 device, to the original source path.

dsmc restore backupset "/home/budget/*.txt" -backupsetname=/dev/rmt0 -loc=tape
Task: Restore the entire backup set contained in local file named "/home/jones/bset01.file"
dsmc restore backupset -backupsetname="/home/jones/bset01.file" -loc=file
Task: Restore groups from the backup set mybackupset.12345678 on the Tivoli Storage Manager server to the /home/devel/projectb directory. The groups' virtual file space is accounting.

dsmc restore backupset {/accounting}/* /home/devel/projectb/ -backupsetname=mybackupset.12345678 -loc=server -subdir=yes
Task: Restore groups from the local backup set mybackupset.ost to the /home/devel/projectb/ directory. The groups' virtual file space is accounting.

dsmc restore backupset {/accounting}/* /home/devel/projectb/ -backupsetname=mybackupset.ost -loc=server -subdir=yes
Task: Restore the entire backup set from the \\.\tape0 device.

dsmc restore backupset -backupsetname=\\.\tape0 -loc=tape
Task: Restore groups from the backup set mybackupset.12345678 on the Tivoli Storage Manager server to the c:\newdevel\projectn directory. The groups' virtual file space is accounting.

dsmc restore backupset {accounting}\* c:\newdevel\projectn\ -backupsetname=mybackupset.12345678 -loc=server -subdir=yes
Task: Restore the entire backup set contained in the file: c:\budget\weekly_budget_data.ost.
dsmc restore backupset -backupsetname=c:\budget\weekly_budget_data.ost -loc=file
Task: Restore the \budget\ directory and subdirectories from the backup set contained in the file: c:\budget\weekly_budget_data.ost.
dsmc restore backupset m:\budget\* -backupsetname=c:\budget\weekly_budget_data.ost -loc=file -subdir=yes
Task: Restore the file \budget\salary.xls from the backup set contained in the file: c:\budget\weekly_budget_data.ost.

dsmc restore backupset m:\budget\salary.xls -backupsetname=c:\budget\weekly_budget_data.ost -loc=file -subdir=yes
Task: Restore the system state that is contained in the backup set file: \recovery\backupsetfile.name. Replace all components; do not prompt for each component.

dsmc restore backupset systemstate -BACKUPSetname=c:\recovery\backupsetfile.name -loc=file -replace=all