NetBackup™ 命令参考指南

此选项已弃用。Cohesity 建议您改用 -sts_operation CapacityPolling -polling_priority priority 选项。

设置首选列表中介质服务器的优先级。如果该介质服务器是排除列表的一部分，则此选项会将其从排除列表中删除，并将该介质服务器包括在首选列表中。如果多个磁盘活动介质服务器具有相同的优先级，则优先选择具有最新 NetBackup 版本的介质服务器。

为还原或复制操作删除指定存储服务器或指定磁盘池的属性。它与 -changests 和 -changedp 选项一起使用。可以在命令行上指定多个 -clearattribute 属性。有关 -setattribute 使用的属性列表和 -ch angests 使用的属性列表，请参考 -changedp 描述。

为磁盘池添加注释。如果注释包含空格，则需要使用引号 (" ")。

要获取 Amazon 云存储区域支持，请指定要在其中创建桶的区域。以下是几个示例。有关完整列表，请参考 Amazon 文档：

如果 region-url 字符串与表示法不完全匹配，将在“美国标准”区域创建桶。如果省略该选项，将在“美国标准区”域创建桶。

捕获配置参数信息，并将其发送到指定的文件或相应的磁盘池。

删除指定的存储服务器。

指定 nbdevconfig 预览、清点或创建的磁盘池的名称。磁盘池名称不能超过 256 个字符。

磁盘卷的名称。

对于云存储，每个供应商允许的字符可能会有所不同。此外，用于卷的术语也可能会有所不同（例如，Amazon 使用“桶”描述卷）。请参阅您的云供应商文档以了解命名约定。

包含磁盘卷列表的文件名。指定一个仅用于云磁盘池和介质服务器重复数据删除池的卷。

将命令输出限制为不能属于指定目标保留类型（快照、主要、独立、镜像、同步复制源或同步复制目标）的磁盘卷。

要排除多个标志，请多次列出 -exclude 选项（例如，-exclude primary -exclude ReplicationTarget）。

此选项已弃用。Cohesity 建议您改用 -sts_operation CapacityPolling -exclude_from_polling 选项。

从首选列表中排除该介质服务器并将容量轮询优先级重置为 0。如果该介质服务器是包括列表的一部分，则此选项会将其从包括列表中删除。

使用 -exclude_from_polling 从首选列表中排除介质服务器，并将容量轮询优先级重置为 0。此操作禁止介质服务器与指定的 -sts_operation 一起使用。必须将此选项与 -sts_operation 选项一起使用。如果该介质服务器是包括列表的一部分，则此选项会将其从包括列表中删除。

如果环境中唯一的磁盘活动介质服务器设置为 -exclude_from_polling，则存储服务器作业可用性和自动映像同步复制导入会受到负面影响。

当删除具有关联的 AIR 目标生命周期策略的磁盘池出错时，强制删除该磁盘池。此选项仅可以与 -deletedp 操作一起使用。

认为存储（磁盘卷）已满时所使用的容量的百分比。不能向此卷分配新作业，因为这会触发暂存失效操作。

将命令输出限制为能属于指定目标保留类型（快照、主要、独立、镜像、同步复制源或同步复制目标）的磁盘卷。

要包括多个标志，请多次列出该修饰符（例如，-include Snapshot -include ReplicationTarget）。

将列表类型设为短格式输出。它将产生可分析的原始输出，所有字段均位于一行且没有标题。第一个字段指定输出版本，这可作为脚本操作的帮助。

暂存和失效操作耗尽磁盘池中的所有卷（达到高位标记）时使用的容量百分比。

主服务器的名称。

将磁盘池中每个卷允许的作业数限制为指定数目 n。此数目是读取备份映像的作业数和写入备份映像的作业数的总和。达到该限制时，NetBackup 将选择其他可用卷执行写入操作。如果没有其他卷可用，则 NetBackup 将一直对作业进行排队，直到某个卷变为可用。影响最佳流数目的因素包括磁盘速度、CPU 速度和内存量。

BasicDisk 不支持此参数。NetBackup 不限制 BasicDisk 存储单元的流数目。

执行操作的介质服务器。

取消所有 stdout 消息，包括成功的确认输出，如 "Disk pool disk_pool_name was successfully inventoried."

使用 -polling_priority 设置首选列表中介质服务器的优先级。具有更高 -polling_priority 值的介质服务器将优先使用。如果该介质服务器是排除列表的一部分，则此选项会将其从排除列表中删除，并将该介质服务器包括在首选列表中。必须将此选项与 -sts_operation option 一起使用。

如果多个磁盘活动介质服务器具有相同的优先级，则优先选择具有最新 NetBackup 版本的介质服务器。如果不使用此选项，则存储服务器中所有使用凭据的介质服务器的 -polling_priority 都为零。使用 -exclude_from_polling 选项可完全禁止选择介质服务器进行轮询。

指示您执行此命令操作的原因。您输入的原因文本字符串将被捕获并显示在审核报告中。将该字符串用双引号 ("...") 引起来，并且不能超过 512 个字符。该字符串不能以短划线字符 (-) 开头，也不能包含单引号 (')。

将属性应用于还原或复制操作的读取端存储服务器或数据池。它与 -changests 和 -changedp 选项一起使用。这些属性帮助您管理还原通信和复制通信。可以在命令行上指定多个 -setattribute attribute。

下列属性与存储服务器结合使用：

OpenStorage               : managed as OpenStorage storage server
DiskGroups                : aware of disk pools /
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

下列属性与数据池结合使用：

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

以下是与还原和复制操作相关的属性的其他描述：

使用的存储类型：

1 - 已格式化磁盘（默认）或 2 - 原始磁盘

4 - 直接挂接或 8 - 网络挂接（默认）

这两个值要加在一起。例如，storage_type 为 10 表示网络挂接 (8) 的原始磁盘 (2)。

选择磁盘池或磁盘卷的状态。指定 UP 以启动磁盘池或磁盘卷，指定 DOWN 以关闭磁盘池或磁盘卷。

用于创建磁盘池的存储服务器名称的列表。请使用空格分隔此列表中的各项，不要使用逗号。

指定存储服务器操作（已为其指定可用介质服务器）。-deleteprefmedia 和 -setstsprefmedia 选项使用 -sts_operation 选项。有效的操作值包括：CapacityPolling 或 EventPolling。

如果已指定 CapacityPolling，则表示只能为磁盘卷容量轮询指定首选介质服务器。如果指定 CapacityPolling，将会更新磁盘卷容量轮询的行为，以使用具有更高首选值的未排除的磁盘活动介质服务器。

如果指定 EventPolling，将会更新自动导入同步复制导入事件轮询的行为，以使用具有更高首选值的未排除的磁盘活动介质服务器。

使用 -polling_priority 设置首选列表中介质服务器的优先级。有关其他详细信息，请参见 -polling_priority 选项。

使用 -exclude_from_polling 选项从首选列表中排除介质服务器。有关其他详细信息，请参见 -exclude_from_polling 选项。

指定标识存储服务器类型的字符串。server_type 值可能源自以下来源之一：

存储服务器类型区分大小写。

使用用户可读的带格式列表列出配置属性，每个属性占一行，超出列表的更多属性以原始输出模式 (-l) 列出。请参见“示例 1”。