Use the rmvolumecopy command to remove a volume copy from a volume.
You can use this
command for high availability configurations that include HyperSwap.
Syntax
This syntax diagram specifies a volume copy by site.
rmvolumecopy -site { site_id | site_name } [ -removefcmaps ] [ -discardimage ] { volume_id | volume_name }
This syntax diagram specifies a volume copy by copy ID or storage pool. You
must specify either -copy or -pool.
rmvolumecopy [ -copycopy_id ] [ -pool { storage_pool_id | storage_pool_name } ] [ -removefcmaps ] [ -discardimage ] { volume_id | volume_name }
Parameters
- -sitesite_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.
- -poolstorage_pool_id | storage_pool_name
- (Optional) Specifies the storage pool that the volume copy is removed from.
- -copycopy_id
- (Optional) Specifies the copy ID for the volume copy to be deleted. The value is
0 or 1. This keyword cannot be specified when
-site is specified.
Important: If the volume has copies in
multiple sites you must specify -pool to identify the volume copy to
remove.
You must specify either -copy or
-pool.
- -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.
You must specify either -copy or
-pool.
- -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.
- 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