lsrcrelationship

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

语法

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

参数

-filtervalueattribute=value

（可选）指定一个或多个过滤器的列表。仅返回值与过滤器属性值匹配的对象。如果指定了容量，那么还必须包含单位。

Note: 某些过滤器允许您在输入命令时使用通配符。以下规则适用于将通配符用于 Lenovo Storage V7000 CLI 的情况：

通配符为星号 (*)。
命令最多可包含一个通配符，并且该通配符必须是字符串中的第一个或最后一个字符。
使用通配符时，必须用双引号 (" ") 将过滤器条目括起来，如下所示：
```
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 参数的属性。

描述

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

lsrcrelationship 命令属性和值提供了在输出视图中显示为数据的属性的可能值。

Table 1. lsrcrelationship 命令属性和值
属性	值
primary	指示主关系。值为 `master` 和 `aux`。
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	指示要使用的全局镜像、高速镜像或`主动/主动`循环类型。值为 `none` 和 `multi`。
copy_type	指示拷贝类型。值包括： `metro` `global` `activeactive` 空白
freeze time	指示 `YY/MM/DD/HH/MM` 格式的时间
status	指示状态。值包括： `online` 指示关系联机且可访问。如果关系状态是 `ConsistentSynchronized`、`ConsistentCopying` 或 `InconsistentCopying`，那么卷将复制主卷收到的主机 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`，指示 HyperSwap 卷中的`主动/主动`关系或者具有变更卷关系的全局镜像。另外，至少未配置一个变更卷。 Important: 复制服务是不可用的。
sync	指示是否同步关系。值为 `in_sync` 或 `out_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:activeactivecycle_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