addvolumecopy

使用 addvolumecopy 命令将拷贝添加到现有卷。在标准拓扑系统上,您可以使用此命令将镜像拷贝添加到现有卷。在延伸或 HyperSwap® 拓扑系统上,您可以使用此命令在辅助站点添加现有基本卷的拷贝,以将该卷转换为高可用性卷。

语法

阅读语法图跳过直观语法图 addvolumecopy -pool storage_pool_idstorage_pool_name  -iogrpiogroup_idiogroup_name-cachenonereadonlyreadwrite-imagemdisk_idmdisk_name-thin-compressed-deduplicated-buffersizebuffer_sizebuffer_percentage%-unitmbbkbgbtbpb-warningwarning_capacitywarning_percentage%-noautoexpand-grainsize3264128256-allowmismatchedscsiids volume_idvolume_name -inconsistentownershipgroup

参数

-pool storage_pool_id | storage_pool_name
(必需)指定要在其中创建新的卷拷贝的存储池。
切记: 对于 stretchedhyperswap 拓扑系统,存储池站点不得与现有卷拷贝站点相同。
-iogrp iogroup_id | iogroup_name
(可选)指定新的卷拷贝进行高速缓存所在的 I/O 组。
注: 仅当创建的是 HyperSwap 卷并且要求系统拓扑为 hyperswap 时,此参数才适用。
I/O 组与指定的存储池必须位于同一站点中。
-cache none | readonly | readwrite
(可选)指定卷拷贝的高速缓存选项。有效条目为:
  • readwrite 支持卷的高速缓存。
  • readonly 禁用写高速缓存,但是允许对卷进行读高速缓存。
  • none 禁用卷的高速缓存方式。
注: 仅当创建的是 HyperSwap 卷并且要求系统拓扑为 hyperswap 时,此参数才适用。
-image mdisk_id | mdisk_name
(可选)指定将以映像方式创建卷拷贝(在任何拓扑上),以及可以使用哪个当前未使用的 MDisk。
注: 对于 stretchedhyperswap 拓扑系统,MDisk 站点必须匹配存储池站点。如果存储池为空,那么 MDisk 站点必须为 12,并且 MDisk 站点不能与现有卷拷贝的站点相同。
-thin
(可选)指定将创建具有自动精简配置的卷拷贝。不能将此参数与 -compressed 一起指定。
注: 如果未指定 -thin-compressed 参数,那么系统会创建标准配置的卷拷贝。
-compressed
(可选)指定将创建压缩卷拷贝。不能将此参数与 -thin 一起指定。
-deduplicated
(可选)添加去重卷。如果指定 -deduplicated,那么还必须指定 -thin-compressed,因为该项仅适用于自动精简配置或压缩卷。
注: 数据去重工作仅针对数据降维存储池。如果常规存储池中没有压缩卷或卷拷贝,那么只能在 I/O 组中创建去重卷和卷拷贝。
-buffersize buffer_size | buffer_percentage%
(可选)指定卷尝试保留作为自动精简配置卷和压缩卷的缓冲区的池容量。必须随此参数指定 -thin-compressed
-warning warning_capacity | warning_percentage%
(可选)指定阈值,达到此阈值时将为卷拷贝生成警告错误日志。当自动精简配置型拷贝或压缩拷贝上的已用磁盘容量超过指定的阈值时,会生成警告。您可以通过使用 warning_capacity 指定大小来指定阈值,除非已指定 -unit 参数,否则缺省为 MB。
注: 您还可以指定 warning_percentage% 以使用卷大小百分比。如果未指定警告阈值,那么使用缺省值 80%。要禁用警告,请指定 0

必须随此参数指定 -thin-compressed

-unit b | kb | mb | gb | tb | pb
(可选)为 -buffersize-warning 参数指定数据单位。
-noautoexpand
(可选)指定写入卷拷贝时卷拷贝不会自动扩展,随着使用的容量增加,可用的缓冲区容量也增加。如果耗尽缓冲区容量,拷贝就会脱机。

可以通过指定 expandvdisksize -rsize 来增加缓冲区容量。必须随此参数指定 -thin-compressed。如果未指定此关键字,那么拷贝会在写入数据时自动扩展。

