system smtape restore

Restore a volume from tape devices

Availability: This command is available to cluster administrators at the admin privilege level.

Description

This command performs restore of a backup image created using the command system smtape backup in the specified tape device to a destination volume path. A new unique session ID is assigned for this operation; the status of the session can be monitored using the command system smtape status. It is required that the volume and tape device reside in the same cluster node. The volume must be of type DP (Data Protection) and should be placed in the restricted mode prior to a restore.

Any existing data on the volume will get overwritten upon a restore. The volume will remain as read-only and of type DP after the restore. You can use the command system smtape break to get read/write permissions on the volume. Restore can be done to a non-root DP volume.

Parameters

-vserver <vserver name> - Vserver Name
Use this parameter to specify the Vserver name on which the volume is located. You need not specify this parameter if only one cluster Vserver exists.
-volume <volume name> - Volume Name
Use this parameter to specify the volume name on which the tape content will be restored.
-tape </node_name/tape_device> - Tape Name
Use this parameter to specify the name of the tape device which is used for this SMTape operation. The format of the tape device name is /node_name/tape_device, where node_name is the name of the cluster node owning the tape and tape_device is the name of the tape device.
[-tape-block-size <integer>] - Tape Record Size in KB
Use this parameter to specify the tape record size in KB for backup and restore operations. The tape record size is in multiples of 4KB, ranging from 4KB to 256KB. The default tape record size is 240KB unless it is specified. Use the same record size which was used during the backup. If the tape record size is different from the tape record size that was used at the time of backup then system smtape restore will fail.

Examples

The following example will start the restore to a volume datavol from a tape rst0a. The volume datavol is in a Vserver vserver0. Both vserver0 and rst0a reside on the same node cluster1-01.

cluster1::> system smtape restore -vserver vserver0 -volume datavol
		    -tape /cluster1-01/rst0a -tape-block-size 256

 Session 2 created successfully

The following example will start the restore to a volume datavol from a tape rst0a. The volume datavol is in a Vserver vserver0. Both vserver0 and rst0a reside on the same node cluster1-01. The default tape record size of 240KB was used during backup.

cluster1::> system smtape restore -vserver vserver0 -volume datavol
		    -tape /cluster1-01/rst0a

 Session 5 created successfully