Table of ContentsView in Frames

Environment variables supported for SMTape

Data ONTAP supports a set of environment variables for SMTape. These variables are used to communicate information about a SMTape backup or restore operation between an NDMP-enabled backup application and a storage system.

The following table lists the environment variables supported by Data ONTAP for SMTape backup and recovery, their valid values, default value, and description:

Environment variable Valid values Default value Description
DUMP_DATE return_value none

At the end of an SMTape backup, DUMP_DATE contains a string identifier that identifies the reference Snapshot copy for the next incremental backup. The resulting value of DUMP_DATE is used as the BASE_DATE value for subsequent incremental backups.

BASE_DATE DUMP_DATE none

BASE_DATE specifies the start date for incremental backups. BASE_DATE is a string representation of the reference Snapshot identifiers. Using the BASE_DATE string, SMTape locates the reference Snapshot copy. Subsequent to the initial backup, the value of the DUMP_DATE variable from the previous incremental backup is assigned to the BASE_DATE variable.

FILESYSTEM string none Specifies the path name of the root of the data that is being backed up. For example, /vol/vol0/etc.
SMTAPE_BACKUP_SET_ID string none Specifies the backup set ID for the baseline backup and subsequent incremental backups. Backup set ID is a 128-bit unique ID that identifies the sequence of incremental backups with respect to baseline backup.
SMTAPE_SNAPSHOT_NAME Any valid Snapshot copy that is available in the volume Invalid

When the SMTAPE_SNAPSHOT_NAME variable is set to a Snapshot copy, that Snapshot copy and its older Snapshot copies are backed up to tape. This variable is available only in the SMTape backup context.

SMTAPE_DELETE_SNAPSHOT Y or N N When the SMTAPE_DELETE_SNAPSHOT variable is set to Y, SMTape deletes the auto-Snapshot copy after the backup operation is complete.

If you specify a Snapshot copy name for the backup, this Snapshot copy is not deleted, but the softlock on this Snapshot copy is removed.

Note: When the variable is set to N, SMTape does not delete the auto-Snapshot copy and leaves the softlock on this Snapshot copy.
SMTAPE_BREAK_MIRROR Y or N N When the SMTAPE_BREAK_MIRROR variable is set to Y, it ensures that the SnapMirror relationship established by the restore operation is broken after the operation is complete. This variable is available only in the SMTape restore context.
Note: After a successful restore, the restored volume is in the restricted state and does not become writable unless the SMTAPE_BREAK_MIRROR variable is set to Y.