Tivoli Header
Tivoli Storage Manager for UNIX 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 {/fsname}/* /destfs/ -subdir=yes
You must be a root user to restore an entire backup set from the
server, otherwise only files you own are restored.A backup set can also be restored from a tape device on the AIX, AIX
5L, Solaris, and HP 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 UNIX clients.
Syntax
>>-REStore BACKUPSET--+---------+--+- backupsetname-+----------->
'-options-' '- filename------'
>--+- sourcefilespec---+--+----------------------+-------------><
'- "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, 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.
- 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
"/home/budget/backupsetfile.name" -loc=file
- Task
- Restore a backup set from the /dev/rmt0 device.
Command: dsmc restore backupset "/dev/rmt0"
-loc=tape
- Task
- Restore a single file named budget.dev from the
/dev/rmt0 device, to the original source path.
Command: dsmc restore backupset /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 tape(s) on the
/dev/rmt0 device, to the original source path.
Command: dsmc restore backupset /dev/rmt0
"/home/budget/*.txt" -loc=tape
- Task
- Restore the backup set bset01.001 from the
server.
Command: dsmc restore backupset bset01.001
-loc=server
- Task
- Restore the backup set contained in local file
"/home/jones/bset01.file".
Command: dsmc restore backupset
"/home/jones/bset01.file" -loc=file
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]