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 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.
- volume_id | volume_name
- (Required) Specifies the volume that the volume copy is to be
removed from.
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.
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