rmvolumecopy

Use the rmvolumecopy command to remove a volume copy from a volume. You can use this command for high availability configurations that include HyperSwap® or stretched systems.

Syntax

This syntax diagram specifies a volume copy by site.


>>- rmvolumecopy -- -- -site --+- site_id ---+-- --------------->
                               '- site_name -'      

>--+-----------------+-- --+-----------------+-- --------------->
   '- -removefcmaps -'     '- -discardimage -'      

>--+----------+--+- volume_id ---+-----------------------------><
   '- -force -'  '- volume_name -'

This syntax diagram specifies a volume copy by copy ID or storage pool. You must specify either -copy or -pool.


>>- rmvolumecopy -- --+--------------------+-- ----------------->
                      '- -copy -- copy_id -'      

>--+----------------------------------+-- ---------------------->
   '- -pool --+- storage_pool_id ---+-'      
              '- storage_pool_name -'        

>--+-----------------+-- --+-----------------+-- --------------->
   '- -removefcmaps -'     '- -discardimage -'      

>--+----------+-- --+- volume_id ---+--------------------------><
   '- -force -'     '- volume_name -'

Parameters

-site site_id | site_name: (Required) Specifies the site that the volume copy is removed from. You cannot specify this parameter if you specify -copy or -pool.
-pool storage_pool_id | storage_pool_name: (Optional) Specifies the storage pool that the volume copy is removed from.
-copy copy_id: (Optional) Specifies the copy ID for the volume copy to be deleted. The value is 0 or 1. This keyword cannot be specified whether -site is specified.
Important: If the volume has copies in multiple sites you must specify -pool to identify the volume copy to remove.
-removefcmaps: (Optional) Allows a volume copy to be deleted even if it is part of a FlashCopy® mapping.
Important: Use this parameter for HyperSwap volumes.
-discardimage: (Optional) Allows a volume copy to be deleted even if data on an image mode copy cannot be made consistent.
Important: Using this parameter might result in data loss. Use it only under the direction of your product support information, or if you are willing to accept the risk of data loss on the volume.
-force: Deletes the specified volume copy whether a cloud system backup or restore operation is in progress. If you do not specify this parameter a volume or volume copy cannot be deleted while a backup operation is in progress. Additionally, a volume containing image mode copies cannot be deleted while a restore operation is in progress (if the volume contains inconsistent data).
Important: Using this parameter might result in data loss. Use it only under the direction of your product support information, or if you are willing to accept the risk of data loss on the volume.
volume_id | volume_name: (Required) Specifies the volume ID or name for the volume copy to remove. The value for volume ID must be a number and the value for volume name must be an alphanumeric string.

Description

Use the rmvolumecopy command to remove a copy of a volume.

For a HyperSwap volume, the active-active relationship and the change volumes are also deleted.

Remember: HyperSwap volumes that are part of a consistency group must be removed from that consistency group before you can remove the last volume copy from that site.

This command fails if a backup operation is in progress.

An invocation example to remove a volume copy at site 1 on a HyperSwap system

rmvolumecopy -site 1 0

The detailed resulting output:

No feedback

An invocation example to remove a volume copy when there are two copies in the same storage pool.

rmvolumecopy -pool 5 -copy 1 volume5

The detailed resulting output:

No feedback

An invocation example to remove a volume copy with FlashCopy mappings.

rmvolumecopy -site 1 -removefcmaps 1

The detailed resulting output:

No feedback