Veritas NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
名称
nbdevconfig — 预览、导入、创建或清点磁盘池
大纲
-adddv -stype server_type [-dp disk_pool_name [-dv disk_volume_name]] [-M master_server]
-changedp [-noverbose] -stype server_lifecycle_type -dp disk_pool_name [-add_storage_servers storage_server...] | [-del_storage_servers storage_server...] [-hwm high_watermark_percent] [-lwm low_watermark_percent] [-max_io_streams n] [-comment comment] [-setattribute attribute] [-clearattribute attribute] [-M master_server] [-reason "string"]
-changestate [-noverbose] -stype server_type -dp disk_pool_name [-dv disk_volume_name] -state [UP | DOWN | RESET] [-M master_server] [-reason "string"]
-changests [-noverbose] -storage_server storage_server -stype server_type [-setattribute attribute] [-clearattribute attribute] [-reason "string"]
-createdp [-noverbose] -dp disk_pool_name -stype server_type -storage_servers storage_server... [-hwm high_watermark_percent] [-lwm low_watermark_percent] [-max_io_streams n] [-comment comment] [-dvlist filename] [-M master_server] [-reason "string"]
-createdv -stype server_type -dv disk_volume_name [-dp disk_pool_name] [-storage_server storage_server_name] [-config region:region-url] [-M master_server]
-creatests [-noverbose] -storage_server storage_server_name -stype server_type -media_server media_server [-st storage_type] [-setattribute attribute] [-reason "string"]
-deletedp [-noverbose] stype service_type -dp disk_pool_name [-M master_server] [-force_targetslp_removal] [-reason "string"]
-deletedv [-noverbose] -dp disk_pool_name -stype server_type -dv disk_volume_name [-M master_server] [-reason "string"]
-deletests [-noverbose] -storage_server storage_server -stype server_type [-reason "string"]
-getconfig [-l | -U] stype service_type -storage_server storage_server [-configlist filename]
-help operation
-importenclr [-noverbose] -enclosure enclosure_name -storage_servers storage_server... [-hwm high_watermark_percent] [-lwm low_watermark_percent] [-comment comment] [-M master_server]
-inventorydp [-preview | -noverbose] -stype server_type -dp disk_pool_name [-media_server media_server] [-M master_server]
-mergedps [-noverbose] -stype service_type -primarydp disk_pool_name_1 -secondarydp disk_pool_name_2 [-M master_server] [-reason "string"]
-previewdv -storage_server storage_server -stype server_type [-media_server media_server] [-dv disk_volume_name] [-dp disk_pool_name] [-dvlist file_name] [-M master_server] [-replication source | target | both] [[-include Primary | ReplicationSource | ReplicationTarget | Snapshot | Independent | Mirror]...] [[-exclude Primary | ReplicationSource | ReplicationTarget | Snapshot | Independent | Mirror]...]
-previewenclr [-l|-U] -enclosure enclosure_name | -storage_server storage_server... [-M master_server]
-setconfig -stype service_type -storage_server storage_server [-configlist filename] [-reason "string"]
-updatedp [-noverbose] -stype server_type -dp disk_pool_name [-M master_server] [-reason "string"]
-updatedv [-noverbose] -stype server_type [-dp disk_pool_name] -dv disk_volume_name [-media_server media_server] [-M master_server]
-updatests [-noverbose] -storage_server storage_server -stype server_type -media_server media_server [-reason "string"]
在 UNIX 系统上,此命令的目录路径为 /usr/openv/netbackup/bin/admincmd/
在 Windows 系统上,此命令的目录路径为 install_path\NetBackup\bin\admincmd\
描述
nbdevconfig 命令执行下列操作:
-adddv 将新磁盘卷添加到现有的磁盘池。添加的磁盘卷的属性和标志必须与磁盘池相同。例如,不能将镜像卷添加到非镜像磁盘池。通过使用 nbdevquery -preview 选项收集文件 (-dvlist) 上要添加到磁盘池的相似卷,可以添加多个卷。
-changedp 更改磁盘池的指定属性。指定磁盘池名称选项 (-dp) 和存储服务器类型 (-stype) 以唯一地标识磁盘池。
-changestate 更改磁盘池或磁盘卷的状态。如果指定了 -dv,则再指定 -changestate 可以更改磁盘池的指定磁盘卷。否则将更改磁盘池自身的状态。状态值可以是 UP、DOWN 或 RESET。
-changests 更改存储服务器。
-createdp 从磁盘卷的指定列表中创建磁盘池。可以指定高位标记和注释等附加属性。磁盘池名称不能超过 256 个字符。
-createdv 创建在您创建磁盘池后可指定的磁盘卷(-dvlist 选项)。通常,将此选项用于以下对象:NetBackup 无法发现的 AdvancedDisk 卷(如 CIFS 卷,其对 Windows 服务不可见)以及美国标准以外的 Amazon 云存储区域中的桶
-creatests 创建存储服务器。存储服务器名称不能超过 128 个字符,且不能包含冒号 (:) 字符。
-deletedp 从 NetBackup 设备数据库中删除指定磁盘池。运行此选项前,请使所有的映像失效并将其删除。
-deletedv 从指定的磁盘池中删除指定的磁盘卷。卷上不能存在备份映像片段。卷上不能有活动的备份作业。磁盘卷和磁盘池的状态必须为“关闭”。
-deletests 删除指定的存储服务器。
-getconfig 检索磁盘池属性的默认配置参数。
-help operation 指定需要其使用信息的操作(-changestate、-deletedp 等)。
-importenclr 从指定的扩展柜中创建磁盘池。还可以指定高位标记和注释等附加属性。
-inventorydp 发现磁盘池中的新存储或发生更改的存储,并接受这些更改。存储更改包括新建卷、更改卷大小和新建 LUN。如果只希望查看磁盘池更改的详细信息而不接受它们,可以使用 -preview 选项。
-mergedps 合并指定的主磁盘池和辅助磁盘池。Disk_pool_name_2 合并到 disk_pool_name_1 中,仅保留 disk_pool_name_1。合并指定的主磁盘池和辅助磁盘池。
-previewdv 预览要进行的清单更改,但是不执行清单更新。
-previewenclr 列出任何磁盘池使用或可能使用的所有扩展柜(磁盘阵列)的详细信息。
-setconfig 设置磁盘池的配置参数。
-updatedp 使用来自存储服务器的新值更新磁盘池复制属性。如果存储管理员更改了存储服务器上磁盘卷的复制属性,则将发生以下情况:此命令强制 NetBackup 更新磁盘池属性以反映存储配置。
-updatedv 更新池中的一个或多个磁盘卷的属性。
-updatests 更新指定存储服务器的属性。
vmupdate 命令检测磁带库中是否添加了新磁带或删除了磁带。同样,nbdevconfig 的清点和预览选项可以检测存储管理员是否已经更改了磁盘池的组成。清点可以检测是否添加了新卷、调整了现有卷(添加更多空间)或者删除了卷。清点操作还可以接受新的空间。(例如,它可以在出现新磁盘卷时更新 NetBackup 数据库,或者从新的空间配置新卷)。
选项
下面是对每个 nbdevconfig 选项的描述。
- -clearattribute attribute
为还原或复制操作删除指定存储服务器或指定磁盘池的属性。它仅与 -changests 和 -changedp 选项一起使用。可以在命令行上指定多个 -clearattribute 属性。有关 -changests 使用的属性列表和 -changedp 使用的属性列表,请参考 -setattribute 描述。
- -comment comment
为磁盘池添加注释。如果注释包含空格,则需要使用引号 (" ")。
- -config region:region-url
要获取 Amazon 云存储区域支持,请指定要在其中创建桶的区域。以下是几个示例。有关完整列表,请参考 Amazon 文档:
ap-northeast-1
亚太地区(东京)
ap-southeast-1
亚太地区(新加坡)
ap-southeast-2
亚太地区(悉尼)
eu-west-1
欧盟(爱尔兰)
sa-east-1
南美洲(圣保罗)
us-west-1
美国西部(北加州)
us-west-2
美国西部(俄勒冈)
如果 region-url 字符串与表示法不完全匹配,将在“美国标准”区域创建桶。如果省略该选项,将在“美国标准区”域创建桶。
注意:
对于 Amazon 虚拟私有云 (VPC),此选项为必填字段,但“美国标准”区域除外。如果省略该选项,则不创建桶且会遇到错误。
- -configlist filename
捕获配置参数信息,并将其发送到指定的文件或相应的磁盘池。
- -del_storage_servers storage_server...
删除指定的存储服务器。
- -dp disk_pool_name
指定 nbdevconfig 预览、清点或创建的磁盘池的名称。磁盘池名称不能超过 256 个字符。
- -dv disk_volume_name
磁盘卷的名称。
对于云存储,每个供应商允许使用的字符可能会有所不同。此外,用于卷的术语也可能会有所不同(例如,Amazon 使用“桶”描述卷)。请参阅您的云供应商文档以了解命名约定。
- -dvlist filename
包含磁盘卷列表的文件名。指定一个仅用于云磁盘池和介质服务器重复数据删除池的卷。
- -enclosure enclosure_name
扩展柜的唯一名称。与 previewenclr 选项一起使用时,可以显示有关扩展柜的详细信息。仅当在主服务器上安装了供应商 CLI 并且其名称位于磁盘阵列的主机映射中时,才可以成功运行此选项。
与 importenclr 选项一起使用时,可以从指定的扩展柜创建磁盘池。
- -exclude [Snapshot | Primary | Independent | ReplicationSource | ReplicationTarget | Mirror]
将命令输出限制为不能属于指定目标保留类型(快照、主要、独立、镜像、复制源或复制目标)的磁盘卷。
要排除多个标志,请多次列出 -exclude 选项(例如,-exclude primary -exclude ReplicationTarget)。
- -force_targetslp_removal
当删除具有关联的 AIR 目标生命周期策略的磁盘池出错时,强制删除该磁盘池。此选项仅可以与 -deletedp 操作一起使用。
- -hwm high_watermark_percent
认为存储(磁盘卷)已满时所使用的容量的百分比。不能向此卷分配新作业,因为这会触发分段失效操作。
- -include [Snapshot | Primary | Independent | ReplicationSource | ReplicationTarget | Mirror]
将命令输出限制为能属于指定目标保留类型(快照、主要、独立、镜像、复制源或复制目标)的磁盘卷。
要包括多个标志,请多次列出该修饰符(例如,-include Snapshot -include ReplicationTarget)。
- -l
将列表类型设为短格式输出。它将产生可分析的原始输出,所有字段均位于一行且没有标题。第一个字段指定输出版本,这可作为脚本操作的帮助。
- -lwm low_watermark_percent
分段和失效操作耗尽磁盘池中的所有卷(达到高位标记)时使用的容量百分比。
- -M master_server
主服务器的名称。
- -max_io_streams n
将磁盘池中每个卷允许的作业数限制为指定数目 n。此数目是读取备份映像的作业数和写入备份映像的作业数的总和。达到该限制时,NetBackup 将选择其他可用卷执行写入操作。如果没有其他卷可用,则 NetBackup 将一直对作业进行排队,直到某个卷变为可用。影响最佳流数目的因素包括磁盘速度、CPU 速度和内存量。
BasicDisk 不支持此参数。NetBackup 不限制 BasicDisk 存储单元的流数目。
- -media_server media_server
执行操作的介质服务器。
- -noverbose
取消所有 stdout 消息,包括成功的确认输出,例如 "Disk pool disk_pool_name was successfullyinventoried."
- -reason "string"
指示您执行此命令操作的原因。您输入的原因文本字符串将被捕获并显示在审核报告中。将该字符串用双引号 ("...") 引起来,并且不能超过 512 个字符。该字符串不能以短划线字符 (-) 开头,也不能包含单引号 (')。
- -setattribute attribute
将属性应用于还原或复制操作的读取端存储服务器或数据池。它仅与 -changests 和 -changedp 选项一起使用。这些属性帮助您管理还原通信和复制通信。可以在命令行上指定多个 -setattribute attribute。
下列属性与存储服务器结合使用:
OpenStorage : managed as OpenStorage storage server DiskGroups : aware of disk pools / enclosures ActiveDiskGroups : allow active management of disk groups ActiveServers : allow active management of storage srvrs RovingVolumes : active mount/unmounts for disk volumes CopyExtents : allow optimized duplication AdminUp/Down : administrative state is UP/DOWN InternalUp/Down : internal state is UP/DOWN SpanImages : allow images to span disk volumes BasicStaging : allow basic image staging LifeCycle : allow image life cycle management CapacityMgmt : allow capacity management FragmentImages : allow image fragmentation CatalogBackup : allow catalog backups Cpr : allow checkpoint / restart RandomWrites : allow random write access FT-Transfer : allow access through FT channel PrefRestore : preferred use for restores ReqRestore : required use for restores ReqDuplicate : required use for duplications CapacityManagedRetention : allow capacity managed retention CapacityManagedJobQueuing : allow capacity managed job queuing OptimizedImage : allow virtual image construction MetaData : describe client data during backup QueueOnDown : queue jobs when server status is down
下列属性与数据池结合使用:
Patchwork : associated with enclosure Visible : visible and managed through UI OpenStorage : managed as OpenStorage disk pool RovingVolumes : active mount/unmounts for disk volumes SingleStorageServer : limited to single storage server CopyExtents : allow optimized duplication AdminUp/Down : administrative state is UP/DOWN InternalUp/Down : internal state is UP/DOWN SpanImages : allow images to span disk volumes BasicStaging : allow basic image staging LifeCycle : allow image life cycle management CapacityMgmt : allow capacity management FragmentImages : allow image fragmentation CatalogBackup : allow catalog backups Cpr : allow checkpoint / restart RandomWrites : allow random write access FT-Transfer : allow access through FT channel CapacityManagedRetention : allow capacity managed retention CapacityManagedJobQueuing : allow capacity managed job queuing OptimizedImage : allow virtual image construction MetaData : describe client data during backup Snapshot : disk pool holds Snapshots Primary : disk pool is capable of Snapshots from sources mounted on a client ReplicationSource : disk pool can be a source for Image or Snapshot replication ReplicationTarget : disk pool can be a target for Image or Snapshot replication Mirror : this replication target disk pool can use a mirrored replication method Independent : this replication target can use a non- mirrored replication method
以下是与还原和复制操作相关的属性的其他描述:
PrefRestore。该存储服务器是还原操作读取端的首选服务器。可以有多个存储服务器具有 PrefRestore 属性。
将优先考虑使用标记为 PrefRestore 的存储服务器或数据池。如果没有这样的服务器可用,将考虑使用未标记的存储服务器。
普通的 NetBackup 负载平衡将在所有标记为 PrefRestore 的存储服务器之间进行。
ReqRestore。该存储服务器是还原操作读取端的必需服务器。可以有多个存储服务器具有 ReqRestore 属性。如果没有 ReqRestore 服务器可用,NetBackup 将考虑使用 PrefRestore 服务器。如果上述服务器均不可用,作业将一直排队,直到有 ReqRestore 或 PrefRestore 存储服务器可用。
如果配置 ReqRestore 服务器而不配置 PrefRestore 服务器,则永远也不会考虑将未标记的存储服务器用于还原作业。作业将一直排队,直到有 ReqRestore 存储服务器可用于执行作业。适用一般的 NetBackup 作业重试规则。
NetBackup 负载平衡通常在所有标记为 ReqRestore 的存储服务器之间进行。不会在 ReqRestore 存储服务器与 PrefRestore 存储服务器之间进行负载平衡。
ReqDuplicate。该存储服务器是复制操作读取端的必需服务器。可以有多个存储服务器具有 ReqDuplicate 属性。如果有存储服务器标记为 ReqDuplicate,则仅考虑使用标记为 ReqRestore 的存储服务器。如果 ReqRestore 服务器不可用,则作业将一直排队,直到 ReqRestore 服务器可用于执行作业。适用一般的 NetBackup 作业重试规则。
ReqDuplicate 还适用于存储服务器分配,以执行合成备份操作。
- -st storage_type
使用的存储类型:
1 - 已格式化磁盘(默认)或 2 - 原始磁盘
4 - 直接挂接或 8 - 网络挂接(默认)
这两个值要加在一起。例如,storage_type 为 10 表示网络挂接 (8) 的原始磁盘 (2)。
- -state UP | DOWN | RESET
选择磁盘池或磁盘卷的状态。指定 UP 以启动磁盘池或磁盘卷,指定 DOWN 以关闭磁盘池或磁盘卷。
RESET 选项执行以下操作:
将内部状态设置为 UP(适用于磁盘卷和磁盘池)
将 committed_space 设置为 ZERO(仅限磁盘卷)
将预提交的空间设置为 ZERO(仅限磁盘卷)
- -storage_server storage_server
单个存储服务器。其意义因与它一起使用的以下选项之一而异:
previewdv: -storage_server 将输出限制为连接至指定服务器的阵列。所有主机必须连接至磁盘卷内的所有存储 (LUN)。
creatests: -storage_server 标识存储服务器的主机名。存储服务器名称不能超过 128 个字符,且不能包含冒号 (:) 字符。
setconfig: -storage_server 标识您已设置了其配置参数的磁盘池所在的存储服务器。存储服务器名称不能超过 128 个字符。
- -storage_servers storage_servers...
用于创建磁盘池的存储服务器名称的列表。请使用空格分隔此列表中的各项,不要使用逗号。
- -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:将数据写入云存储之前压缩和加密数据。
Replication Director OpenStorage 合作伙伴。可能的值有 Network_NTAP、Network_NTAP_CDOT 或 EMC_Celerra。
存储服务器类型区分大小写。
- -U
使用用户可读的带格式列表列出配置属性,每个属性占一行,超出列表的更多属性以原始输出模式 (-l) 列出。请参见“示例 1”。
示例
示例 1 - 预览存储服务器看到的所有 扩展柜并以用户可读模式显示。
# nbdevconfig -previewenclr -U -storage_servers daloa -M daloa Preview of Enclosure imported_dp as Disk pool Disk Pool Name : imported_dp Disk Pool Id : imported_dp Disk Type : AdvancedDisk Availability : Free Raw Size (GB) : 1.20 Usable Size (GB) : 1.20 Num Volumes : 3 Storage Server : daloa.example.com
示例 2 - 删除磁盘池。首先使磁盘组中的所有映像失效。
# nbdevconfig -deletedp -dp Disk-Pool-2 Disk pool Disk-Pool-2 has been deleted successfully
示例 3 - 将
标记为“关闭”。# nbdevconfig -changestate -stype PureDisk -dp diskpool_alpha -state DOWN
示例 4 - 将磁盘卷标记为 UP。
# nbdevconfig -changestate -stype AdvancedDisk -dp diskpool_alpha -dv alpha_vol1 -state UP
示例 5 - 清点磁盘组。
# nbdevconfig -inventorydp -preview -stype AdvancedDisk -dp Disk-Pool-2 Old Raw Size (GB): 97.85 New Raw Size (GB): 103.45 Old Formatted Size (GB): 97.80 New Formatted Size (GB): 103.40 Old Host List: willow,Pear,dunamo New Host List: Dellco,carrot,Pear,dynamo Affected Storage Units ------------------------------ SSO-STU-7 - willow [...] would be removed from media server list SSO-STU-9 - willow [...] would be removed from media server list, \ switched to "any available" media server list. Affected Storage Units ------------------------------ SSO-STU-7 -willow [...] was removed from media server list SSO-STU-9 -willow [...] was removed from media server list, \ switched to "any available" media server list.