Tivoli Header
Tivoli Storage Manager for Windows Backup-Archive Clients Installation and User's Guide
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:
- Specify a destination
- Use the syntax below to specify the source file
- Do both of the above
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.
You can restore backup sets in a storage area network (SAN) in the
following ways:
- If the backup set is on a SAN-attached storage device, specify the device
using the filename parameter and use the
location=tape option. Tivoli Storage Manager
restores the backup set directly from the SAN-attached storage device, gaining
high-speed restore performance.
- Note:
- You must ensure that the correct tape is mounted in the SAN-attached tape
drive prior to issuing the restore command. The
backup-archive client will not initiate a SCSI autochanger to mount the tape
automatically.
- If the backup set is not on local media or a SAN-attached storage device,
you can specify the backup set using the backupsetname
parameter. Use the location=server option to
restore the backup set directly from the server via the LAN.
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 ]