Veritas NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
名称
bpsturep — 替换所选的 NetBackup 存储单元属性
大纲
-label storage_unit_label [-verbose] [-host host_name | -nodevhost] [-path path_name | -dp disk_pool | -density density [-rt robot_type -rn robot_number] [-nh NDMP_attach_host] [-cj max_jobs] [-odo on_demand_only_flag] [-mfs max_fragment_size] [-maxmpx mpx_factor] [-cf clearfiles] [-flags flags] [-tt transfer_throttle] [-hwm high_water_mark] [-lwm low_water_mark] [-okrt ok_on_root] [[-addhost | -delhost] host_name [host_name]] [-hostlist host_name [host_name]] [-M master_server [,...] [-uw 1|0]
-group storage_unit_group [-addstu | -delstu] storage_unit_label [-M master_server [,...]] [-sm selection_method]
在 UNIX 系统上,此命令的目录路径为 /usr/openv/netbackup/bin/admincmd/
在 Windows 系统上,此命令的目录路径为 install_path\NetBackup\bin\admincmd\
描述
bpsturep 命令修改现有的 NetBackup 存储单元,具体地说就是在 NetBackup 目录库中替换所选存储单元或存储单元组属性。命令行中必须包含存储单元的标签或存储单元组的组名。标签或组名是 bpsturep 唯一无法修改的存储单元属性。
注意:
此命令不允许将磁盘存储单元 (DSU) 或磁带存储单元更改为磁盘分段作业存储单元 (DSSU)。此外,也不能将 DSSU 更改为 DSU 或磁带存储单元。
使用 bpsturep 命令时务必谨慎。对存储单元或存储单元组的修改必须和现有的属性一致。请确保最后得到的属性组合是有效的,尤其要注意以下属性:
robot_type robot_number density_type max_fragment_size path_type NDMP_attach_host
修改这些属性的最安全方法是为每个要替换的属性运行一次 bpsturep。
bpsturep 通过使用指定属性更改来修改存储单元,从而完成更改操作。在运行 bpsturep 后,再运行 bpstulist,以确定是否应用了所需更改。
错误将发送到 stderr
。而该命令的活动日志将发送到当天的 NetBackup 管理日志文件中。
有关存储单元的更多信息,请参见《NetBackup 管理指南,第 I 卷》。
任何得到授权的用户均可运行此命令。
有关 NetBackup 授权的详细信息,请参见《NetBackup 安全和加密指南》。
选项
- -cf clearfiles
启用 NBU 介质以对备份数据执行数据转换操作。通常,OpenStorage 插件使用元数据执行块级别重复数据删除操作,以减少所用磁盘空间的总量。此值仅对使用 OST 磁盘池配置的磁盘存储单元有效。
clearfiles 变量可以是下列值之一:
0 - 禁用所有数据转换操作。
1 - 启用详细转换操作。元数据描述已备份文件的所有属性。这些文件称为透明文件。
2 - 启用简单转换操作。元数据仅标识已备份文件的名称、大小和字节偏移位置。这些文件称为不透明文件。
- -cj max_jobs
该存储单元最多可允许的并行作业数。max_jobs 为一个非负整数。合适的值取决于服务器有效运行多个备份进程的能力以及存储介质上的可用空间。
有关每个策略的最多作业数的更多信息,请参见《NetBackup 管理指南,第 I 卷》。
零 (0) 表示调度作业时从不选择该存储单元。默认值为 1。
- -density density_type
如果包含此选项,则存储单元类型是“介质管理器”。此选项没有默认值。如果命令行上有机械手类型,则密度值应该与机械手类型保持一致。只能独立使用 -density、-path 和 -dp 选项。
有效的“密度”类型包括:
dlt - DLT 盒式磁带
dlt2 - DLT 备用盒式磁带
8mm - 8 毫米盒式磁带
4mm - 4 毫米盒式磁带
qscsi - 1/4 英寸盒式磁带
注意:
以下密度仅适用于 NetBackup Enterprise Server。
hcart - 1/2 英寸盒式磁带
hcart2 - 备用 1/2 英寸盒式磁带
dtf - DTF 盒式磁带
- -dp disk_pool
指定磁盘池的名称。磁盘池是该存储单元的数据存储区域。该选项仅在磁盘类型为 6(磁盘池)时才可以使用。磁盘池必须已存在。
- -dt disk_type
允许用户指定磁盘类型。下面是 disk_type 的有效值:
1 - BasicDisk
3 - SnapVault
6 - DiskPool
- -flags flags
将存储单元指定为分段作业存储单元,此时可进行快速还原。flags 的有效值为:NONE 和 STAGE_DATA。当前仅对于磁盘存储单元有效。
- -group storage_unit_group
存储单元组的名称。bpsturep 将在此存储单元组中添加或删除其成员。使用 -addstu storage_unit 可在组中添加存储单元。使用 -delstu storage_unit 可从组中删除存储单元。
- -host host_name
注意:
NetBackup 服务器不支持远程介质服务器。
目标介质挂接到的 NetBackup 主机。默认为本地系统的主机名。
选择的主机必须是 NetBackup 主服务器或介质服务器(如果配置的是介质服务器)。主机名必须是所有 NetBackup 服务器和客户端都知道的服务器的网络名。
如果 host_name 是有效的网络名,并且尚未配置它,则 host_name 值将作为介质服务器添加到 NetBackup 的配置中。在 UNIX 系统上,该值显示在 bp.conf 中;在 Windows 上,它显示在服务器的“配置”窗口中。如果 host_name 不是有效的网络名,则必须手动配置它。
- -hwm high_water_mark
此选项是用户可配置的阈值。高位标记的默认设置为 98%。在以下两种不同情况下,达到高位标记时,NetBackup 将主动采取措施:
- 在启动作业时,如果使用了所有容量,则认为 DSU 已满。如果它从存储单元组的多个存储单元中进行选择,则发生如下情况:介质和设备选择 (MDS) 不会向达到或超过高位标记的单元分配新作业。而是在组内查找其他存储单元以用于处理该作业。
- 在执行作业期间,如果设置了分段作业属性,并且使用了所有容量,那么分段作业将使映像失效以释放 DSU 上的空间。这样可以容纳更多的备份数据。
- -label storage_unit_label
存储单元的名称。bpsturep 命令将替换该存储单元的属性。必须指定此选项。存储单元标签的最大长度是 128 个字符。
- -lwm low_water_mark
此选项是用户可配置的阈值,由执行磁盘分段作业操作的磁盘存储单元使用。低位标记的默认设置为 80%。
达到高位标记时,应该执行以下操作之一:
- 将映像迁移到其他存储单元,直到达到“低位标记”为止。
- 使最早的分段映像的磁盘映像失效以释放磁盘空间,直到达到“低位标记”为止。
注意:
如要保存大部分可用数据,请将低位标记配置为与高位标记相近。此外,低位标记必须小于高位标记。它们不能设置为相同的值。
- -mfs max_fragment_size
指定的最大片段大小(以 MB 为单位),即 NetBackup 映像的片段可以有多大。NetBackup 支持的最大片段大小约为 1,000,000 MB (1 TB)。
对于介质管理器存储单元,该值为零。或者是大于或等于 50 MB、且小于或等于 1,048,576 MB/(1024 GB) 的任意整数。默认值为 0,即允许的最大值 1024 GB。
对于磁盘存储单元,该值的范围为 20 MB 到 2000 MB (2 GB)。默认值是 524288 (512 GB)。
- -maxmpx mpx_factor
最多复用路数系数。多路复用操作从一个或几个客户端向单个驱动器发送多个并行备份。
有关多路复用 (MPX) 的更多信息,请参见《NetBackup 管理指南,第 I 卷》。
多路复用因子的范围从 1 到 32,一 (1) 表示不多路复用。如果值大于一 (1),则表示 NetBackup 可以在目标介质上创建多路复用映像。由于本地 NetBackup 安装的授权方式,您可能无法分配整个 1-32 范围内的多路复用系数。默认值为 1。
- -M master_server [,...]
指定主服务器的列表。这是一个以逗号分隔的主机名列表。如果包含该选项,将在该列表中的每一台主服务器上运行该命令。主服务器必须允许发出该命令的系统对其进行访问。如果任何主服务器发生错误,将在列表中的该主服务器位置处停止处理。默认为输入该命令的系统的主服务器。
- -nh NDMP_attach_host
指定 NDMP 服务器的主机名。如果包含此选项,则将存储单元类型设置为 NDMP。默认为无 NDMP 服务器。
- -nodevhost
表明将没有与此存储单元关联的介质服务器。
- -odo on_demand_only_flag
on-demand-only 标志控制是否仅将存储单元用于显式请求它的备份:
要使存储单元仅对请求它的策略或日程表可用,请将该标志设置为 1(启用)。
要使存储单元对任何策略或日程表都可用,请将该标志设置为 0(禁用)。
如果存储单元的类型是“磁盘”,则默认值为 1;仅当有显式请求时,NetBackup 才使用该存储单元。否则,默认值是 0。
- -okrt ok_on_root
如果没有设置此标志,则不会在根文件系统上创建备份或目录。如果设置了 ok_on_root 标志,则通常会创建备份和目录。
此标志的默认值为 0。如果路径位于根文件系统上,则不会为磁盘存储单元 (BasicDisk) 创建备份和目录。
在 UNIX 系统上,根目录是 "/"。
在 Windows 上,根目录是 windows\system 目录所在的卷。
- -path path_name
磁盘文件系统的路径,用绝对路径名表示,这是存储单元的数据存储区域。如果包含此选项,则存储单元类型是 Disk。此选项没有默认值。只能独立使用 -density、-path 和 -dp 选项。
一般情况下,在使用此选项时,将启用 on-demand-only 标志(请参见 -odo)。否则,如果存在不要求特定存储单元的 NetBackup 策略,则这些策略可写入磁盘文件系统 path_name。这可能会导致严重的系统问题。例如,如果系统交换区恰好在此文件系统上,则新进程可能会失败。
如果将路径名定义为磁盘分段作业存储单元 (DSSU),则可以使用此选项将路径名更改为另一个 DSSU。不能使用该选项将 DSSU 更改为另一种类型的存储单元。
- -rn robot_number
此存储单元的机械手编号。机械手编号必须大于或等于 0,可从管理控制台的“介质和设备管理”中获取。除非包含 -rt 选项,否则将忽略该选项。此选项没有默认值。
有关机械手编号的使用规则的更多信息,请参见《NetBackup 管理指南,第 II 卷》。
- -rt robot_type
此存储单元的机械手类型。对于非机械手(独立)设备,请选择 NONE 或者忽略该选项。默认值是 NONE(非机械手)。密度值应该与机械手类型保持一致。
如果将该选项设置为 NONE 以外的任何值,则必须同时使用 -rn 选项。
可用的机械手类型代码包括:
NONE - 非机械手
TLD - DLT 磁带库
ACS - 自动盒式系统
- -sm selection_method
选择存储单元组的选择方法。此选项仅对存储单元组有效。下面是它的可能值:
按优先级排列 = 1(默认)最近最少选择的 = 2 故障转移 = 3
Load Balance = 4(如果安装了容量管理许可证,则显示该选项)
选项 1:“按优先级排列”是默认条件。它选择列表中的第一个存储单元,直到该单元发生故障、已满或达到其最多并行作业数设置为止。然后,查看列表中的下一个存储单元,直到找到可用的存储单元为止。
选项 2:“最近最少选择的”将选择最近最少选择的存储单元。
选项 3:“故障转移”与“按优先级排列”类似,但是当第一个存储单元达到最多并行作业数时,MDS 会对作业排队,以等待第一个存储单元。仅当第一个存储单元发生故障或已满时,MDS 才使用列表中的下一个存储单元。
选项 4:负载平衡。您必须已安装容量管理许可证,才会显示此选项。如果用户选择此选项,介质设备选择 (MDS) 根据介质服务器是否满足下列条件来平衡作业负载:
有足够的磁盘卷可用空间来容纳估计的作业大小。
有足够的 CPU 和内存资源来容纳另一个作业。
与同类或同级别的其他介质服务器相比,正在处理的估计作业大小数据量最少。
如果许可证失效,则负载平衡恢复为“选项 2”行为。该选项将选择最近最少选择的存储单元。
- -tt transfer_throttle
仅为 SnapVault 存储单元显示“传输限制”设置。
此设置指示 SnapVault 的最大数据传输带宽。如果此设置为零(默认值),则表示对带宽没有限制,并且数据传输时使用全部的网络带宽。(范围:0(默认)至 9999999。)
- -uw 1|0
此选项用于将存储单元定义为一写多读 (WORM)。如果设置此选项,则写入到存储单元的映像将实施 WORM 锁定。此选项的默认值为 0。将 -uw 设置为 1(定义 WORM 的存储单元)后,该操作不可逆。必须先删除该存储单元,然后使用 -uw 0 重新创建它。
- -verbose
为日志记录选择 verbose 模式。仅在调试日志功能处于启用状态(即定义了以下目录)的情况下运行,该模式才有意义:
UNIX 系统:
/usr/openv/netbackup/logs/admin
Windows 系统:
install_path\NetBackup\logs\admin
示例
UNIX 系统:
更改磁盘存储单元 mkbunit 的路径。路径由 /tmp/mkbunit
更改为 /tmp/mkbunit2
:
# bpstulist mkbunit 0 beaver 0 -1 -1 1 0 /tmp/mkbunit 1 1 2000 *NULL* # bpsturep -label mkbunit -path /tmp/mkbunit2 # bpstulist mkbunit 0 beaver 0 -1 -1 1 0 /tmp/mkbunit2 1 1 2000 *NULL*
Windows 系统:
更改磁盘存储单元 mkbunit 的路径。路径由 C:\tmp\mkbunit 更改为 C:\tmp\mkbunit2:
# bpstulist mkbunit 0 beaver 0 -1 -1 1 0 C:\tmp\mkbunit 1 1 2000 *NULL* # bpsturep -label mkbunit -path C:\tmp\mkbunit2 # bpstulist mkbunit 0 beaver 0 -1 -1 1 0 C:\tmp\mkbunit2/ 1 1 2000 *NULL*
文件
UNIX 系统:
/usr/openv/netbackup/logs/admin/*
Windows 系统:
install_path\NetBackup\logs\admin\*
EMM 数据库