Skip to main content
Sign Out

Welcome to Dell

My Account
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Enjoy members-only rewards and discounts
  • Create and access a list of your products
  • Manage your Dell EMC sites, products, and product-level contacts using Company Administration.
Sign In Create an Account Dell Financial Services Premier Sign In Partner Program Sign In
Contact Us

Your Dell.com Carts

Dell EMC Metro node 7.1 CLI Guide

PDF

consistency-group add-virtual-volumes

Adds one or more virtual volume to a consistency group.

Contexts

All contexts.

In /clusters/cluster-n/consistency-groups/group-name context, command is add-virtual-volumes

Syntax

consistency-group add-virtual-volumes


[-v|--virtual-volumes] virtual-volume, virtual-volume, ...

[-g|--consistency-group] consistency-group

Arguments

Required arguments
[-v|--virtual-volumes] virtual-volume,virtual-volume,... * List of one or more comma-separated glob patterns or context paths of the virtual volume to add.
[-g|--consistency-group] consistency-group * Context path of the consistency group to which to add the specified virtual volume. If the current context is a consistency-group or below, then that consistency group is the default. Otherwise, this argument is required.

* - argument is positional.

Description

Adds the specified virtual volume to a consistency group. The properties of the consistency group immediately apply to the added volume.

NOTE Only volumes with visibility and storage-at-cluster properties which match those of the consistency group can be added to the consistency group.

Additionally, you cannot add a virtual volume to a consistency group if the initialization status of the virtual volume is failed or in-progress.

Maximum # of volumes in a consistency group: 1000

All volumes used by the same application and/or same host should be grouped together in a consistency group.

If any of the specified volumes are already in the consistency group, the command skips those volumes, but prints a warning message for each one.

Examples

Add multiple volumes using a single command. Separate virtual volume by commas:

In the following example:

  • The cd command changes the context to the target consistency group.
  • The consistency-group list-eligible-virtual-volumes command displays virtual volumes that are eligible to be added to the consistency group.
  • The consistency-group add-virtual-volumes command adds the specified virtual volume to the consistency group.
  • The ls command in displays the change: 
VPlexcli:/> cd /clusters/cluster-1/consistency-groups/TestCG
VPlexcli:/clusters/cluster-1/consistency-groups/TestCG> consistency-group list-eligible-virtual-volumes
[TestDDevice-1_vol, TestDDevice-2_vol, TestDDevice-3_vol, TestDDevice-4_vol, TestDDevice-5_vol]
VPlexcli:/clusters/cluster-2/consistency-groups/TestCG> add-virtual-volumes --virtual-volumes TestDDevice-2_vol 
VPlexcli:/clusters/cluster-1/consistency-groups/TestCG> add-virtual-volumes TestDDevice-1_vol,TestDDevice-2_vol
VPlexcli:/clusters/cluster-1/consistency-groups/TestCG> ll
Attributes:
Name                 Value
-------------------  ----------------------------------------------------------
active-clusters      []
cache-mode           synchronous
detach-rule          active-cluster-wins
operational-status   [(cluster-1,{ summary:: ok, details:: [] }), (cluster-2,{
                     summary:: ok, details:: [] })]
passive-clusters     [cluster-1, cluster-2]
read-only            false
storage-at-clusters  [cluster-1, cluster-2]
virtual-volumes      [TestDDevice-1_vol, TestDDevice-2_vol]
visibility           [cluster-1, cluster-2]
Contexts:
Name          Description
------------  -----------
advanced      -

See also

  • consistency-group create
  • consistency-group list-eligible-virtual-volumes
  • consistency-group remove-virtual-volumes
  • Dell EMC Administration Guide for metro node

Rate this content

Accurate
Useful
Easy to understand
Was this article helpful?
0/3000 characters
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please select whether the article was helpful or not.
  Comments cannot contain these special characters: <>()\