lsrcrelationship

使用 lsrcrelationship 命令可返回对系统可视的远程拷贝关系(如高速镜像、全局镜像或主动/主动关系)的简明列表或详细视图。

语法

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

参数

-filtervalueattribute=value
(可选)指定一个或多个过滤器的列表。 仅返回值与过滤器属性值匹配的对象。 如果指定了容量,那么还必须包含单位。
Note: 某些过滤器允许您在输入命令时使用通配符。 使用 Lenovo Storage V7000CLI 时,应该遵循以下规则来使用通配符:
  • 通配符为星号 (*)。
  • 命令最多可包含一个通配符,并且该通配符必须是字符串中的第一个或最后一个字符。
  • 使用通配符时,必须用双引号 (" ") 将过滤器条目括起来,如下所示:
    lsrcrelationship -filtervalue  "name=md*"
-nohdr
(可选)缺省情况下,将在简明样式视图中显示每个数据列的标题,在详细样式视图中显示每个数据项的标题。 -nohdr 参数用于禁止显示这些标题。
Note: 如果没有要显示的数据,那么即便指定了 -nohdr 参数,也不会显示标题。
-delimdelimiter
(可选)缺省情况下,简明视图中的所有数据列都以空格分隔。 每列的宽度设置为每个数据项的最大宽度。 在详细视图中,每个数据项各占一行,如果显示标题,将用空格来分隔数据与标题。 -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 参数的属性

描述

该命令返回对系统可视的远程拷贝关系(如高速镜像、全局镜像或主动/主动关系)的简明列表或详细视图。

下表提供了对于在输出视图中显示为数据的属性适用的可能值。
Table 1. lsrcrelationship 命令属性和值
属性
primary 指示主关系。 值为 masteraux
state 指示关系状态。 值包括:
  • consistent_copying
  • inconsistent_stopped
  • inconsistent_copying
  • consistent_stopped
  • consistent_synchronized
  • idling
  • idling_disconnected
  • inconsistent_disconnected
  • consistent_disconnected
progress 指示关系进度。 该值必须是 0 - 100 之间的整数。
cycle_period_seconds 指示多个循环间的最短周期(以秒计)。 该值必须是 60 - 86400 之间的整数。 缺省值为 300。
cycling_mode 指示要使用的全局镜像、高速镜像或主动/主动循环类型。 值为 nonemulti
copy_type 指示拷贝类型。 值包括:
  • metro
  • global
  • activeactive
  • 空白
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 循环。
  • change_volumes_needed,指示 卷中的主动/主动关系或者具有变更卷关系的全局镜像。 另外,至少未配置一个变更卷。
    Important: 复制服务是不可用的。
sync 指示是否同步关系。 值为 in_syncout_of_sync
master_change_vdisk_name 指示充当关系主变更卷的卷的名称(如果未定义,那么为空白)。
Note: 该字段用于标识主卷的变更卷(如果已配置)。 对于系统间关系,如果主卷位于其他系统中,那么主变更卷也位于该系统中。
aux_change_vdisk_id 指示充当关系辅助变更卷的卷的标识(如果未定义,那么为空白)。
Note: 该字段标识辅助卷的变更卷(如果已配置此类卷)。 对于系统间关系,如果辅助卷位于其他系统中,那么辅助变更卷也位于该其他系统中。
aux_change_vdisk_name 指示充当关系辅助变更卷的卷的名称(如果未定义,那么为空白)。
Note: 该字段用于标识辅助卷的变更卷(如果已配置)。 对于系统间关系,如果辅助卷位于其他系统中,那么辅助变更卷也位于该其他系统中。
bg_copy_priority 未使用。
Note: 如果全局镜像、高速镜像或主动/主动关系或一致性组是系统间的,并且系统伙伴关系已断开连接,那么这些关系和一致性组的名称可为空白。
如果没有为以下任一类型的关系定义主变更卷或辅助变更卷,那么将设置 change_volumes_needed 状态:
  • 拷贝类型设置为 active-active
  • 拷贝类型设置为 global,且 cycling_mode 设置为 multi

当内容在卷之间已同步(完全相同)时,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:activeactive
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