Veritas NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
名称
tpconfig — 运行磁带配置实用程序
大纲
UNIX 系统: [-noverify]
-d | -dl | -l
UNIX 系统:
-add -drive -type drvtype -path drivepath [-nh ndmp_hostname] [-asciiname asciidrivename] [-index drvindex]] [-shared [yes|no]] [-cleanfreq hours] [-comment comment] [-drstatus UP | DOWN | DISABLED] [-scsi_protection [SPR | SR | NONE] [-robot robnum -robtype robtype] [-noverify] [-robdrnum robdrvnum | -VendorDrvName venddrvname | -ACS acsnum -LSM lsmnum -PANEL panelnum -DRIVE drivenum] [000-preview]
Windows 系统: -add -drive -type drvtype -port port -bus bus -target target -lun lun [-asciiname asciidrivename] [-index drvindex]] [-shared [yes|no]] [-cleanfreq hours] [-comment comment] [-drstatus [UP | DOWN | DISABLED]] [-scsi_protection [SPR | SR | NONE]] [-robot robnum -robtype robtype] [-noverify] [-robdrnum robdrvnum | -VendorDrvName vendor_drive_name] [-ACS acsnum -LSM lsmnum -PANEL panelnum -DRIVE drivenum] [preview]
UNIX 系统: -update -drive drvindex [-type drvtype] [-path drivepath] [-nh ndmp_hostname] [-noverify] [-newasciiname asciidrivename]] [-shared [yes|no]] [-cleanfreq hours] [-comment comment] [-drstatus [UP|DOWN|DISABLED]] [-robot robnum -robtype robtype] [-robdrnum robdrvnum | -VendorDrvName venddrvname | -ACS acsnum -LSM lsmnum -PANEL panelnum -DRIVE drivenum]
Windows 系统: -update -drive drvindex [-type drvtype] [-port port -bus bus -target target -lun lun ] [-nh ndmp_hostname -path drivepath] [-noverify] [-newasciiname asciidrivename]] [-shared [yes|no]] [-cleanfreq hours] [-comment comment] [-drstatus [UP|DOWN|DISABLED]] [-robot robnum -robtype robtype] [-robdrnum robdrvnum | -VendorDrvName vendor_drive_name] [-ACS acsnum -LSM lsmnum -PANEL panelnum -DRIVE drivenum]
-delete -drive drvindex
-multiple_delete -drive drvindex1:...:drvindexN
-add -disk_array array_hostname -disk_user_id user_ID -arraytype_name "name:displayname" -requiredport IP_port_number [-password password [-key encryption_key]]
-update -disk_array array_hostname -disk_user_id user_ID -requiredport IP_port_number [-arraytype_name "name:displayname"] [-password password [-key encryption_key]]
-delete -disk_array array_hostname -disk_user_id user_ID [-arraytype_name "name:displayname"]
-ddiskarrays
-list_array_types [media_server]
UNIX 系统: -add -robot robnum -robtype robtype -robpath devfile [-nh ndmp_hostname]
Windows 系统: -add -robot robnum -robtype robtype -port port -bus bus -target target -lun lun
Windows 系统: -add -robot robnum -robtype robtype [-nh ndmp_hostname] -robpath changername [-bus bus -target target -lun lun]
-add -robot robnum -robtype robtype -cntlhost cntlhost
UNIX 系统: -update -robot robnum [-robtype robtype] [-robpath devfile] [-cntlhost cntlhost]
Windows 系统: -update -robot robnum [-robtype robtype] [-port port -bus bus -target target -lun lun | -cntlhost cntlhost]
-update -robot robnum [-robtype robtype] [-robpath devfile] [-nh ndmp_hostname] [-bus bus] [-target target] [-lun lun]
-update -robot robnum [-robtype robtype]
-delete -robot robnum
-multiple_delete -robot robnum1:...:robnumN
-add -drpath -path drivepath [-nh ndmp_hostname] -asciiname asciidrivename [-drstatus [UP|DOWN|DISABLED]] [-noverify]
UNIX 系统: -update -drpath -old_path drivepath -path drivepath [-nh ndmp_hostname] -asciiname asciidrivename [-drstatus [UP|DOWN|DISABLED]] [-scsi_protection SPR|SR|DEFAULT] [-noverify]
Windows 系统: -update -drpath -old_port port -old_bus bus -old_target target -old_lun lun -port port -bus bus -target target -lun lun -asciiname asciidrvname [-drstatus [UP|DOWN|DISABLED]] [-noverify]
UNIX 系统: -delete -drpath -path drivepath -asciiname asciidrivename [-nh ndmp_hostname]
Windows 系统: -delete -drpath -port port -bus bus -target target -lun lun | -path drivepath [-nh ndmp_hostname] -asciiname asciidrvname
-dnh
-dnh -all_hosts
-ddnh
-add -nh ndmp_hostname
-add -nh ndmp_hostname -user_id | -filer_user_id user ID [-password password [-key encryption_key]] -snap_vault_filer
-update -nh ndmp_hostname -user_id | -filer_user_id user ID [[-password password [-key encryption_key]]
-delete -nh ndmp_hostname -user_id | -filer_user_id user ID
-multiple_delete -nh ndmp_hostname_1: ... :ndmp_hostname_N
-add -default_user_id user ID [-password password [-key encryption_key]]
-update -default_user_id user ID [-password password [-key encryption_key]]
-delete -default_user_id
-add | -update -disk_array disk_array_host_name -disk_user_id user_ID -arraytype disk_array_type -requiredport IP_port_number [-password password [-key encryption_key]]
tpconfig -delete -disk_array disk_array_host_name -disk_user_id user_ID [-arraytype disk_array_type]
tpconfig -ddiskarrays
-add | -update -virtual_machine virtual_machine_name -vm_user_id user_id -vm_type virtual_machine_type -requiredport IP_port_number [-password password [-key encryption_key]]
-delete -virtual_machine virtual_machine_name -vm_user_id user_id [-vm_type virtual_machine_type]
-dvirtualmachines
-add -storage_server server_name -stype server_type -sts_user_id user_ID [-password password] [-st storage_type]
-update -storage_server server_name -stype server_type -sts_user_id user_ID [-password password]
-delete -storage_server server_name -stype server_type -sts_user_id user_ID
-dsh [-stype server_type]
-dsh -all_hosts
-dev_ping [-drive -path drivepath | -robpath robotpath] [-nh ndmp_hostname]
Windows 系统: -dev_ping [-drive] -port port -bus bus -target target -lun lun
-emm_dev_list [-noverbose]
-add -application_server application_server_name [-application_server_user_id user_ID] -application_type application_type -requiredport IP_port_number [-password password [-key encryption_key]] [-host_user_id host user ID] [-host_password hostpassword] [-host_RSA_key host RSA key]
-update -application_server application_server_name [-application_server_user_id user_ID] -application_type application_type -requiredport IP_port_number [-password password [-key encryption_key]] [-host_user_id host user ID] [-host_password hostpassword] [-host_RSA_key host RSA key]
-delete -application_server application_server_name [-application_server_user_id user_ID] -application_type application_type -requiredport IP_port_number [-password password [-key encryption_key]]
-dappservers
-add_plugin -cloudpoint_server server_name -plugin_id netbackup_plugin_ID -plugin_type cloudpoint_plugin_type
-modify_plugin -cloudpoint_server server_name -plugin_id netbackup_plugin_ID -plugin_type cloudpoint_plugin_type
-list_plugins --cloudpoint_server server_name
-list_supported_plugins
-add -cloudpoint_server cloudpoint_server_name - cloudpoint_server_user_id user_ID -manage_workload manage_workload [-requiredport IP_port_number]
–update –cloudpoint_server cloudpoint_server_name -cloudpoint_server_user_id cloudpoint_user_id -manage_workload manage_workload [-requiredport IP_port_number]
-cloudpoint_server cloudpoint_server_name [-delete_media_server media_server]
-list_supported_cloud_providers
{-dcloudpointservers | -dmediaservers} [-cloudpoint_server cloudpoint_server_name
-dcloudpointservers [-manage_workload manage_workload]
-reset_password -cloudpoint_server cloudpoint_server_name -cloudpoint_server_user_id user_ID
-refresh [-cloudpoint_server cloudpoint_server_name]
在 UNIX 系统上,此命令的目录路径为 /usr/openv/volmgr/bin/
在 Windows 系统上,此命令的目录路径为 install_path\Volmgr\bin\
描述
tpconfig 用于配置在 NetBackup 中使用的机械手、驱动器、驱动器阵列、驱动器路径和主机。
在 UNIX 系统上,tpconfig [-noverify] 用于启动介质管理和设备管理实用程序。这一基于菜单的实用程序可在 EMM 数据库中创建和修改设备。EMM 数据库用于标识由 ltid(介质管理器设备后台驻留程序)控制的机械手和驱动器。ltid 会使用该数据库将操作员的驱动器状态显示中的驱动器与 /dev 目录中的设备文件关联起来。
例如,假设您要将系统识别的驱动器配置为 8 毫米类型的驱动器。在 /dev 目录中查找并定位 8 毫米类型驱动器的“关闭时不倒带”设备路径。然后为驱动器指定该设备路径。tpconfig 随即在相应的设备数据库中记录该设备路径。
在使用 tpconfig 更改设备配置后,请使用 stopltid 停止 ltid 和 avrd 后台驻留程序(如果这些程序正在运行)。然后,使用 ltid 命令再次启动后台驻留程序。有关更多信息,请参见 ltid。
在 Windows 系统上,更改完设备配置后,请停止并重新启动 NetBackup 设备管理器服务。
您必须拥有管理员权限才能运行此实用程序。
选项
下面四个选项仅适用于 NetBackup Enterprise Server。这些选项用于指定 ACS(自动盒式系统)机械手的配置。
- -ACS acsnum, -LSM lsmnum, -PANEL panelnum, -DRIVE drivenum
acsnum 按 ACS 库软件主机上的配置指定磁带库的编号。
lsmnum 指定包含该驱动器的库存储模块。
panelnum 指定该驱动器所在的机械手面板。
drivenum 指定该驱动器的编号。
- -add
添加驱动器、机械手、虚拟机、应用程序服务器或 CloudPoint 服务器,具体取决于所使用的选项。
- -add_media_server media_server
添加要与 CloudPoint 服务器关联的介质服务器,以用于保护云工作负载。要关联多个介质服务器,则必须多次运行该命令。介质服务器必须为版本 8.1.2 或更高版本。如果不关联介质服务器,则使用 NetBackup 主服务器。
- -all_hosts
显示在介质服务器上拥有凭据的所有主机。
- -add_plugin
将 CloudPoint 插件添加到已配置 NetBackup 的 CloudPoint 服务器。
- -application_server application_server_name
指定应用程序服务器的主机名。
- -application_server_user_id user_ID
指定登录应用程序服务器所需的用户名。
- -application_type application_type
指定应用程序服务器的类型。也可以使用第三方插件供应商指定的值。application_type 值的示例有:
hadoop
hbase
mongodb
- -arraytype_name "name:displayname"
指定要为其添加、更新或删除凭据的磁盘阵列的类型。
只有当 name 或 displayname 包含一个或多个空格时,才需要加双引号 (")。
磁盘阵列供应商会提供 name:displayname 的值。name 部分是 NetBackup 在内部使用的唯一字符串。displayname 部分是在 NetBackup 管理控制台显示和菜单中使用的可读性更强的字符串。
字符串的值取决于该阵列所使用的磁盘阵列供应商和提供商类型,如下所示:
对于特定的阵列提供商,格式如下:
vendorID_productID:displayname
默认情况下,NetBackup 包括若干个特定的阵列提供商,包括(但不限于)以下各项:
HP_HSV:HP EVA
EMC_CLARIION:EMC CLARiiON
EMC_SYMMETRIX:EMC Symmetrix
IBM_TOTALSTORAGE:IBM System Storage
NETAPP_LUN:NetApp
对于通用阵列提供商,格式如下:
OPENARRAY::vendorID_productID:displayname
例如,OPENARRAY::HITACHI_HDS:Hitachi HDS DF Series。
要确定有效的磁盘阵列类型名称,请使用 -list_array_types 选项。
需要 Flexible Disk 或 Snapshot Client 许可证。
- -asciiname asciidrivename
指定驱动器的名称。此名称用于在介质管理器中标识驱动器。如果没有指定驱动器名称,介质管理器将生成一个名称。如果添加或更新共享驱动器 (Shared Storage Option),应使该名称尽可能具有描述性。
- -bus bus
指定机械手或驱动器连接到的 SCSI 总线号。
请参见 NetBackup 设备配置指南。
- -cleanfreq hours
指定两次驱动器清洗间隔的小时数。在添加驱动器时,NetBackup 开始记录在该驱动器中装入卷的时间长度。
如果驱动器位于机械手中,并且该机械手中定义了清洗卷,则在以下情况下会发生清洗操作:累计装入时间超出为清洗频率指定的时间。清洗驱动器后,NetBackup 将重置装入时间。
如果驱动器为独立驱动器或没有定义清洗磁带,则 tpclean -L 输出的注释字段会显示以下消息:NEEDS CLEANING。要清洗驱动器,请使用 tpclean 命令。
如果使用 TapeAlert,则不需要基于频率的清洗。
- -cloudpoint_server server_name
指定 CloudPoint 服务器的主机名。
- -cloudpoint_server_user_id user_id
配置 CloudPoint 服务器的用户名和密码。可以在此选项中使用 -add、-update 或 -delete 命令,以指定 CloudPoint 服务器的用户名和密码。
- -cntlhost cntlhost
此选项仅适用于 NetBackup Enterprise Server。
对于机械手控制位于另一台主机上的机械手,此选项指定控制磁带库的主机。
此选项仅适用于可以在另一主机上进行机械手控制的 TLD 机械手。该选项也适用于 ACS 机械手。
对于 ACS 机械手,指定安装 ACS 库软件的主机名。
- -comment comment
添加有关驱动器的注释。该字段可用来存储 SCSI 查询数据,以便轻松地检查驱动器类型和固件级别。
- -d
列出当前的配置信息。在 UNIX 系统上,该列表将发送到 stdout。此选项可能会将驱动器名称截断为 22 个字符。
- -dappservers
显示所有配置的应用程序服务器。例如,hadoop 服务器或 hbase 服务器。
- -dcloudpointservers
列出已配置 NetBackup 的所有 CloudPoint 服务器。
- -ddiskarrays
显示配置的所有磁盘阵列。
- -ddnh
显示介质服务器上的默认凭据。
- -default_user_id user_ID
为给定主服务器下的所有介质服务器和 NDMP 主机的组合配置一个用户名和密码。对于每个文件服务器,只能添加一次用户名和密码。可以在此选项中使用 -add、-update 或 -delete 命令,以指定用户名和密码。
- -delete
删除驱动器、机械手或主机凭据,具体取决于所使用的选项。
- -delete_media_server media_server
删除与 CloudPoint 服务器关联的介质服务器。
- -dev_ping
从设备中检索设备信息。
- -disk_array array_hostname
指定磁盘阵列的主机名。只有在已安装 NetBackup Snapshot Client 后才能使用此选项。
- -disk_user_id user_ID
指定 NetBackup 与磁盘阵列通信时必须使用的用户名。只有在已安装 NetBackup Snapshot Client 后才能使用此选项。
- -dl
以长格式列出当前的配置信息。在 UNIX 系统上,该列表将发送到
stdout
。列出完整的驱动器名称。- -dmediaservers [-cloudpoint_server cloudpoint_server_name]
显示配置了 CloudPoint 服务器的所有介质服务器。如果没有提供 CloudPoint 服务器名称,将显示配置了所有 CloudPoint 服务器的所有介质服务器。
- -dnh
显示位于介质服务器上的 NDMP 主机上的凭据。
- -drive
可以将此选项与 -add 选项一起使用,以指定此操作针对于某个驱动器。
- -drive drvindex
指定驱动器索引。可以在此选项中使用 -update、-delete 或 -multiple_delete 选项,用于指定对驱动器执行的操作。
- -drpath
添加、更新或删除的驱动器路径。
- -drstatus UP|DOWN|DISABLED
将磁带驱动器的初始状态设置为“启动”、“关闭”或“禁用”状态。默认情况下,启用(“启动”)发现的驱动器路径。管理员或操作员可以禁用驱动器路径或将其配置为“启动”/“关闭”。用户还可以在“设备管理”窗口中使用选项执行该操作。
驱动器状态为 DISABLED 意味着 NetBackup 将存储该路径,但绝不使用它。此外,如果后来又发现了此驱动器路径,NetBackup 不会配置它以供使用。
- -dsh
显示指定服务器类型 (-stypeserver_type) 或所有介质服务器 (-all_hosts) 的 OpenStorage 凭据。
- -dvirtualmachines
显示所有配置的虚拟计算机。
- -emm_dev_list [-noverbose]
列出 EMM 数据库中显示的全部磁带设备配置。该信息包括所有介质服务器、主服务器、NDMP 主机以及它们的凭据。
- -filer_user_id user ID
为连接到文件服务器的所有介质服务器配置用户名和密码。对于每个文件服务器,只能添加一次用户名和密码。可以在此选项中使用 -add、-update 或 -delete 命令,以指定用户名和密码。
- -host_user_id host user ID
为 SSH 实现输入主机的用户 ID。此选项仅与相关的 BigData 工作量结合使用。例如,MongoDB 需要此选项,而 Hadoop 不需要。
- -host_password hostpassword
为 SSH 实现输入主机的用户密码。此选项仅与相关的 BigData 工作量结合使用。例如,MongoDB 需要此选项,而 Hadoop 不需要。
- -host_RSA_key host RSA key
为 SSH 实现输入 RSA 密钥指纹。此选项仅与相关的 BigData 工作量结合使用。例如,MongoDB 需要此选项,而 Hadoop 不需要。
- -index drvindex
指定驱动器索引(用于标识驱动器的唯一编号)。在添加驱动器时不需要提供驱动器索引,原因是介质管理器将使用下一个可用的驱动器索引。特定主机上的每个驱动器必须具有唯一的索引号。
- -key encryption_key
创建加密密钥,以便可以通过网络安全地发送加密的凭据。如果指定了 -key 选项,则 tpconfig 会假定密码以 MD5 加密格式提供。
- -l
列出当前的设备配置(输出到 stdout)。在 Windows 系统上,-l 将以 {p,b,t,l} 编码形式显示 Windows 设备路径:p 是端口,b 是总线,t 是目标,l 是 LUN。
- -list_array_types [media_server]
列出可为其添加和管理凭据的磁盘阵列类型。
要将输出限制为对特定介质服务器有效的磁盘阵列类型,请指定该介质服务器。
对于每种阵列类型,命令输出采用 name:displayname 格式。
磁盘阵列供应商会提供 name:displayname 的值。name 部分是 NetBackup 在内部使用的唯一字符串。displayname 部分是在 NetBackup 管理控制台显示和菜单中使用的可读性更强的字符串。
字符串的值取决于该阵列所使用的磁盘阵列供应商和提供商类型,如下所示:
对于特定的阵列提供商,格式如下:
vendorID_productID:displayname
默认情况下,NetBackup 包括若干个特定的阵列提供商,包括(但不限于)以下各项:
HP_HSV:HP EVA
EMC_CLARIION:EMC CLARiiON
EMC_SYMMETRIX:EMC Symmetrix
IBM_TOTALSTORAGE:IBM System Storage
NETAPP_LUN:NetApp
对于通用阵列提供商,格式如下:
OPENARRAY::vendorID_productID:displayname
例如,OPENARRAY::HITACHI_HDS:Hitachi HDS DF Series。
- -list_supported_cloud_providers
列出与每个云提供商关联的整数。
- -list_supported_plugins
列出已配置 NetBackup 的 CloudPoint 服务器支持的所有 CloudPoint 插件。
- -list_plugins
列出使用 CloudPoint 服务器配置的所有插件。
- -lun lun
指定机械手或驱动器连接的 LUN(或 SCSI ID)。
有关设备路径的更多信息,请参见《NetBackup 设备配置指南》。
- -manage_workload
指定是否将 CloudPoint 服务器用于本地存储阵列管理或云中工作负载。注册 CloudPoint 服务器时需要使用此选项。
ONPREM 指定将 CloudPoint 服务器用于本地存储阵列管理。
CLOUD 指定将 CloudPoint 服务器用于云管理。
- -modify_plugin
修改添加到已配置 NetBackup 的 CloudPoint 服务器的 CloudPoint 插件的凭据。
- -multiple_delete
删除多个驱动器或机械手,具体取决于所使用的选项。
- -newasciiname asciidrivename
指定驱动器的新名称。
- -nh ndmp_hostname | puredisk_hostname
指定 NDMP 服务器或 PureDisk 服务器的主机名。Veritas 仅在 NetBackup 5000 系列设备上支持 PureDisk 选项。
- -noverify
不会验证驱动器路径。通常,tpconfig 会验证“关闭时不倒带”驱动器路径是否具有与以下内容相关的正确次要编号位:不倒带、变量、Berkeley 样式等。如果您使用非标准平台设备文件,则此选项可能会很有帮助,这样您可以确保设备文件是正确的。
- -old_bus bus
此选项在 Windows 系统上使用。用于指定用户可能希望添加、升级或删除的 SCSI 总线号。
- -old_lun lun
此选项在 Windows 系统上使用。用于指定机械手或驱动器连接到的逻辑单元号(或 SCSI ID)。在注册表中可以找到此信息。使用此命令可以添加、升级或删除现有的 LUN。
- -old_path drivepath
如果此选项与 -update 命令一起使用,则可以将路径更改为数据库中已存在的路径。如果该路径不存在,将出现错误。
- -old_port port
此选项在 Windows 系统上使用。用于指定用户可能希望添加、升级或删除的现有 SCSI 端口号。
- -old_target target
此选项在 Windows 系统上使用。用于指定机械手或驱动器连接到的现有目标号(或 SCSI ID)。使用此命令可以添加、升级或删除现有的目标。
- -password password
设置用于登录到 NDMP、
、OpenStorage、虚拟机主机或应用程序服务器的密码。该密码不能超过 100 个字符。- -path drivepath
指定介质服务器或 NDMP 文件服务器上驱动器的设备路径。
在 Windows 系统上,drive_path 变量是驱动器的非 NDMP Windows 设备路径。可以按 {p,b,t,l} 格式使用它:p 是端口,b 是总线,t 是目标,l 是 LUN。此信息位于注册表中。
- -plugin_id netbackup_plugin_ID
为要与云插件关联的 NetBackup 指定插件 ID。插件 ID 必须是唯一的。该 ID 只能包含如下所示的字母和符号:
A-Z、a-z
0-9
+、.、_、-
- -plugin_type cloudpoint_plugin_type
指定 CloudPoint 插件类型。您可以使用 tpconfig -list_supported_plugins 命令获取 CloudPoint 服务器支持的所有插件的列表。
- -port port
指定机械手或驱动器连接到的 SCSI 端口号。在注册表中可以找到此信息。
- -refresh
刷新 CloudPoint 服务器。
- -requiredport IP_port_number
指定磁盘阵列、虚拟机或应用程序服务器接受来自 NetBackup 的连接时所用的 IP 端口号。Nutanix Acropolis 群集的默认端口号为 9440。Hadoop 的默认端口号为 HDFS NameNode HTTP UI。只能通过命令行界面更改此端口号。如果为 BigData 工作量配置了与主机相关的参数,则必须指定所有参数才可更新所需的端口。
- -reset_password
重置 CloudPoint 服务器密码。
- -robdrnum robdrvnum
指定驱动器的物理位置(在机械手内部)。如果分配了错误的号码,NetBackup 将不会检测到它。但是最终将发生错误,原因是机械手控制尝试将介质装入到错误的驱动器上。
通过检查与驱动器相连的连接器或者查阅供应商提供的文档,通常可以确定物理位置。
- -robot robnum
用于在 NetBackup 中标识机械手的唯一编号。您可以使用 add 选项来分配机械手编号。
所有机械手的编号都必须是唯一的,这与机械手类型和控制它们的主机无关。
在 NetBackup Enterprise Server 上,对于共享同一 EMM 服务器(并使用同一 EMM 数据库)的所有机械手,机械手编号必须是唯一的。无论机械手类型或控制机械手的主机是什么,此要求都适用。例如,同一个 EMM 服务器,但不同的主机控制两个 TLD 机械手。这种情况下,机械手编号必须有所区分。
- -robpath devfile
指定介质服务器或 NDMP 文件服务器上机械手的设备路径。
在 Windows 系统上,drive_path 变量是驱动器的非 NDMP Windows 设备路径。可以按 {p,b,t,l} 格式使用它:p 是端口,b 是总线,t 是目标,l 是 LUN。此信息位于注册表中。
- -robtype robtype
指定计划配置的机械手类型,可以是 NetBackup 支持的任何类型。访问支持网站,确定要为特定的磁带库模型指定的机械手类型。
对于 NetBackup Enterprise Server,机械手类型可以是以下任意一种:
acs 代表自动盒式系统,或 tld 代表 DLT 磁带库。
对于 NetBackup 服务器,机械手类型可以是以下任意一种:
tld,代表 DLT 磁带库
- -scsi_protection SPR | SR | NONE
指定 NetBackup 用于 SCSI 磁带驱动器的访问保护。
SPR - SCSI 永久保留开/永久保留关
SR - SCSI 保留/释放
NONE - 无 SCSI 访问保护
默认情况为 SCSI 保留/释放 (SR)。
- -shared yes|no
表明您希望添加或更新共享的驱动器。
- -snap_vault_filer
-snap_vault_filer 标志在 NetApp P3 功能中使用。该标志在存储该文件服务器的用户名和密码时设置。如果未设置,用户界面将不允许用户在该文件服务器上添加卷。如果您在无此标志的情况下隐藏用户名和密码,请执行下列操作:确定您是否需要其功能,执行 tpconfig -delete 操作,然后使用该标志重新添加它。在以下上下文中使用时,该标志和 NetApp P3 功能一起使用:
tpconfig -add -user_id root -nh mmnetapp2-target target -snap_vault_filer
- -st storage_type
指定标识存储服务器属性的数字值。存储供应商提供此值。磁盘是否格式化和如何挂接是互斥和互补的。
storage_type 的可能值如下:
格式化的磁盘 = 1
原始磁盘 = 2
直接挂接 = 4
网络挂接 = 8
storage_type 值是代表磁盘是已格式化还是保留原始状态的数字值(1 或 2)和代表如何挂接磁盘的数字值(4 或 8)之和。默认值为 9(通过网络挂接的格式化磁盘)。
- -storage_server server_name
指定存储服务器的主机名。
- -sts_user_id user_id
指定登录存储服务器所需的用户名。如果存储服务器不需要登录凭据,则输入虚拟凭据。
您必须记住这些凭据。在对 CloudCatalyst 存储服务器进行灾难恢复期间需要使用这些凭据。
- -stype server_type
指定标识存储服务器类型的字符串。server_type 值可能源自以下来源之一:
Veritas 提供的存储。可能的值有 AdvancedDisk 和 PureDisk。
第三方磁盘设备。供应商提供了 server_type 字符串。
云存储。使用 csconfig cldprovider -l 命令确定可能的 stype 值。云 stype 值反映了云存储提供程序。云存储 stype 值还可包含一个后缀(例如
amazon_crypt
)。可能的后缀是:_raw:将具有原始格式的 NetBackup 备份映像发送至云。如果您在将数据发送至云存储前不需要压缩或加密数据,则使用此选项。
_rawc:在将数据写入云存储之前压缩数据。
_crypt
:在将数据写入云存储之前使用 AES-256 加密对此数据进行加密。要使用此选项,必须在 NetBackup 中配置 KMS。_cryptc:将数据写入云存储之前压缩和加密数据。
存储服务器类型区分大小写。
- -target target
指定机械手或驱动器连接到的目标号(或 SCSI ID)。
有关信息,请参见注册表(Windows 系统)或《NetBackup 设备配置指南》。
- -type drvtype
指定配置的驱动器类型。
对于 NetBackup Enterprise Server,驱动器类型可以是以下任意一种:
4mm(代表 4 毫米磁带驱动器)、8mm(代表 8 毫米磁带驱动器)、8mm2(代表 8 毫米磁带驱动器 2)、8mm3(代表 8 毫米磁带驱动器 3)、dlt(代表 DLT 磁带驱动器)、dlt2(代表 DLT 磁带驱动器 2)、dlt3(代表 DLT 磁带驱动器 3)、dtf(代表 DTF 磁带驱动器)、qscsi(代表 QIC 磁带驱动器)、hcart(代表 1/2 英寸盒式磁带驱动器)、hcart2(代表 1/2 英寸盒式磁带驱动器 2)、hcart3(代表 1/2 英寸盒式磁带驱动器 3)。对于 NetBackup 服务器,磁带驱动器类型可以是以下任意一种:4mm(代表 4 毫米磁带驱动器)、8mm(代表 8 毫米磁带驱动器)、dlt(代表 DLT 磁带驱动器)、hcart(代表 1/2 英寸盒式磁带驱动器)、qscsi(代表 QIC 磁带驱动器)。
- -update
更改驱动器、机械手或 CloudPoint 服务器的配置信息。
- -user_id user_ID
指定介质服务器上为其添加凭据的特定 NDMP 主机的用户 ID。
注意:
介质服务器只允许每个 NDMP 主机名有一个用户 ID。如果尝试为一个 NDMP 主机名添加第二个用户 ID,则操作会失败。
- -virtual_machine virtual_machine_name
指定要添加、更新或删除其凭据的虚拟机的主机名。只有在已安装 NetBackup Snapshot Client 后才能使用此选项。
- -vm_type virtual_machine_type
指定虚拟机的类型。下面是可能的值:
1 - VMware VirtualCenter Server
2 - VMware ESX Server
3 - VMware Converter Server
只有在已安装 NetBackup Snapshot Client 后才能使用此选项。
- -vm_user_id user_id
指定 NetBackup 在与虚拟机的磁盘阵列进行通信时必须使用的用户名。只有在已安装 NetBackup Snapshot Client 后才能使用此选项。
必须有管理员权限才能运行此命令。
说明
tpconfig -d 可能会将驱动器名称截断为 22 个字符,并且 tpconfig -l 可能会将驱动器名称截断为 32 个字符。要列出完整的驱动器名称,请使用 tpconfig -dl。
“删除多个 NDMP 主机凭据”的选项仅适用于此主机和指定的文件服务器专用的凭据。换言之,它没有默认或文件服务器凭据。
示例
在以下示例中,由于页面宽度有限,输入的命令可能以多行显示。实际的命令是在一行上输入的。
示例 1 - 本地 Windows 服务器上的机械手控制
以下示例添加直接连接到 Windows 主机的机械手,并向该机械手中添加驱动器。
以下过程仅适用于 NetBackup 服务器:
使用以下命令添加机械手:
# tpconfig -add -robot 7 -robtype tld -port 0 -bus 0 -target 2 lun 0
如果机械手中有尚未配置的驱动器,请添加它们。
以下命令使用系统名称 Tape0 来配置驱动器,而 Tape0 受在步骤 1 中配置的机械手的控制(服务器已挂接并识别 Tape0)。
# tpconfig -add -drive -type dlt -port 1 -bus 2 -target 3 / -lun 4 -comment "DEC DLT2000 8414" -index 0 -drstatus up / -robot 7 -robtype tld -robdrnum 1 -asciiname DLT2000_D1
此示例中的命令使用注释字段。该字段用于存储驱动器的 SCSI 查询数据,以便于用户方便地查看驱动器类型和固件级别。
如果机械手包含任何当前配置为独立驱动器的驱动器,请更新驱动器配置,将它们置于机械手控制之下。
以下命令更新驱动器 1 和 2 的配置:
# tpconfig -update -drive 1 -type dlt -robot 7 -robtype tld -robdrnum 1 # tpconfig -update -drive 2 -type dlt -robot 7 -robtype tld -robdrnum 2
注意:
为驱动器分配正确的机械手驱动器号。如果机械手驱动器盘符不正确,磁带装入或备份可能失败。
示例 2 - 远程主机上的机械手控制
此示例仅适用于 NetBackup Enterprise Server:
它假设机械手中的一个或多个磁带驱动器连接到您当前正在管理设备的 Windows 主机上。
下面是 tpconfig 操作的顺序,该操作用于添加连接到另一台主机的机械手:
执行以下命令添加机械手:
# tpconfig -add -robot 9 -robtype tld -cntlhost perch
确保机械手编号与控制主机上的编号匹配。
如果机械手包含任何当前配置为独立驱动器的驱动器,请更新驱动器配置,将它们置于机械手控制之下。
以下命令更新驱动器 1 和 2 的配置:
# tpconfig -update -drive 1 -type dlt -robot 9 -robtype tld -robdrnum 1 # tpconfig -update -drive 2 -type dlt -robot 9 -robtype tld -robdrnum 2
注意:
分配了正确的机械手驱动器号。如果机械手驱动器盘符不正确,磁带装入或备份可能失败。
如果机械手中有一些驱动器尚未配置,现在请添加它们。
以下命令使用系统名称 Tape0 来配置驱动器,而 Tape0 受在步骤 1 中配置的机械手的控制(Windows 服务器已挂接并识别 Tape0)。
# tpconfig -add -drive -type dlt -port 1 -bus 2 -target 3 -lun 4 -comment ‘DEC DLT2000 8414’ -index 3 -drstatus up -robot 9 -robtype tld -robdrnum 3 -asciiname DLT2000_D3
示例 3 - 配置新的独立驱动器
以下是如何在安装驱动器之后添加独立驱动器的示例:
# tpconfig -add -drive -type dlt -port 1 -bus 2 -target 3 -lun 4 -comment ‘DEC DLT2000 8414’ -index 6 -asciiname DLT2000_standalone
示例 4 - 演示 Windows 如何显示设备路径
本示例演示了 -l 选项如何按 p, b, t, l 格式来显示 Windows 设备路径。
C:\Program Files\VERITAS\Volmgr\bin>tpconfig -l
Device Robot Drive Robot Drive Device Type Num Index Type DrNum Status Comment Name Path robot 0 - TLD - - - - {3,1,0,1} robot 1 - TLD - - - - {3,1,0,3} robot 2 - TLD - - - - {3,1,2,0} drive - 0 pcd - DISABL - SONY.SDX-400V.000 {1,0,0,0} drive - 1 hcart2 2 UP - IBM.ULTRIUM-TD2.001 {3,1,0,2} drive - 1 hcart2 2 UP - IBM.ULTRIUM-TD2.001 {3,1,1,2} drive - 2 hcart2 1 UP - IBM.ULTRIUM-TD2.002 {3,1,0,5} drive - 2 hcart2 1 UP - IBM.ULTRIUM-TD2.002 {3,1,1,5} drive - 3 hcart 1 DOWN - IBM.ULTRIUM-TD1.003 {3,1,0,6} drive - 3 hcart 1 UP - IBM.ULTRIUM-TD1.003 {3,1,1,6} drive - 4 hcart 2 UP - IBM.ULTRIUM-TD1.004 {3,1,0,7} drive - 4 hcart 2 UP - IBM.ULTRIUM-TD1.004 {3,1,1,7} drive - 5 hcart2 2 UP - IBM.ULTRIUM-TD2.005 {3,1,2,1} drive - 6 hcart2 1 UP - IBM.ULTRIUM-TD2.006 {3,1,2,2}
示例 5 - 在 NetBackup 中添加 CloudPoint 服务器
tpconfig -add -cloudpoint_server testserver.test.com -cloudpoint_server_user_id User1 -manage_workload ONPREM -requiredport 1024 Enter the CloudPoint Server host's password for User Id User 1: Please re-enter the CloudPoint Server host's password to confirm it:
示例 6 - 在 NetBackup 中添加 CloudPoint 插件
tpconfig -add_plugin -cloudpoint_server testserver.test.com -plugin_id ITAzure -plugin_type azure Enter Tenant ID: test Enter Client ID: test Enter Secret Key: Enter confirm Secret Key:
另请参见