Moving consistency groups between storage pools or grouped pools

Use the cg_move command to move a consistency group, all its volumes, snapshots, and snapshot sets from one storage pool or grouped pool to another.

cg_move cg=cgName <pool=PoolName | gp=gpName> [ domain_adjust=<yes|no> ]

Parameters

Name Type Description Mandatory Default
cg Object name Name of the consistency group to move. Y N/A
pool Object name Name of the storage pool to which to move. N N/A
gp Object name Name of the grouped pool to which to move. N N/A
domain_
adjust
 Boolean Adjust domain resources. If 'domain_adjust' is set to true, the resources of the consistency group source domain and destination domain are adjusted to accommodate the consistency group being moved. N no

Requirements for successful command completion:

  • Sufficient space on the target pools.
  • If the CG is mirrored, it can only be moved to a pool that is not thin-provisioned.

Example: 

cg_move cg=DBGroup pool=DBPool

Output: 

Command completed successfully.

Access control

User Category Permission
Storage administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Operations administrator Disallowed
Host side accelerator client Disallowed

Return codes

  • CONS_GROUP_BAD_NAME

    Consistency group name does not exist.

  • POOL_DOES_NOT_EXIST

    Storage pool does not exist.

  • NOT_ENOUGH_SPACE

    No space to allocate volume.

  • NOT_ENOUGH_HARD_SPACE

    No space to allocate for volume's current usage.

  • NOT_ENOUGH_SNAPSHOT_SPACE

    Snapshot usage will exceed snapshot limit.

  • DOMAIN_MAX_VOLUMES_REACHED

    The domain exceeds the maximum allowed number of volumes.

  • MAX_VOLUMES_REACHED

    Maximum number of volumes already defined.

  • DOMAIN_MAX_CONS_GROUPS_REACHED

    The domain exceeds the maximum allowed number of consistency groups.

  • MAX_CONS_GROUPS_REACHED

    Maximum number of consistency groups already defined.

  • DOMAIN_MAX_MIRRORS_REACHED

    The domain exceeds the maximum allowed number of mirrors.

  • MAX_MIRRORS_REACHED

    Maximum number of mirrors already defined

  • DOMAIN_USED_TARGET_NOT_IN_DESTINATION

    A target that is used by mirror in the pool is not associated with the target domain.

  • DOMAIN_USED_SCHEDULE_NOT_IN_DESTINATION

    A schedule that is used by a mirror in the pool is not associated with the target domain.

  • MAPPED_HOSTS_NOT_IN_DESTINATION

    A host that is mapped to a volume in the pool is not associated with the target domain.

  • MAPPED_CLUSTERS_NOT_IN_DESTINATION

    A cluster that is mapped to a volume in the pool is not associated with the target domain.

  • OPERATION_DENIED_OBJECT_MANAGED

    This is a managed object. Only the managing software and xiv_maintenance / xiv_development may complete this operation on this object.

  • CONS_GROUP_REQUIRES_DESTINATION_POOL

    A destination pool must be entered.

  • GROUPED_POOL_DOES_NOT_EXIST

    Grouped pool does not exist.

  • CONS_GROUP_REQUIRES_DESTINATION_GROUPED_POOL

    A destination grouped pool must be entered.

  • CANNOT_MOVE_CONS_GROUP_TO_A_GP_WITH_NO_META_POOL

    Cannot move consistency group to a grouped pool with no meta pool.

  • BOUND_ALUS_NOT_IN_DESTINATION

    An ALU that is bound to a volume in the pool is not associated with the target domain.

  • MAX_DMS_REACHED

    Maximum number of remote volumes (mirror/migration) is already defined.

    Troubleshooting: Delete unnecessary data migration objects.

  • DOMAIN_MAX_DMS_REACHED

    The domain exceeds the maximum allowed number of data migrations.