Skip to main content

system smtape backup

Contributors
Suggest changes
PDFs

Backup a volume to tape devices

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

Description

This command performs a baseline backup of a specified volume path to a tape device. You can use the command system hardware tape drive show to view the list of tape devices in the cluster. You must specify a Snapshot copy name to perform an SMTape backup operation. The Snapshot copy name specified is used as the base Snapshot copy. A new unique session ID is assigned for this SMTape operation and the status of the session can be monitored using the command system smtape status . This session ID can be subsequently used to perform other operations such as to find the SMTape status, abort an SMTape operation, and continue an SMTape operation.

The volume and tape device must reside on the same node in the cluster. You must retain the base Snapshot copy created during this backup operation in order to use this Snapshot copy to re-establish a SnapMirror relationship upon a restore.

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 name of the volume that needs to be backed up to tape.

-backup-snapshot <snapshot name> - Snapshot Name

Use this parameter to specify the name of the Snapshot copy while performing an SMTape backup operation.

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

Examples

The following example will start the backup of a volume datavol in a Vserver vserver0 to a tape rst0a . Both the volume and tape reside on the same node cluster1-01 . The Snapshot copy to be backed up is datavol_snapshot and the tape record size has the value of 256KB.

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

Session 21 created successfully

The following example will start the backup of a volume datavol in a Vserver vserver0 to a tape rst0a . The volume datavol is in a Vserver vserver0 . Both the volume and tape reside on the same node cluster1-01 . The Snapshot copy to be backed up is datavol_snapshot and the tape record size has the default value of 240KB.

cluster1::> system smtape backup -vserver vserver0 -volume datavol
    -backup-snapshot datavol_snapshot -tape /cluster1-01/nrst0l
Session 22 created successfully