将卷添加到一致性组

使用 cg_add_vol 命令可将卷添加到一致性组。

cg_add_vol cg=cgName vol=VolName

参数

名称 类型 描述 必需
cg 对象名 一致性组的名称。 Y
vol 对象名 要添加的卷的名称。 Y

此命令会将卷添加到一致性组。 一致性组最多可以包含 128 个卷。

成功完成命令的需求:

  • 卷和一致性组与同一个池关联。
  • 卷不是一致性组的一部分。
  • 卷不是快照。
  • 一致性组尚不具有最大卷数(见上)。

将镜像卷添加到非镜像一致性组:

  • 此类添加始终会成功,卷将保留其镜像设置。

对镜像一致性组成功完成命令的需求:

  • 仅在主一致性组上发出该命令。
  • 在初始化卷或一致性组期间不能运行该命令。
  • 卷没有任何未完成的特别同步作业。
  • 必须对卷执行镜像,并且以下镜像设置必须与一致性组的相同:镜像类型(例如,同步)、镜像状态、镜像目标、目标池和名称。
  • 此外,对于定义为 sync_best_effort(同步)的镜像一致性组:
    • 必须同步卷和一致性组的同步状态。
  • 对于定义为 async_interval(异步)的镜像一致性组:
    • 卷和一致性组必须具有以下相同的设置和值:调度、远程调度、最后复制的快照的时间戳记。
    • 卷和一致性组的同步状态必须为 RPO_OK
  • 链路必须启动。

将镜像卷添加到镜像卷和一致性组还会将卷的同级添加到卷和一致性组的同级。 添加后,镜像卷将设置镜像卷和一致性组的 RPO。

镜像一致性组具有一致性组内所有相关镜像卷的一个同步作业。

如果在镜像主一致性组上发出命令 cg_add_vol,未收到从属一致性组的应答直至命令超时或者由于意外故障而未收到应答,将返回 MIRROR_POSSIBLE_CONS_GROUP_MEMBERSHIP_MISMATCH 完成代码。该完成代码指示镜像一致性组同级的成员列表可能不同。

示例:

cg_add_vol cg=DBGroup vol=DBLog

输出:

Command completed successfully.

访问控制

用户类别 许可权
存储管理员 允许
存储集成管理员 允许
应用程序管理员 不允许
安全性管理员 不允许
只读用户 不允许
技术人员 不允许

警告

  • CONS_GROUP_MIRROR_DESIGNATION_MISMATCH

    卷在镜像或 HyperSwap 关系中的角色与一致性组角色不同。确定要将卷添加到该一致性组吗?

