Use the chrcrelationship command to modify certain attributes of an
existing relationship, such as to add a relationship to a consistency group, to remove a
relationship from a consistency group, and to change the name of the relationship. You can only
change one attribute at a time.
Syntax
chrcrelationship { { -masterchange [ { master_change_vdisk_id | master_change_vdisk_name } ] } | { -auxchange [ { aux_change_vdisk_id | aux_change_vdisk_name } ] } | -nomasterchange | -noauxchange | -name new_name_arg | { -consistgrp { consist_group_id | consist_group_name } } | -noconsistgrp | -cycleperiodseconds period | { -cyclingmode { none | multi } } } [ { -global | -metro } ] { rc_rel_id | rc_rel_name }
Parameters
- -masterchangemaster_change_vdisk_id | master_change_vdisk_name
- (Optional) Specifies a change volume association for the master volume in the relationship.
- -auxchangeaux_change_vdisk_id | aux_change_vdisk_name
- (Optional) Specifies a change volume association for the auxiliary volume in the relationship.
- -nomasterchange
- (Optional) Specifies a defined change volume on the master volume should be removed from the relationship.
Note: To use this parameter the specified change volume must no longer be in use by the relationship, including change volumes of a running relationship (
inconsistent_copying,
consistent_copying, or
consistent_synchronized).
This does not include a primary change volume of a stopped relationship. A secondary change volume of a relationship stopped from consistent_copying is considered in use if the change volume is supplying the consistent image. If this change volume needs to be removed, the relationships must first be stopped using the -access parameter in order to apply the consistent image to the secondary volume.
- -noauxchange
- (Optional) Specifies a defined change volume on the auxiliary volume should be removed from the relationship.
Note: To use this parameter the specified change volume must no longer be in use by the relationship, including change volumes of a running relationship (
inconsistent_copying,
consistent_copying, or
consistent_synchronized).
This does not include a primary change volume of a stopped relationship. A secondary change volume of a relationship stopped from consistent_copying is considered in use if the change volume is supplying the consistent image. If this change volume needs to be removed, the relationships must first be stopped using the -access parameter in order to apply the consistent image to the secondary volume.
- -namenew_name_arg
- (Optional) Specifies a new label to assign to the relationship.
- -consistgrpconsist_group_id
| consist_group_name
- (Optional) Specifies a new consistency group to assign the relationship to. Only
relationships of the same copy type (Global Mirror, Metro Mirror, or active-active)
can be assigned to the same consistency group.
- -noconsistgrp
- (Optional) Removes the specified relationship from a consistency
group, making the relationship a standalone relationship.
- -cycleperiodsecondsperiod
- (Optional) Specifies the cycle period in seconds.
The minimum cycle period value is 60 seconds. The default is 300 seconds
(5 minutes).
- This defines an optional cycle period that applies
to Global Mirror relationships with a cycling mode of multi. A Global
Mirror relationship using the multicycling_mode performs
a complete cycle at most once each period.
- -cyclingmodenone | multi
- (Optional) Specifies the behavior of Global Mirror for this relationship.
- Specifying none, the default, gives identical behavior to Global Mirror in previous versions of Lenovo Storage V series.
- Specifying multi uses the cycling protocol.
To start a relationship with cycling_mode set to multi, change volumes must be defined for the relationship. Note: The cycling_mode can only be changed when the relationship is stopped and in consistent_stopped or inconsistent_stopped status.
- -metro
- (Optional) Specifies the change in the relationship's copy type and converts a Global Mirror
(with or without change volumes) relationship to a Metro Mirror relationship.
Remember: To use this parameter the relationship must be stopped
(inconsistent_stopped, consistent_stopped, or
idling)
- -global
- (Optional) Specifies the change in the relationship's copy type and converts a Metro Mirror
relationship to a Global Mirror relationship. This parameter is not mutually-exclusive with
-cyclingmode. If you do not specify -cyclingmode and the
relationship is Metro Mirror, the cycling_mode value is
none.
Remember: To use this parameter the
relationship must be stopped (inconsistent_stopped,
consistent_stopped, or idling)
- rc_rel_name | rc_rel_id
- (Required) Specifies the ID or name of the relationship.
Description
This command modifies the specified attributes of the
supplied
relationship, one attribute at a time. In
addition to changing the name of a consistency group, this command
can be used for the following purposes.
Remember: - All parameters are mutually-exclusive with the exception of the
-cyclingmode, which is mutually-exclusive with all parameters but
-global.
- One of the optional parameters must be specified.
Note: You cannot set cycling mode to
multi-cycling mode if the primary and secondary volumes are different sizes.
- You can add a stand-alone relationship to a consistency group by specifying the
-consistgrp parameter and the name or ID of the consistency group. The
relationship and consistency group must be connected when the command is issued and must share the
following components:
- Master system
- Auxiliary system
- State (unless the group is empty)
- Primary (unless the group is empty)
- Type (unless the group is empty)
- Cycling mode (unless the group is empty)
When the first relationship is added to an empty group, the group takes on the same state,
primary (copy direction), type (Metro Mirror or Global Mirror), and cycling mode as the
relationship. Subsequent relationships must have the same state, copy direction, and type as the
group in order to be added to it. A relationship can only belong to one consistency group.
- You can remove a relationship from a consistency group by specifying the
-noconsistgrp parameter and the name or ID of the relationship. Although you do
not have to specify or confirm the name of the consistency group, verify which group the
relationship belongs to before you issue this command.
This form of the modify relationship
command succeeds in the connected or disconnected states. If the systems are disconnected the
relationship is only removed from the consistency group on the local system, at the time the command
is issued. When the systems are reconnected the relationship is automatically removed from the
consistency group on the other system. Alternatively, you can issue an explicit modify
(
chrcrelationship) command to remove the relationship from the group on the other
system while it is still disconnected.
Note: If you remove all relationships from the group, the
relationship type is reset to empty_group. When you add a relationship
to the empty group, the group again takes on the same type as the relationship.
- To move a relationship between two consistency groups, you must
issue the chrcrelationship command twice. Use
the -noconsistgrp parameter to remove the relationship
from its current group, and then use the -consistgrp parameter
with the name of the new consistency group.
You can change a relationship or consistency group between copy types
even if replication is stopped. Consistency protection is preserved across all types, so a
relationship or consistency group that is in consistent_copying state before being
stopped retains the consistent copy on the secondary system when the copying type is changed.
If you add a consistent_stopped relationship that
uses consistency protection to a consistent_stopped consistency group that is not
using consistency protection, the system attempts to trigger consistency protection on the
consistency group that is not currently using consistency protection. If the relationship or
consistency group that is not currently using consistency protection does not have secondary change
volumes that are defined, specifying chrcrelationship -consistgrp fails. If you add
a relationship to a consistency group where at least one is using consistency protection, the
resulting consistency group is not mutually consistent, which means that the data on the secondary
system for the relationship being added is inconsistent with the data on the consistency group. This
also means that enabling access to the volume fails.
For intersystem relationships
- The -name, -consistgrp, -cycleperiodseconds and -cyclingmode parameters
can only be specified when the two systems are connected. If the two
systems become disconnected while the command is being processed,
then the command might be completed with the change having been performed
at the system that received the task invocation only (and the other
system is updated upon re-connection). The -cycleperiodseconds and -cyclingmode parameters
can only be specified on stand-alone relationships (not members of
a consistency group).
- The -masterchange and -nomasterchange parameters
can only be specified when running the chrcrelationship command
on the master system for the relationship, and the -auxchange and -noauxchange parameters
can only be specified when running the chrcrelationship command
on the auxiliary system for the relationship.
Remember: You cannot specify a master and auxiliary change volume in the same command.
A change volume must be:
- Used by the relationship that owns it
- In the same I/O group as the associated master or auxiliary volume
- The same size as the associated master or auxiliary volume
A change volume is owned and used by the associated Remote Copy relationship. Consequently, it cannot be:
- Mapped to a host
- Used as source or target of any FlashCopy maps
- Part of any other relationship
- A filesystem disk
Assigning a change volume to a relationship requires new FlashCopy mappings to be created between the master or auxiliary volume and the associated change volume. Consequently, there must be sufficient unallocated FlashCopy memory in the target I/O group or the command fails.
If the cycle_period_seconds for
the relationship does not match that of the consistency group it is
added to, the newly-added relationship copies the cycle_period_seconds value
from the group. If later removed from the group, the copied cycle_period_seconds value
remains.
When a Global Mirror relationship with a cycling_mode value of multi is added to a group that is not empty, both the group and the relationship must be stopped.
For relationships
that are
active-active, you cannot change the copy
type, cycling mode, or the change volumes. This means you cannot specify
these parameters:
- -global
- -metro
- -cyclingmode
- -nomasterchange
- -noauxchange
Remember: For a volume to be configured as a change
volume for an active-active relationship, the volume
must have the same site name and site ID as the master and auxiliary
volume it is being associated with.
An invocation example to change a relationship name
from rccopy1 to testrel
chrcrelationship -name testrel rccopy1
The
resulting output:
No feedback
An invocation example to add relationship rccopy2 to
group newgroup
chrcrelationship -consistgrp newgroup rccopy2
The
resulting output:
No feedback
An invocation example to remove relationship rccopy3 from
whichever consistency group it is a member of
chrcrelationship -noconsistgrp rccopy3
The
resulting output:
No feedback
An invocation example
chrcrelationship -cyclingmode multi relB
The resulting output:
No feedback
An invocation example
chrcrelationship -cycleperiodseconds 20 relC
The resulting output:
No feedback