lsrcrelationship

使用 lsrcrelationship 命令可返回对集群系统(系统)可视的高速镜像或全局镜像关系的简明列表或详细视图。

语法

阅读语法图跳过直观语法图
>>- lsrcrelationship -- ---------------------------------------->

>--+-----------------------------------+-- --+----------+-- ---->
   '- -filtervalue -- attribute=value -'     '- -nohdr -'      

>--+-----------------------+-- -- --+-----------------+--------->
   '- -delim -- delimiter -'        '- -filtervalue? -'   

>--+---------------+-------------------------------------------><
   +- object_id ---+   
   '- object_name -'   

参数

-filtervalue attribute=value
(可选)指定一个或多个过滤器的列表。仅返回值与过滤器属性值匹配的对象。 如果指定了容量,那么还必须包含单位。
注: 某些过滤器允许您在输入命令时使用通配符。以下规则适用于将通配符用于 Storwize® V3700 CLI 的情况:
  • 通配符为星号 (*)。
  • 命令最多可包含一个通配符,并且该通配符必须是字符串中的第一个或最后一个字符。
  • 使用通配符时,必须将过滤器条目用双引号 ("") 引起来,如下所示:
    lsrcrelationship -filtervalue  "name=md*"
-nohdr
(可选)缺省情况下,将在简明样式视图中显示每个数据列的标题,在详细样式视图中显示每个数据项的标题。-nohdr 参数用于禁止显示这些标题。
注: 如果没有要显示的数据,那么即便指定了 -nohdr 参数,也不会显示标题。
-delim delimiter
(可选)缺省情况下,简明视图中的所有数据列都以空格分隔。每列的宽度设置为每个数据项可能的最大宽度。在详细视图中,每个数据项各占一行,如果显示标题,将用空格来分隔数据与标题。-delim 参数会覆盖此行为。-delim 参数的有效输入为一个单字节字符。如果在命令行中输入 -delim :,那么在简明视图中将用冒号字符 (:) 分隔所有数据项;例如,不会出现列间距。在详细视图中,数据与标题间以指定的定界符分隔。
object_id | object_name
(可选)指定对象的名称或标识。使用此参数时,将返回特定对象的详细视图,而忽略 -filtervalue 参数指定的所有值。如果未指定 object_id | object_name 参数,那么将显示与 -filtervalue 参数指定的过滤要求相符的所有对象的简明视图。
-filtervalue?
(可选)指定您希望报告显示有效过滤器属性列表的任何部分或全部。lsrcrelationship 命令的有效过滤器属性如下:
  • 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

有关过滤属性的更多信息,请参阅-filtervalue 参数的属性

描述

此命令返回对系统可视的高速镜像或全局镜像关系的简明列表或详细视图。

表 1 提供了在输出视图中显示为数据的属性的可能值。
表 1. lsrcrelationship 命令属性和值
属性
primary n/a、masteraux
state consistent_copyinginconsistent_stoppedinconsistent_copyingconsistent_stoppedconsistent_synchronizedidlingidling_disconnectedinconsistent_disconnectedconsistent_disconnected
progress 介于 0100 之间的整数,或 n/a
cycle_period_seconds 多个循环之间的最小时间段(以秒为单位,介于 6086400 之间的整数;缺省值为 300)。
cycling_mode 要使用的全局镜像或高速镜像循环的类型。 选项包括:
  • none(缺省值)
  • multi
copy_type 拷贝类型:
  • 高速
  • 全局
  • 空白
freeze time 采用 YY/MM/DD/HH/MM 格式的时间
status 值包括:
  • online,指示关系联机且可访问。如果关系状态是 ConsistentSynchronizedConsistentCopyingInconsistentCopying,那么卷将复制主卷收到的主机 I/O 操作。
  • primary_offline,指示关系中的主卷已脱机。这会阻止其他 I/O 操作且暂停同步,直到主卷再次联机为止。
  • secondary_offline,指示关系中的辅助卷已脱机。对于 ConsistentSynchronized 状态(无变更卷)的全局镜像关系和高速镜像关系,针对主卷的其他 I/O 写操作将终止关系。
  • io_channel_offline,指示远程系统不可访问。对于 ConsistentSynchronized 状态(无变更卷)的全局镜像关系和高速镜像关系,针对主卷的其他 I/O 写操作将终止关系。
  • primary_change_offline,指示关系中的主变更卷已脱机。对于具有变更卷关系的全局镜像,当前 I/O 循环将结束,当主变更卷再次联机时,开始新的 I/O 循环。
  • secondary_change_offline,指示关系中的辅助变更卷已脱机。对于具有变更卷关系的全局镜像,当前 I/O 循环将暂停,当辅助卷再次联机时,恢复新的 I/O 循环。
sync n/a、in_syncout_of_sync
master_change_vdisk_id 充当关系主变更卷的卷的标识(如果未定义,那么为空白)
注: 该字段用于标识主卷的变更卷(如果已配置)。 对于系统间关系,如果主卷位于其他集群系统(系统)中,那么主变更卷也位于该其他系统中。
master_change_vdisk_name 充当关系主变更卷的卷的名称(如果未定义,那么为空白)
注: 该字段用于标识主卷的变更卷(如果已配置)。 对于系统间关系,如果主卷位于其他集群系统(系统)中,那么主变更卷也位于该其他系统中。
aux_change_vdisk_id 充当关系辅助变更卷的卷的标识(如果未定义,那么为空白)
注: 该字段标识辅助卷的变更卷(如果已配置此卷)。对于系统间关系,如果辅助卷位于其他系统中,那么辅助变更卷也位于该其他系统中。
aux_change_vdisk_name 充当关系辅助变更卷的卷名称(如果未定义,那么为空白)
注: 该字段用于标识辅助卷的变更卷(如果已配置)。 对于系统间关系,如果辅助卷位于其他系统中,那么辅助变更卷也位于该其他系统中。
bg_copy_priority 未使用。
注: 如果全局镜像或高速镜像关系或一致性组是系统间的,并且系统伙伴关系已断开连接,那么这些关系和一致性组的名称可为空白。

当内容在卷之间已同步(完全相同)时,sync 属性的值为 in_sync。如果在出现一致(已停止)或空闲状态后,对主卷或辅助卷执行写操作,那么主卷或辅助卷将不再同步。

简明和详细调用示例

lsrcrelationship -delim : -filtervalue name=j*

生成的简明和详细输出:

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

详细调用示例

lsrcrelationship -delim : AB_2

生成的详细输出:

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
copy_type:metro
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