返回码

  • VOLUME_BAD_NAME

    卷名称不存在。

  • CONS_GROUP_BAD_NAME

    一致性组名不存在。

  • CONS_GROUP_IS_SLAVE

    一致性组在镜像关系中的角色为辅助一致性组。

  • MAX_VOLUMES_IN_CONS_GROUP_REACHED

    一致性组包含所允许的最大卷数。

  • MAX_VOLUMES_IN_REMOTE_CONS_GROUP_REACHED

    远程一致性组包含所允许的最大卷数。

  • MIRROR_HAS_SYNC_JOB

    不允许在具有活动同步作业的镜像上进行此操作。

  • MIRROR_IS_NOT_SYNCHRONIZED

    镜像未同步。

  • MIRROR_LAST_SYNC_TIMES_DIFFER

    所有镜像都必须具有相同的上次同步时间。

  • MIRROR_RETRY_OPERATION

    在此镜像中正在进行某项操作。

    故障诊断:请在几秒钟后再试一次该命令。

  • REMOTE_VOLUME_BAD_POOL

    远程卷和远程一致性组属于不同的存储池。

  • REMOTE_VOLUME_BELONGS_TO_CONS_GROUP

    远程卷属于一致性组。

  • TARGET_NOT_CONNECTED

    当前没有到目标系统的连接。

  • VOLUME_BAD_POOL

    卷属于其他存储池。

  • VOLUME_BELONGS_TO_CG

    卷属于一致性组。

  • VOLUME_DATA_MIGRATION_UNSYNCHRONIZED

    到该卷的数据迁移尚未完成。

  • VOLUME_IS_SNAPSHOT

    不允许对快照执行此操作。

  • CONS_GROUP_MIRROR_SCHEDULE_MISMATCH

    镜像一致性组中的所有卷都必须具有相同的镜像调度。

  • CONS_GROUP_MIRROR_TARGET_MISMATCH

    镜像一致性组中的所有卷都必须具有相同的镜像目标。

  • CONS_GROUP_MIRROR_ROLE_MISMATCH

    镜像一致性组中的所有卷都必须具有相同的镜像角色。

  • CONS_GROUP_MIRROR_ACTIVATION_MISMATCH

    镜像一致性组中的所有卷都必须具有相同的镜像激活状态。

  • HA_HIGH_AVAILABILITY_DISABLED_IN_VOL

    一致性组的高可用性已启用,但卷的高可用性已禁用。

  • HA_HIGH_AVAILABILITY_ENABLED_IN_VOL

    一致性组的高可用性已禁用,但卷的高可用性已启用。

  • CONS_GROUP_HA_ROLE_MISMATCH

    HyperSwap 一致性组中的所有卷都必须具有相同的镜像角色。

  • HA_LAST_SYNC_TIMES_DIFFER

    一致性组中的所有 HyperSwap 关系都必须具有相同的上次同步时间。

  • HA_POSSIBLE_CONS_GROUP_MEMBERSHIP_MISMATCH

    HyperSwap 一致性组可能在主机器和辅助机器上包含不同的卷。

  • CONS_GROUP_HA_ACTIVATION_MISMATCH

    HyperSwap 一致性组中的所有卷都必须具有相同的 HyperSwap 激活状态。

  • CONS_GROUP_HA_TARGET_MISMATCH

    镜像一致性组中的所有卷都必须具有相同的 HyperSwap 目标。

  • HA_RETRY_OPERATION

    正在对该 HyperSwap 关系执行某操作。

    故障诊断:请在数秒后重试发出此命令。

  • HA_IS_NOT_SYNCHRONIZED

    HyperSwap 关系未同步。

  • REMOTE_CONS_GROUP_MIRROR_SCHEDULE_MISMATCH

    远程机器上的镜像一致性组中的所有卷都必须具有相同的镜像调度。

  • CONS_GROUP_MIRROR_TYPE_MISMATCH

    镜像一致性组中的所有卷都必须具有相同的镜像类型。

  • MIRROR_POSSIBLE_CONS_GROUP_MEMBERSHIP_MISMATCH

    镜像一致性组在主机器和辅助机器上包含不同的卷。 每当发出了 cg_add_vol 命令但是主机器未收到辅助机器的应答直至命令超时或发生任何其他意外故障时,就会出现此问题。

  • REMOTE_CONS_GROUP_CRASH_CONSISTENCY_MISMATCH

    卷的崩溃一致性与远程机器上组中的其他卷的状态不匹配。

  • CONS_GROUP_CRASH_CONSISTENCY_MISMATCH

    卷的崩溃一致性与组中其他卷的状态不匹配。

  • OPERATION_DENIED_OBJECT_MANAGED

    这是一个受管对象。 只有管理软件和 xiv_maintenance/xiv_development 才可以对此对象执行此操作。

  • VOLUME_HAS_OLVM

    已为该卷定义了 IBM Hyper-Scale Mobility 关系。

  • VOLUME_HAS_MULTIPLE_MIRRORS

    卷具有多个镜像。不允许执行此操作,或者必须指定目标。

  • REMOTE_MIRROR_IS_STANDBY

    远程镜像标记为“备用”。

  • DATA_REDUCTION_TIER_IS_OFFLINE

    数据降维层处于脱机状态,不允许执行此操作。

    故障诊断:请联系 IBM 支持人员