lsrcrelationship

Use the lsrcrelationship command to return a concise list or a detailed view of remote copy relationships such as Metro Mirror, Global Mirror, or active-active relationships visible to the system.

Syntax

 lsrcrelationship    [  -filtervalue  attribute=value  ]   [  -nohdr  ]   [  -delim  delimiter  ]     [  -filtervalue?  ] [ {  object_id  |  object_name  } ]

Parameters

-filtervalueattribute=value
(Optional) Specifies a list of one or more filters. Only objects with a value that matches the filter attribute value are returned. If a capacity is specified, the units must also be included.
Note: Some filters allow the use of a wildcard when you enter the command. The following rules apply to the use of wildcards with the Storwize V5000 CLI:
  • The wildcard character is an asterisk (*).
  • The command can contain a maximum of one wildcard, which must be the first or last character in the string.
  • When you use a wildcard, you must enclose the filter entry with double quotation marks (" "), as follows:
    lsrcrelationship -filtervalue  "name=md*"
-nohdr
(Optional) By default, headings are displayed for each column of data in a concise style view, and for each item of data in a detailed style view. The -nohdr parameter suppresses the display of these headings.
Note: If there is no data to be displayed, headings are not displayed even if the -nohdr parameter is specified.
-delimdelimiter
(Optional) By default in a concise view, all columns of data are space-separated. The width of each column is set to the maximum width of each item of data. In a detailed view, each item of data has its own row, and if the headers are displayed the data is separated from the header by a space. The -delim parameter overrides this behavior. Valid input for the -delim parameter is a 1-byte character. If you enter -delim : on the command line, the colon character (:) separates all items of data in a concise view; for example, the spacing of columns does not occur. In a detailed view, the data is separated from its header by the specified delimiter.
object_id | object_name
(Optional) Specifies the name or ID of an object. When you use this parameter, the detailed view of the specific object is returned and any value that is specified by the -filtervalue parameter is ignored. If you do not specify the object_id | object_name parameter, the concise view of all objects that match the filtering requirements that are specified by the -filtervalue parameter are displayed.
-filtervalue?
(Optional) Specifies that you want your report to display any or all of the list of valid filter attributes. The valid filter attributes for the lsrcrelationship command are:
  • RC_rel_id
  • RC_rel_name
  • master_system_id
  • master_system_name
  • master_vdisk_id
  • master_vdisk_name
  • aus_system_id
  • aux_system_name
  • aux_vdisk_id
  • aux_vdisk_name
  • primary
  • consistency_group_id
  • consistency_group_name
  • state
  • progress
  • copy_type

For more information about filtering attributes, see Attributes of the -filtervalue parameters.

Description

This command returns a concise list or a detailed view of remote copy relationships such as Metro Mirror, Global Mirror, or active-active relationships visible to the system.

lsrcrelationship command attributes and values provides possible values for the attributes that are displayed as data in the output views.
Table 1. lsrcrelationship command attributes and values
Attribute Value
primary Indicates a primary relationship. The values are master and aux.
state Indicates the relationship state. The values are:
  • consistent_copying
  • inconsistent_stopped
  • inconsistent_copying
  • consistent_stopped
  • consistent_synchronized
  • idling
  • idling_disconnected
  • inconsistent_disconnected
  • consistent_disconnected
progress Indicates the relationship progress. The value must be a number (integer) in the range 0 - 100.
cycle_period_seconds Indicates the minimum period in seconds between multiple cycles. The value must be a number (integer) in the range 60 - 86400. The default is 300).
cycling_mode Indicates the type of Global Mirror, Metro Mirroring, or active-active cycling to use. The values are none and multi.
copy_type Indicates the copy type. The values are
  • metro
  • global
  • activeactive
  • blank