-grainsize 32 | 64 | 128 | 256
(可选)设置自动精简配置卷的颗粒大小 (KB)。如果在 FlashCopy® 映射中使用的是自动精简配置卷,请使用与映射颗粒大小相同的颗粒大小,以获取最佳性能。如果是将自动精简配置卷直接用于主机系统,请使用较小的颗粒大小。颗粒大小值必须为 3264128256 KB。缺省值为 256 KB。
-allowmismatchedscsiids
(可选)在创建 HyperSwap 卷时,此参数允许主卷在指定的访问 I/O 组中具有不同的 SCSI LUN 标识。
volume_id | volume_name
(必需)指定要添加卷拷贝的卷。
-inconsistentownershipgroup
(可选)如果指定,那么此标志允许对象处于所有权不一致状态。

描述

使用 addvolumecopy 命令将拷贝添加到现有卷。 新的卷拷贝与当前拷贝同步。

注: 如果在卷上启用了云备份,那么该卷不能具有不同存储池中的卷拷贝。

在某些节点类型上,可以在数据降维存储池中为 I/O 组创建压缩卷拷贝。在包含 V5030、V7000 或 SVC 节点类型的 I/O 组中,只能创建数据降维池中的压缩卷拷贝。您可以在任何节点类型上创建自动精简配置卷拷贝。卷还可以在数据降维存储池中具有标准配置的卷拷贝。

如果卷拷贝是在数据降维存储池中创建的,将不能指定 -buffersize。请指定 -thin-compressed 来启用自动精简配置或压缩。

在从数据降维存储池中创建自动精简配置或压缩卷拷贝时,不能指定 -noautoexpand

不能创建在数据降维存储池中为自动精简配置或压缩卷,且卷高速缓存方式为 nonereadonly 的卷拷贝。必须指定 chvdisk 以将卷高速缓存方式更改为 readwrite

不能为数据降维存储池中的自动精简配置或压缩卷拷贝指定 -warning

不能为数据降维存储池中的自动精简配置和压缩卷拷贝指定 -grainsize。该类型的卷拷贝以 8 KB 大小创建。

如果数据降维存储池脱机并需要恢复,那么将无法在该数据降维池中创建自动精简配置或压缩卷拷贝。如果恢复仍在进行中,那么必须等待恢复完成,且池为 online 状态。

在标准拓扑系统上,您可以使用此命令将镜像拷贝添加到现有卷。 在延伸或 HyperSwap拓扑系统上,您可以使用此命令在辅助站点添加现有基本卷的拷贝,以将该卷转换为高可用性卷。

不能在与现有卷拷贝相同的站点中创建卷拷贝。此命令会自动将高速缓存 I/O 组添加到卷的访问 I/O 组集。

注: HyperSwap 卷无法映射到 NVMe 主机。

在创建 HyperSwap 卷时,系统会尝试在所有访问 I/O 组中为主卷分配相同的 SCSI LUN 标识。如果相同的 SCSI LUN 标识并非在所有访问 I/O 组中都可用,那么该命令将失败。 使用 -allowmismatchedscsiids 参数可允许系统在访问 I/O 组中分配不同的 SCSI LUN 标识。将使用每个访问 I/O 组中可用的最小值。在所有访问 I/O 组中,此值可能会不同。确保主机支持此配置。

场景 1

如果 I/O 组包含:
  • 至少一个 8 GB 节点。
  • 数据降维池中至少一个自动精简配置卷或压缩卷。
  • 该 I/O 组的 FlashCopy 位图大小设置为超过 1.5 GB。
此命令因为可用资源不足而失败。

场景 2

当在数据降维池中创建自动精简配置卷或压缩卷时,池必须具有足够的容量以创建用于跟踪从主机的 SCSI 取消映射操作的更多卷。如果此容量不可用,那么此命令将失败。

场景 3

如果因为自动精简配置(空间不足或损坏)或进行自动精简配置的组件正在使池中的卷保持脱机而导致数据降维池中存在脱机自动精简配置卷或压缩卷,那么将无法在数据降维池中创建卷。

将卷拷贝添加到现有卷

addvolumecopy -pool 2 volume5

生成的详细输出:

No feedback

将自动精简配置卷拷贝添加到现有卷

addvolumecopy -pool site2pool1 -thin 0

生成的详细输出:

No feedback

添加标准配置的映像方式卷拷贝

addvolumecopy -image mdisk12 -pool 3 volume2

生成的详细输出:

No feedback

添加自动精简配置卷拷贝

addvolumecopy -pool paulgilbertl7 -thin thinvdisk3

生成的详细输出:

No feedback

添加去重卷拷贝的调用示例

addvolumecopy -pool datareductionpool10 -thin -deduplicated deduplicatedvolume6

生成的输出:

Vdisk [6] copy [1] successfully created