Tivoli Header

Administrator's Reference

RESTORE VOLUME (Restore Primary Volume Data from a Copy Pool)

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:

  1. You can only restore volumes that belong to a storage pool with DATAFORMAT=NATIVE.

  2. Before you restore a random-access volume, issue the VARY command to vary the volume offline.

  3. 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: 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:

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 246. 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 ]