Tivoli Header
Administrator's Reference
Use this command to restore all files on damaged volumes in a primary
storage pool that was backed up to a copy storage pool. Tivoli Storage
Manager does not restore cached copies of files and removes those cached files
from the database during restore processing.
Notes:
- Before you restore a random-access volume, issue the VARY command to vary
the volume offline.
- To prevent copy storage pools files from being moved or deleted
by other processes, do not issue the following commands for copy storage pool
volumes during a restore:
- MOVE DATA
- DELETE VOLUME (DISCARDDATA=YES)
- AUDIT VOLUME (FIX=YES)
To prevent reclamation processing of copy storage pools, issue the UPDATE
STGPOOL command with the RECLAIM parameter set to 100.
This command changes the access mode of the specified volumes to
DESTROYED. When all files on a volume are restored to other locations,
the destroyed volume is empty and is deleted from the database.
The restoration may be incomplete for one or more of the following
reasons:
- Files were either never backed up or the backup copies are marked as
damaged. Use the QUERY CONTENT command to get more information on the
remaining files on the volume.
- A copy storage pool was specified on the RESTORE command, but files were
backed up to a different copy storage pool. Use the PREVIEW parameter
when you issue the RESTORE command again to determine if this is the
problem.
- Volumes in the copy storage pool needed to perform the restore operation
are offsite or unavailable. Check the activity log for messages that
occurred during restore processing.
- Backup file copies in copy storage pools were moved or deleted by other
processes during a restore. See note (MORD).
Privilege Class
To issue this command you must have system privilege, unrestricted storage
privilege, or restricted storage privilege for the primary storage
pool. If you have restricted privilege and want to restore files to a
new primary storage pool, you must also have authority for the new storage
pool.
Syntax
.-,-----------.
V |
>>-RESTORE Volume----volume_name-+------------------------------>
>--+--------------------------------+--------------------------->
'-COPYstgpool--=--copy_pool_name-'
>--+--------------------------------------+--------------------->
'-NEWstgpool--=--new_primary_pool_name-'
.-MAXPRocess--=--1------. .-Preview--=--No------.
>--+-----------------------+--+---------------------+----------->
'-MAXPRocess--=--number-' '-Preview--=--+-No--+-'
'-Yes-'
.-Wait--=--No------.
>--+------------------+----------------------------------------><
'-Wait--=--+-No--+-'
'-Yes-'
Parameters
- volume_name (Required)
- Specifies the name of the primary storage pool volume to be
restored. To specify a list of volumes that belong to the same primary
storage pool, separate the names with commas and no intervening spaces.
- COPYstgpool
- Specifies the name of the copy storage pool from which the files are to be
restored. This parameter is optional. If you do not specify this
parameter, files are restored from any copy pool in which copies can be
located.
- NEWstgpool
- Specifies the name of the new storage pool to which to restore the
files. This parameter is optional. If you do not specify this
parameter, files are restored to the original primary storage pool.
- MAXPRocess
- Specifies the maximum number of parallel processes to use for restoring
files. Using parallel processes may improve throughput. This
parameter is optional. You can specify a value from 1 to 999.
The default is 1.
When determining this value, consider the number of mount points (logical
drives) and physical drives that can be dedicated to this operation. To
access a sequential access volume, Tivoli Storage Manager uses a mount point,
and, if the device type is not FILE, a physical drive. The number of
available mount points and drives depends on other Tivoli Storage Manager and
system activity and on the mount limits of the device classes for the
sequential access storage pools that are involved in the restore.
Each process needs a mount point for copy storage pool volumes. If
the device type is not FILE, each process also needs a drive. If you
are restoring a sequential storage pool, each process needs an additional
mount point for primary storage pool volumes and, if the device type is not
FILE, an additional drive. For example, suppose you specify a maximum
of three processes to back up a primary sequential storage pool to a copy
storage pool of the same device class. Each process requires two mount
points and two drives. To run all three processes, the device class
must have a mount limit of at least 6, and at least 6 mount points and 6
drives must be available.
To preview a backup, only one process is used and no mount points or drives
are needed.
- Preview
- Specifies if you want to preview but not perform the restore. You
can use this option to identify the offsite volumes required to restore a
storage pool. This parameter is optional. The default is
NO. Possible values are:
- No
- Specifies that you want to perform the restore operation.
- Yes
- Specifies that you want to preview the restore operation but restore the
data.
- Note:
- If you preview a restore to see a list of offsite copy pool volumes to be
mounted, you should you change the access mode of the identified volumes to
UNAVAILABLE. This prevents reclamation and MOVE DATA processing for
these volumes until they are transported to the onsite location for use in
restore processing.
The preview displays the following:
- The number of files and bytes to be restored, if the access mode of the
copy storage pool volumes is READWRITE or READONLY when the restoration is
performed.
- A list of copy storage pool volumes containing files to be
restored. These volumes must be mounted if you perform the
restore.
- A list of volumes containing files that cannot be restored.
- Wait
- Specifies whether to wait for the server to complete processing this
command in the foreground. This parameter is optional. This
default is NO. Possible values are:
- No
- Specifies that the server processes this command in the background.
You can continue with other tasks while the command is being
processed. Messages created from the background process are displayed
either in the activity log or the server console, depending on where messages
are logged.
To cancel a background process, use the CANCEL PROCESS command. If
you cancel this process, some files may have already been backed up prior to
the cancellation.
- Yes
- Specifies that the server processes this command in the foreground.
The operation must complete before you can continue with other tasks.
The server then displays the output messages to the administrative client when
the command completes.
- Note:
- You cannot specify WAIT=YES from the server console.
Examples
Task
Restore files stored on volume PVOL2 in primary storage pool
PRIMARY_POOL.
- Command:
- restore volume pvol2
Related Commands
Table 242. Commands Related to RESTORE VOLUME
Command
| Description
|
BACKUP STGPOOL
| Backs up a primary storage pool to a copy storage pool.
|
CANCEL PROCESS
| Cancels a background server process.
|
QUERY PROCESS
| Displays information about background processes.
|
RESTORE STGPOOL
| Restores files to a primary storage pool from copy storage pools.
|
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]