freeze time Indicates the time in YY/MM/DD/HH/MM format
status Indicates the status. The values are:
  • online indicates that the relationship is online and accessible. If the relationship state is ConsistentSynchronized, ConsistentCopying, or InconsistentCopying the volumes replicate host I/O operations that the primary volume receives.
  • primary_offline indicates that the primary volume in the relationship is offline. This prevents more I/O operations, and synchronization pauses until the primary volume is online again.
  • secondary_offline indicates that the secondary volume in the relationship is offline. For Global Mirror relationships in a ConsistentSynchronized state (no change volumes) and Metro Mirror relationships, extra I/O write operations to the primary volume terminate the relationship.
  • io_channel_offline indicates that the remote system is not accessible. For Global Mirror relationships in a ConsistentSynchronized state (no change volumes) and Metro Mirror relationships, extra I/O write operations to the primary volume terminate the relationship.
  • primary_change_offline indicates that the primary change volume in the relationship is offline. For Global Mirror with change volume relationships, the current I/O cycle ends, and a new I/O cycle begins when the primary change volume is online again.
  • secondary_change_offline indicates that the secondary change volume in the relationship is offline. For Global Mirror with change volume relationships, the current I/O cycle pauses and a new I/O cycle resumes when the secondary volume is online again.
  • change_volumes_needed, indicates an active-active relationship that is in a HyperSwap volumes or Global Mirror with change volume relationships. Additionally, at least one change volume is not configured.
    Important: Replication services are not usable.
sync Indicates whether the relationship is synchronized. The value is in_sync or out_of_sync.
master_change_vdisk_name Indicates the name of the volume that is acting as the master change volume for the relationship (blank if not defined)
Note: This field identifies the change volume for the master volume if configured. For an intersystem relationship, if the master volume is in the other clustered system (system), the master change volume is also in the other system.
aux_change_vdisk_id Indicates the ID of the volume that is acting as the auxiliary change volume for the relationship (blank if not defined)
Note: This field identifies the change volume for the auxiliary volume, if such a volume is configured. For an intersystem relationship, if the auxiliary volume is in the other system, the auxiliary change volume is also in the other system.
aux_change_vdisk_name Indicates the name of the volume that is acting as the auxiliary change volume for the relationship (blank if not defined)
Note: This field identifies the change volume for the auxiliary volume if configured. For an intersystem relationship, if the auxiliary volume is in the other system, the auxiliary change volume is also in the other system.
bg_copy_priority Unused.
The change_volumes_needed status is set if either the master or auxiliary change volume is not defined for relationships with either of these types:
  • Copy type that is set to active-active
  • Copy type that is set to global and cycling_mode set to multi

The sync attribute has a value of in_sync when the contents are synchronized (identical) between volumes. If write operations take place on either the primary or secondary volume after a consistent (stopped) or idling state occurs, they will no longer be synchronized.

A concise invocation example

lsrcrelationship -delim : -filtervalue name=j*

The concise resulting output:

id:name:master_cluster_id:master_cluster_name:master_vdisk_id:master_vdisk_name:
aux_cluster_id:aux_cluster_name:aux_vdisk_id:
aux_vdisk_name:primary:consistency_group_id:consistency_group_name:state:bg_copy
_priority:progress:copy_type:cycling_mode:freeze_time
45:jrel_AB1:0000020061413ABA:clusterA:45:jdisk_B8:0000020060406746:clusterB:38:j
disk_B1:master:::consistent_stopped:50:metro:none:06/06/27/08/31/37
48:jrel_AB2:0000020061413ABA:clusterA:48:jdisk_A4:0000020060406746:clusterB:41:j
disk_B4:master:::consistent_synchronized:50:metro:none:06/06/27/09/31/37
49:jrel_BA_1:0000020060406746:clusterB:42:jdisk_B5:0000020061413ABA:clusterA:49:j
disk_A5:master:248:jdemo_BA_cons1:consistent_stopped:50:metro:none:06/06/27/10/31/37
50:jrel_BA_2:0000020060406746:clusterB:43:jdisk_B6:0000020061413ABA:clusterA:
50:jdisk_A6:master:248:jdemo_BA_cons1:consistent_stopped:50:metro:none:06/06/27/11/31/37

A detailed invocation example

lsrcrelationship -delim : AB_2

The detailed resulting output:

id:9
name:AB_2
master_cluster_id:0000020061413MOE
master_cluster_name:chelseaB
master_vdisk_id:9
master_vdisk_name:stripe9
aux_cluster_id:0000020061413MOE
aux_cluster_name:chelseaB
aux_vdisk_id:10
aux_vdisk_name:stripe9_b
cycle_period_seconds:300
cycling_mode:multi
primary:master
consistency_group_id:
consistency_group_name:
state:consistent_synchronized
bg_copy_priority:50
progress:
freeze_time:2006/05/05/08/26/46
status:online
sync:in_sync