lsrcrelationship
使用 lsrcrelationship 指令,傳回系統可見的遠端副本關係(例如,Metro Mirror、Global Mirror 或主動-主動關係)的簡要清單或詳細視圖。
語法
>>- lsrcrelationship -- ----------------------------------------> >--+-----------------------------------+-- --+----------+-- ----> '- -filtervalue -- attribute=value -' '- -nohdr -' >--+-----------------------+-- -- --+-----------------+---------> '- -delim -- delimiter -' '- -filtervalue? -' >--+---------------+------------------------------------------->< +- object_id ---+ '- object_name -'
參數
- -filtervalue attribute=value
- (選用)指定一或多個過濾器的清單。只會傳回其值符合過濾器屬性值的物件。如果指定容量,也必須包括單位。
- 註: 當您輸入指令時,某些過濾器可使用萬用字元。在 IBM Spectrum Virtualize™ CLI 中使用萬用字元時,會套用下列規則:
- 萬用字元是星號 (*)。
- 指令可以包含最多一個萬用字元,且必須是字串中的第一個或最後一個字元。
- 使用萬用字元時,必須使用雙引號 ("") 括住過濾項目,如下所示:
lsrcrelationship -filtervalue "name=md*"
- -nohdr
- (選用)依預設,會在簡要樣式視圖中顯示每個資料直欄的標題,以及在詳細樣式視圖中顯示每個資料項目的標題。-nohdr 參數會暫停顯示這些標題。註: 如果沒有資料可顯示,即使指定 -nohdr 參數,也不會顯示標題。
- -delim delimiter
- (選用)依預設,簡要視圖中的所有資料直欄都以空格區隔。每個直欄的寬度都會設為各資料項目的最大寬度。在詳細視圖中,每個資料項目本身都有一列,如果顯示標頭,會用空格來區隔資料與標頭。-delim 參數會置換這個行為。-delim 參數的有效輸入為一個單位元組字元。如果您在指令行輸入 -delim :,則會用冒號字元 (:) 來區隔簡要視圖中的所有資料項目;例如,直欄不會出現間距。在詳細視圖中,會用指定的定界字元來區隔資料與其標頭。
- object_id | object_name
- (選用)指定物件的名稱或 ID。當使用這個參數時,會傳回特定物件的詳細視圖,而忽略 -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 參數的屬性。
說明
這個指令會傳回系統可見的遠端副本關係(例如 Metro Mirror、Global Mirror 或主動-主動關係)的簡要清單或詳細視圖。
表 1 提供在輸出視圖中顯示為資料之屬性的可能值。
| 屬性 | 值 |
|---|---|
| primary | 指出主要關係。值為 master 和 aux。 |
| state | 指出關係狀態。值如下:
|
| progress | 指出關係進度。此值必須是 0 到 100 之間的數字(整數)。 |
| cycle_period_seconds | 指出多重循環之間的最短週期(秒)。此值必須是 60 到 86400 之間的數字(整數)。預設值為 300。 |
| cycling_mode | 指出要使用之 Global Mirror、Metro Mirroring 或主動-主動循環的類型。值為 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 | 指出充當關係之輔助變更磁區的磁區 ID(若未定義則為空白) 註: 這個欄位識別輔助磁區的變更磁區(如果已配置這類磁區的話)。對於跨系統關係,如果輔助磁區是在其他系統中,則輔助變更磁區也是在其他系統中。
|
| aux_change_vdisk_name | 指出充當關係之輔助變更磁區的磁區名稱(若未定義則為空白) 註: 這個欄位識別輔助磁區的變更磁區(若有配置的話)。對於跨系統關係,如果輔助磁區是在其他系統中,則輔助變更磁區也是在其他系統中。
|
| bg_copy_priority | 未使用。 |
註: 如果關係或一致性群組是跨系統,且系統夥伴關係已斷線,則 Global Mirror、Metro Mirror 或主動-主動關係和一致性群組的名稱可能會空白。
如果未針對下列任一類型的關係定義主變更磁區或輔助變更磁區,則會設定 change_volumes_needed 狀態:
- 副本類型設定為主動-主動
- 副本類型設定為 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
