Veritas NetBackup™ Commands Reference Guide
- Introduction
- Appendix A. NetBackup Commands
Name
tpunmount — remove a tape volume from a drive and a tape file from the directory
SYNOPSIS
[-f] filename [-force]
On UNIX systems, the directory path to this command is /usr/openv/volmgr/bin/
On Windows systems, the directory path to this command is <install_path>\Volmgr\bin\
DESCRIPTION
tpunmount removes a tape file from the directory and physically removes the tape volume from the drive (if the media was mounted).
On UNIX systems, when tpunmount is executed for drives, a call is made to execute the drive_unmount_notify script. This script allows user special-handling to occur. Control is then returned to tpunmount to resume processing. The script resides in the /usr/openv/volmgr/bin/goodies
directory. To use this script, activate it and copy it into the /usr/openv/volmgr/bin
directory. The script is called from the tpreq command for only the drives that are in robots. The script is not valid for standalone drives or NDMP drives.
Standalone drives are not unloaded when the DO_NOT_EJECT_STANDALONE option is specified (and the -force option is not specified). This option is now stored in EMM.
The tape file and the device must be closed before you can use tpunmount.
You must have administrator privileges to run this command.
OPTIONS
- -f filename
Specifies the file that is associated with the media. You must specify a file name. The specification of -f before filename is optional.
- -force
Ejects the volume from a standalone drive, even if DO_NOT_EJECT_STANDALONE is specified in the EMM database.
EXAMPLE
The following command unmounts the tape volume that is associated with file tape1 and removes the file from the current directory:
# tpunmount tape1
SEE ALSO
See tpreq.