Tivoli Header

Tivoli Storage Manager for Windows Backup-Archive Clients Installation and User's Guide

Restore Backupset

The restore backupset command restores a backup set from the server, a local file, or a local tape device.

If you are restoring a file space from a backup set to a system that did not perform the original backup, you may need to:

dsmc restore backupset backupsetname {\\machinename\c$}\* c:\destdir
-subdir=yes

You can restore one or all system objects from a backup set using the systemobjectname parameter. On the GUI you can only restore the entire backup set, which may contain system objects.

A backup set can also be restored from a tape device on the Windows NT, 2000, XP, Windows.NET clients. See Location for more information.

If you are unable to restore a backup set from portable media, check with your Tivoli Storage Manager administrator to ensure that the portable media was created on a device using a compatible format.

Note:
There is no support in the API for the backup set format. Therefore, backup set data that was backed up via the API cannot be restored or used.

Attention: If the object you want to restore is part of a backup set generated on a node, and the node name is changed on the server, any backup set objects that were generated prior to the name change will not match the new node name. Ensure that the node name is the same as the node for which the backup set was generated.

Restoring Backup Sets in a SAN Environment

You can restore backup sets in a storage area network (SAN) in the following ways:

Supported Clients

This command is valid for all Windows clients.

Syntax

>>-REStore BACKUPSET--+---------+--+- backupsetname-+----------->
                      '-options-'  '- filename------'
 
>--+- sourcefilespec----------------+--------------------------->
   +- {filespacename}sourcefilespec-+
   '-SYSTEMObject-------------------'
 
>--+----------------------+------------------------------------><
   '- destinationfilespec-'
 
 

Parameters

options
You can use these command line options with the restore backupset command: location, ifnewer, preservepath. See Chapter 10, Using Options with Commands for information about these command line options.

You can use these common options with the restore backupset command: quiet, replace, subdir. See Chapter 9, Setting Processing Options for information about these common options.

backupsetname
Specifies the name of the backup set on the server from which to perform a restore operation. You cannot use wildcard characters to specify the backup set name. Tivoli Storage Manager restores the backup set from the server via LAN.

filename
Specifies the name of a local file or device from which to perform a restore operation.

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

{filespacename}
Specifies the file space name that contains the files you want to restore.

SYSTEMObject
Specifies that you want to restore all Windows 2000, XP, Windows.NET system objects from the backup set.

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. Windows 2000, XP, Windows.NET system objects can only be restored to the original source path. If you are restoring more than one file, you must end the specification with a directory delimiter (\), otherwise, Tivoli Storage Manager assumes the last name is a file name and reports an error. If you are restoring a single file, you can optionally end the specification with a file name if you want to give the restored file a new name.

Examples

Task
Restore a backup set called mybackupsetname from the server.

Command: dsmc restore backupset mybackupsetname -loc=server

Task
Restore the backup set contained in the backupsetfile.name file in the budget directory.

Command: restore backupset c:\budget\backupsetfile.name -loc=file

Task
Restore a backup set from the \\.\tape0 device.

Command: dsmc restore backupset \\.\tape0 -loc=tape

Task
Restore the system objects contained in backup set backupsetfile.name file in the recovery directory.

Command: dsmc restore backupset c:\recovery\backupsetfile.name systemobject


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]