lsrcrelationship
使用 lsrcrelationship 命令可返回对系统可视的远程拷贝关系(如高速镜像、全局镜像或主动/主动关系)的简明列表或详细视图。
语法
>>- lsrcrelationship -- ----------------------------------------> >--+-----------------------------------+-- --+----------+-- ----> '- -filtervalue -- attribute=value -' '- -nohdr -' >--+-----------------------+-- -- --+-----------------+---------> '- -delim -- delimiter -' '- -filtervalue? -' >--+---------------+------------------------------------------->< +- object_id ---+ '- object_name -'
参数
- -filtervalue attribute=value
- (可选)指定一个或多个过滤器的列表。仅返回值与过滤器属性值匹配的对象。 如果指定了容量,那么还必须包含单位。
- 注: 某些过滤器允许您在输入命令时使用通配符。以下规则适用于将通配符用于 SAN Volume Controller 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 提供了在输出视图中显示为数据的属性的可能值。
| 属性 | 值 |
|---|---|
| primary | 指示主关系。值为 master 和 aux。 |
| state | 指示关系状态。值包括:
|
| progress | 指示关系进度。该值必须是 0 - 100 之间的整数。 |
| cycle_period_seconds | 指示多个循环间的最短周期(以秒计)。该值必须是 60 - 86400 之间的整数。缺省值为 300。 |
| cycling_mode | 指示要使用的全局镜像、高速镜像或主动/主动循环类型。 值为 none 和 multi。 |
| copy_type | 指示拷贝类型。值包括:
|
| freeze time | 指示 YY/MM/DD/HH/MM 格式的时间 |
| status | 指示状态。值包括:
|
| sync | 指示是否同步关系。值为 in_sync 或 out_of_sync。 |
| master_change_vdisk_name | 指示充当关系主变更卷的卷的名称(如果未定义,那么为空白)。 注: 该字段用于标识主卷的变更卷(如果已配置)。
对于系统间关系,如果主卷位于其他集群系统(系统)中,那么主变更卷也位于该其他系统中。
|
| aux_change_vdisk_id | 指示充当关系辅助变更卷的卷的标识(如果未定义,那么为空白)。 注: 该字段标识辅助卷的变更卷(如果已配置此类卷)。对于系统间关系,如果辅助卷位于其他系统中,那么辅助变更卷也位于该其他系统中。
|
| aux_change_vdisk_name | 指示充当关系辅助变更卷的卷的名称(如果未定义,那么为空白)。 注: 该字段用于标识辅助卷的变更卷(如果已配置)。
对于系统间关系,如果辅助卷位于其他系统中,那么辅助变更卷也位于该其他系统中。
|
| bg_copy_priority | 未使用。 |
注: 如果全局镜像、高速镜像或主动/主动关系或一致性组是系统间的,并且系统伙伴关系已断开连接,那么这些关系和一致性组的名称可为空白。
如果没有为以下任一类型的关系定义主变更卷或辅助变更卷,那么将设置 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
