Tivoli Header

Tivoli Storage Manager for NetWare Backup-Archive Client Installation and User's Guide

Restore Backupset

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

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:

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.

NDS restores are not supported. If Tivoli Storage Manager creates a backup set containing only the NDS, and you attempt to restore it with the restore backupset command, an error message appears. If a backup set contains both a file specification and the NDS, no error message is produced, however only the file specification is restored. To restore the NDS, you must use the use the restore command from the command line.

The restore backupset command restores a backup set from the server or a local file only. For example, the following command restores a backup set from the server: tsm> res backupset bkset.101394 -su=y -rep=all, and the following command restores the backup set from file on a local NetWare server: tsm> res backupset sys:\34477804.ost -su=y -rep=all -loc=file.

If you copy a backup set from the Tivoli Storage Manager server to the NetWare server in order to restore it, you must specify -loc=file. The backup set can reside on NetWare volumes, CDROM, DVD, or a similar device that can be mounted as a volume with files that can be accessed as file specifications.

You cannot restore a subset of files from a local backup set. The following error message appears: "Invalid source file specification."

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.

You can restore backup sets in a storage area network (SAN) by specifying the location=server option to restore the backup set directly from the server via the LAN.

Syntax

>>-REStore BACKUPSET--+---------+--+- backupsetname-+----------->
                      '-options-'  '- filename------'
 
>--+-------------------+--+----------------------+-------------><
   '- --sourcefilespec-'  '- 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, Using 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 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.

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 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: dsmc restore backupset sys:u/budget/backupsetfile.name -location=file


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