Veritas NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
名称
bptpcinfo — 发现 SAN 设备并创建 3pc.conf
文件
大纲
[-a] [-c] [-h] [-u] [-r] [-v] [-d disk_device_directory] [-t tape_device_directory] [-p physical_device] [-o output_file_name] [-o -]
此命令的目录路径为 /usr/openv/netbackup/bin/
描述
此命令只能在 UNIX 系统中运行。
bptpcinfo 命令用于发现光纤通道和 SCSI 连接上的所有磁盘和磁带设备。并提供有关每个设备的信息(每个设备占一行)。默认情况下,此命令将信息写入以下文件:
/usr/openv/volmgr/database/3pc.conf
注意:
对于脱离主机备份(第三方复制设备或 NetBackup 介质服务器备份方法),/usr/openv/volmgr/database
中必须存在 3pc.conf
文件。
在使用“第三方复制设备”或“NetBackup 介质服务器”方法开始执行备份时,如果 3pc.conf
文件尚不存在,NetBackup 将自动运行此命令以创建该文件。此文件是完整的,如果满足以下任何情况,您就不需要重新运行此命令:
备份使用的是“NetBackup 介质服务器”备份方法。
您使用的是“第三方复制设备”备份方法,而且所有必需的设备(如磁盘、磁带和第三方复制设备)都支持标识描述符。
如果其中任何一个设备不支持标识描述符,请手动运行 bptpcinfo 命令创建 3pc.conf
文件。然后按照《NetBackup Snapshot Client 管理指南》的“SAN 配置”一章中的说明编辑该文件。
选项
- -a
发现光纤通道和 SCSI 连接上的所有磁盘和磁带设备。它在
3pc.conf
文件(或使用 -o 选项指定的备用输出文件)中添加条目。-a 选项列出/dev/rdsk
和/dev/rmt
中的所有设备。- -c
在已经存在的
3pc.conf
文件(位于/usr/openv/volmgr/database
)中检查语法错误。如果3pc.conf
文件不存在,则显示一条指出“无法打开文件”的消息。在这种情况下,可使用其他命令选项来创建该文件。请注意,如果指定了 -c,将忽略所有其他选项。-c 选项检查如下的语法错误:条目之间缺少空格、缺少关键字(如全球名称中缺少 w=)或者全球名称的长度不是 16 位。任何此类错误都会导致备份失败。
- -h
显示 bptpcinfo 的用法说明。
- -u
发现光纤通道和 SCSI 连接上的所有磁盘设备和磁带设备。它还会在
3pc.conf
文件(或使用 -o 选项指定的备用输出文件)中为找到的新设备添加条目。如果3pc.conf
文件不存在,-u 选项将失败(请改用 -a)。注意:
要删除过时的条目,请使用 -r 而不是 -u。(-u 选项和 -r 选项不能一起使用)。
- -r
删除
3pc.conf
文件(或使用 -o 选项指定的备用输出文件)中所有过时的条目。过时的条目是指不再与光纤通道或 SCSI 连接上的任何设备对应的条目。注意:
-r 选项不会在
3pc.conf
文件中为新设备或重新配置的设备添加条目。要添加条目,请使用 -u 选项。(-u 选项和 -r 选项不能一起使用)。- -v
指定详细模式,使 bptpcinfo 列出其发现进度的相关信息。该信息显示在屏幕上,而不是写入
3pc.conf
文件。可以选择 -v 选项以跟踪设备发现中的问题。
- -d disk_device_directory
发现指定目录(在 Solaris 或 Hewlett Packard Enterprise 上通常为
/dev/rdsk
,在 AIX 上通常为/dev
)中的所有磁盘,并在3pc.conf
文件中创建新条目。或者,它通过重写当前的所有条目,在使用 -o 选项指定的备用输出文件中创建新条目。要避免改写
3pc.conf
文件,请将 -d 选项和 -u 选项结合使用。如果结合使用 -d 和 -u,则会将新磁盘条目添加到现有条目中。- -t tape_device _directory
发现指定目录(在 Solaris 或 Hewlett Packard Enterprise 上通常为
/dev/rmt
,在 AIX 上通常为/dev
)中的所有磁带驱动器,并在3pc.conf
文件中创建新条目。或者,它通过重写当前的所有条目,在使用 -o 选项指定的备用输出文件中创建新条目。要避免改写
3pc.conf
文件,请将 -t 选项和 -u 选项结合使用。如果结合使用 -t 和 -u,则会将新磁带条目添加到现有条目中。- -p physical_device
如果找到指定的设备,则为
3pc.conf
文件中的物理设备创建条目。或者,它通过重写当前的所有条目,在使用 -o 选项指定的备用输出文件中创建新条目。要避免改写
3pc.conf
文件,请将 -p 选项和 -u 选项结合使用。如果结合使用 -p 和 -u,则会将新条目添加到现有条目中。- -o output_file_name
-o 为 bptpcinfo 命令输出指定备用(通常为临时性的)路径。如果没有指定此选项,则默认路径为
/usr/openv/volmgr/database/3pc.conf
。- -o -
将输出发送到屏幕。注意第二个连字符前面的空格。
示例
示例 1 - 发现 SAN 上的所有源设备和目标设备,然后在 /usr/openv/volmgr/database
中创建所需的 3pc.conf
文件。
# bptpcinfo -a
示例 2 - 发现 SAN 上的所有源设备和目标设备,然后将输出发送到屏幕。
# bptpcinfo -a -o -
输出示例:
devid [p=devpath] [s=sn] [n=npid] [l=lun] [w=wwpn] [i=iddesc] 1 p=/dev/rdsk/c1t11d3s2 s=SEAGATE:ST19171N:LAE82305 l=3 2 p=/dev/rdsk/c1t13d4s2 s=SEAGATE:ST19101W:NH022724 l=4 3 p=/dev/rdsk/c1t20d0s2 s=HITACHI:OPEN-9:60159003900 l=0 4 p=/dev/rdsk/c1t20d1s2 s=HITACHI:OPEN-9:60159000000 l=1 5 p=/dev/rdsk/c1t20d2s2 s=HITACHI:OPEN-9:60159000100 l=2 6 p=/dev/rdsk/c1t20d3s2 s=HITACHI:OPEN-9-CM:60159001C00 l=3 7 p=/dev/rdsk/c1t20d4s2 s=HITACHI:OPEN-9:60159002B00 l=4 8 p=/dev/rdsk/c1t20d5s2 s=HITACHI:OPEN-9:60159002C00 l=5
示例 3 - 发现 /dev/rmt
目录(在 AIX 上为 /dev
目录)中的设备,并将输出发送到屏幕:
在 Solaris 或 Hewlett Packard Enterprise 上:
# bptpcinfo -t /dev/rmt -o -
输出示例:
devid [p=devpath] [s=sn] [n=npid] [l=lun] [w=wwpn] [i=iddesc] 0 p=/dev/rmt/0cbn s=QUANTUM:DLT8000:CX949P0164 l=1 i=10200E09E6000000868 1 p=/dev/rmt/1cbn s=QUANTUM:DLT8000:CX949P1208 l=2 i=10200E09E6000001381 2 p=/dev/rmt/4cbn s=QUANTUM:DLT8000:CX940P2790 l=2 i=1031000005013E000D3 3 p=/dev/rmt/7cbn s=QUANTUM:DLT7000:TNA48S0267 l=1 4 p=/dev/rmt/19cbn s=QUANTUM:DLT8000:PKB02P0989 l=1 i=10200E09E6000030C36 5 p=/dev/rmt/20cbn s=QUANTUM:DLT8000:PKB02P0841 l=2 i=10200E09E6000030DC5
在 AIX 上:
# bptpcinfo -t /dev -o -
输出示例:
devid [p=devpath] [s=sn] [n=npid] [l=lun] [w=wwpn] [i=iddesc] 0 p=/dev/rmt0.1 s=STK:L20:LLC02203684 l=1 1 p=/dev/rmt5.1 s=QUANTUM:DLT8000:CXA49P1113 l=1 i=10200E09E6000034A57 2 p=/dev/rmt6.1 s=QUANTUM:DLT8000:PXB13P4180 l=2 i=10200E09E600004B70B 3 p=/dev/rmt7.1 s=STK:9840:331002059900 l=4 i=103500104F0004817E5 4 p=/dev/rmt9.1 s=QUANTUM:DLT8000:PXB33P0850 l=9 i=1036005013000B0526942333350 5 p=/dev/rmt10.1 s=QUANTUM:DLT8000:CX949P1208 l=10 i=1036005013000B0526939343950
示例 4 - 创建一个描述 SAN 上的所有设备的 3pc.conf
文件,然后将输出发送到备用文件:
# bptpcinfo -a -o /usr/openv/volmgr/database/3pc_alt1.conf
说明
使用 bptpcinfo 命令时,请注意以下几项:
请在没有执行备份时运行 bptpcinfo 命令。如果备份操作使用或保留了某个设备,则 bptpcinfo 可能无法获取有关该设备的信息。它在输出中不会列出此类设备。
如果不想重写现有的
3pc.conf
文件,请包括 -o 选项并指定所需的位置。如果有运行 Veritas SANPoint Control 的主机,请执行以下操作:使用 bpSALinfo 命令,将每个设备的全球名称和 LUN 值添加到
3pc.conf
文件中。如果不存在 SANPoint Control,则必须在3pc.conf
文件中编辑新条目。要编辑新条目,请手动添加每个设备的全球名称 (WWPN) 和 LUN。有关 SAN 配置的更多信息,请参见《NetBackup Snapshot Client 管理指南》。
文件
/usr/openv/volmgr/database/3pc.conf