Veritas NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
- acsd
- add_media_server_on_clients
- backupdbtrace
- backuptrace
- bmrc
- bmrconfig
- bmrepadm
- bmrprep
- bmrs
- bmrsrtadm
- bp
- bparchive
- bpbackup
- bpbackupdb
- bpcatarc
- bpcatlist
- bpcatres
- bpcatrm
- bpcd
- bpchangeprimary
- bpclient
- bpclimagelist
- bpclntcmd
- bpclusterutil
- bpcompatd
- bpconfig
- bpdbjobs
- bpdbm
- bpdgclone
- bpdown
- bpduplicate
- bperror
- bpexpdate
- bpfis
- bpflist
- bpgetconfig
- bpgetdebuglog
- bpimage
- bpimagelist
- bpimmedia
- bpimport
- bpinst
- bpkeyfile
- bpkeyutil
- bplabel
- bplist
- bpmedia
- bpmedialist
- bpminlicense
- bpnbat
- bpnbaz
- bppficorr
- bpplcatdrinfo
- bpplclients
- bppldelete
- bpplinclude
- bpplinfo
- bppllist
- bpplsched
- bpplschedrep
- bpplschedwin
- bppolicynew
- bpps
- bprd
- bprecover
- bprestore
- bpretlevel
- bpschedule
- bpschedulerep
- bpsetconfig
- bpstsinfo
- bpstuadd
- bpstudel
- bpstulist
- bpsturep
- bptestbpcd
- bptestnetconn
- bptpcinfo
- bpup
- bpverify
- cat_convert
- cat_export
- cat_import
- configureCerts
- configureCertsForPlugins
- configureMQ
- configurePorts
- configureWebServerCerts
- create_nbdb
- csconfig cldinstance
- csconfig cldprovider
- csconfig meter
- csconfig throttle
- csconfig reinitialize
- duplicatetrace
- importtrace
- jbpSA
- jnbSA
- ltid
- manageClientCerts
- mklogdir
- nbauditreport
- nbcatsync
- NBCC
- NBCCR
- nbcertcmd
- nbcertupdater
- nbcldutil
- nbcloudrestore
- nbcomponentupdate
- nbcplogs
- nbcredkeyutil
- nbdb_admin
- nbdb_backup
- nbdb_move
- nbdb_ping
- nbdb_restore
- nbdb_unload
- nbdb2adutl
- nbdbms_start_server
- nbdbms_start_stop
- nbdc
- nbdecommission
- nbdelete
- nbdeployutil
- nbdevconfig
- nbdevquery
- nbdiscover
- nbdna
- nbemm
- nbemmcmd
- nbfindfile
- nbfirescan
- nbftadm
- nbftconfig
- nbgetconfig
- nbhba
- nbholdutil
- nbhostidentity
- nbhostmgmt
- nbhypervtool
- nbidpcmd
- nbimageshare
- nbinstallcmd
- nbjm
- nbkmiputil
- nbkmscmd
- nbkmsutil
- nboraadm
- nborair
- nbpem
- nbpemreq
- nbmlb
- nbperfchk
- nbplupgrade
- nbrb
- nbrbutil
- nbregopsc
- nbreplicate
- nbrepo
- nbrestorevm
- nbseccmd
- nbsetconfig
- nbsnapimport
- nbsnapreplicate
- nbsqladm
- nbstl
- nbstlutil
- nbstop
- nbsu
- nbsvrgrp
- resilient_clients
- restoretrace
- stopltid
- tldd
- tldcd
- tpautoconf
- tpclean
- tpconfig
- tpext
- tpreq
- tpunmount
- verifytrace
- vltadm
- vltcontainers
- vlteject
- vltinject
- vltoffsitemedia
- vltopmenu
- vltrun
- vmadd
- vmchange
- vmcheckxxx
- vmd
- vmdelete
- vmoprcmd
- vmphyinv
- vmpool
- vmquery
- vmrule
- vmupdate
- vnetd
- vssat
- vwcp_manage
- vxlogcfg
- vxlogmgr
- vxlogview
- W2KOption
- 索引
名称
tpreq — 请求用于装入的磁带卷并为驱动器分配文件名
大纲
-m media_id [-a accessmode] [-d density] [-p poolname] [-priority number] [-f] filename
在 UNIX 系统上，此命令的目录路径为 /usr/openv/volmgr/bin/
在 Windows 系统上，此命令的目录路径为 install_path\Volmgr\bin\
描述
该命令为可移动介质设备上的磁带卷启动装入请求。通过该命令指定的信息可用来标识指定的文件，并在介质管理器中将该文件注册为装入请求的逻辑标识符。它还可用来管理对卷的访问。
如果介质位于机械手驱动器中，介质管理器会自动装入该介质。否则，“设备监视器”窗口中会出现一个操作员装入请求。如果要求操作员干预，则在请求装入机械手驱动器时，tpreq 不会正常结束。这些请求也出现在设备监视器窗口中。
当操作完成时，请使用 tpunmount 卸载卷，并从文件的创建目录中删除具有该文件名的文件。
在 UNIX 系统上，tpreq 会在介质成功置于预先选定的驱动器中之后立即调用脚本 drive_mount_notify。此时，该脚本允许用户进行特殊处理。然后，将控制权归还 tpreq 以继续进行处理。只能使用 tpreq 命令对位于机械手中的驱动器调用该脚本；该脚本对于独立驱动器无效。此脚本位于 /usr/openv/volmgr/bin/goodies 目录中。要使用该脚本，请激活它并将其复制到 /usr/openv/volmgr/bin 目录中，用法信息记录在脚本内。
必须有管理员权限才能运行此命令。
选项
- -m media_id
指定要装入的卷的介质 ID。可以用大写或小写字母输入 ID；介质管理器将其转换为大写。
- -a accessmode
指定卷的访问模式。有效的访问模式是 w 和 r。如果访问模式是 w（写），装入的介质必须为可写。默认值是 r（读），表示介质可能有写保护。
- -d density
指定驱动器的密度。此选项确定将磁带卷装入在何种类型的驱动器上。默认密度是 dlt。
对于 NetBackup Enterprise Server，有效密度如下：
4mm（用于 4 毫米盒式磁带）、8mm（用于 8 毫米盒式磁带）、8mm2（用于 8 毫米盒式磁带 2）、8mm3（用于 8 毫米盒式磁带 3）、dlt（用于 DLT 盒式磁带）、dlt2（用于 DLT 盒式磁带 2）、dlt3（用于 DLT 盒式磁带 3）、dtf（用于 DTF 盒式磁带）、hcart（用于 1/2 英寸盒式磁带）、hcart2（用于 1/2 英寸盒式磁带 2）、hcart3（用于 1/2 英寸盒式磁带 3）、qscsi（用于 1/4 英寸盒式磁带）。
以下说明仅适用于 NetBackup Enterprise Server：
1/2 英寸盒式磁带密度（hcart、hcart2 和 hcart3）可用于区别任何受支持的 1/2 英寸驱动器类型。不过，只能将磁带请求分配给具有关联介质类型的驱动器。例如，它将密度为 hcart2（用于指定介质类型为 HCART2 的介质 ID）的磁带请求分配给 hcart2 驱动器。同样，它将密度为 hcart（用于指定介质类型为 HCART 的介质 ID）的磁带请求分配给 hcart 驱动器。同样的规则也适用于 DLT 密度（dlt、dlt2 和 dlt3）和 8MM 密度（8mm、8mm2 和 8mm3）。
对于 NetBackup 服务器，有效密度如下：
4mm（用于 4 毫米盒式磁带）、8mm（用于 8 毫米盒式磁带）、dlt（用于 DLT 盒式磁带）、hcart（用于 1/2 英寸盒式磁带）、qscsi（用于 1/4 英寸盒式磁带）。
必须在满足密度要求的驱动器类型上执行装入请求。
- -p poolname
指定卷所在的卷池。poolname 区分大小写。默认值为“无”。
- -priority number
为作业指定一个新优先级来覆盖默认作业优先级。
- -f filename
指定与卷关联的文件。文件名表示指向装有该卷的驱动器的符号链接。
文件名可以是单个名称，也可以是完整的路径。如果只指定文件名，则在当前的工作目录中创建该文件。如果指定路径，则在路径所指定的目录中创建该文件。filename 不能是现有文件。
如果 tpreq 命令成功，则介质管理器以您指定的名称创建文件。此文件包含装入介质的磁带设备的名称。不要删除此文件。使用 tpunmount 命令删除它。
在 filename 之前指定 -f 是可选的。
示例
在当前工作目录中创建名为 tape1 的文件，该目录将该文件链接到介质 ID 为 JLR01 的卷所在的驱动器。磁带文件的访问模式将设置为“写入”，并分配 1/4 英寸的盒式磁带驱动器。
# tpreq -f tape1 -m jlr01 -a w -d qscsi
另请参见
请参见tpunmount(1)。