lsiscsistorageportcandidate

請使用 lsiscsistorageportcandidate 指令,顯示候選「網際網路小型電腦系統介面 (iSCSI)」目標控制器「iSCSI 完整名稱 (IQN)」(利用所指定起始器來源埠中的目標 IP 來指定)的簡要或詳細資訊清單。

語法

讀取語法圖表略過語法圖表
>>-lsiscsistorageportcandidate--+---------+--------------------->
                                '- -nohdr-'   

>--+--------------------+--+------------------------+----------->
   '- -delim--delimiter-'  '- -node--+- node_id---+-'   
                                     '- node_name-'     

>--+-----------------------------------+-----------------------><
   '-lsiscsistorageportcandidate-rowid-'   

參數

-nohdr
(選用)依預設,會在簡要樣式視圖中顯示每個資料直欄的標題,以及在詳細樣式視圖中顯示每個資料項目的標題。-nohdr 參數會暫停顯示這些標題。
註: 如果沒有資料可顯示,就不會顯示標題。
-node node_name | node_id
(選用)

指定系統中節點的 ID 或名稱。此值必須是英數字串。

-delim delimiter
(選用)依預設,簡要視圖中的所有資料直欄都以空格區隔。每個直欄的寬度都會設為各資料項目的最大寬度。在詳細視圖中,每個資料項目本身都有一列,如果顯示標頭,會用空格來區隔資料與標頭。-delim 參數會置換此行為。-delim 參數的有效輸入為一個單位元組字元。如果您在指令行輸入 -delim :,則會用冒號字元 (:) 來區隔簡要視圖中的所有資料項目;例如,直欄不會出現間距。在詳細視圖中,會用指定的定界字元來區隔資料與其標頭。
lsiscsistorageportcandidate-rowid
(選用)指定簡要視圖中顯示的列 ID,以提供探索到的入口網站 IP 的詳細資訊視圖。

說明

這個指令會列出前次呼叫 detectiscsistorageportcandidate 指令的相關資訊。這個指令還可以顯示兩種清單:
  • 指定的起始器埠在指定目標 IP 上可看見的候選 iSCSI 目標控制器 IQN 的簡要資訊清單,同時指出哪些起始器埠可以看到每個探索到的 iSCSI 目標 IQN。
  • 前次呼叫 detectiscsistorageportcandidate 指令期間探索到的所有「目標控制器入口網站 IP」的詳細資訊。
這份表格提供可以顯示為輸出視圖資料的屬性值。
表 1. lsiscsistorageportcandidate 輸出
屬性 說明
id 指出探索輸出的列 ID。使用 lsiscsistorageportcandidate 指令之前,請先輸入 detectiscsistorageportcandidate 指令。先顯示簡要視圖,其中每個 IQN 各顯示一列。使用簡要視圖中的列 ID 來指定 lsiscsistorageportcandidate lsiscsistorageportcandidate-rowid 指令的詳細視圖。詳細視圖會顯示針對該 IQN 而探索到的目標 IP 位址清單。
src_port_id 指出來源埠 ID。此值是 1 到 8 之間的數字。
target_ipv4 指出目標 IPv4 位址。
target_ipv6 指出目標 IPv6 位址。
target_iscsiname 指出使用目標控制器(探索到)的 IQN。此值是長度為 256 個字元的英數字串。
iogroup_list 指出探索結果碼清單(以冒號區隔):此值必須是一個最長 32 個字元的英數字串。此欄位不能空白。值為 01
  • 0 表示 I/O 群組在系統中可供使用,但未透過 I/O 群組觸發探索,或者透過 I/O 群組探索失敗。
  • 1 表示 I/O 群組存在,且透過 I/O 群組探索成功。
註:-(橫線)表示 I/O 群組無效或不存在於系統中。
status 指出探索是否成功。狀態為下列其中一個值:
  • full
  • partial
  • none
configured 指出探索到的目標 IQN 是否與來源埠或目標埠建立了任何階段作業。值為 yesno(預設值)。
site_id 指出站台 ID(如果所探索的節點屬於站台)。這個屬性適用於延伸系統和 HyperSwap® 系統。
site_name 指出站台名稱(如果正在探索的節點屬於站台)。這個屬性適用於延伸系統和 HyperSwap 系統。

簡要呼叫範例

首先,您必須透過來源埠 ID 1,使用目標 ISCSI 控制器的 IPv4 IP 位址來指定目標探索。不需要任何 tgt_user_nametarget_chap 值。
detectiscsistorageportcandidate –srcportid 1 -targetip 10.10.10.1

如果要檢視輸出,請指定下列指令:

lsiscsistorageportcandidate

畫面上會顯示下列簡要的結果輸出:

id  src_port_id target_ipv4 target_ipv6 target_iscsiname  iogroup_list configured status site_id site_name
0   1           10.10.10.1              IQN1              1:1:1:1        no       Full

簡要呼叫範例

此範例透過 I/O 群組 0 和來源埠 ID 0,使用目標 ISCSI 控制器的 IPv4 IP 位址,來顯示目標探索:
detectiscsistorageportcandidate -iogrp 0 –srcportid 1 -targetip IP2  –username superuser –chapsecret password2
使用 tgt_user_nametarget_chap 值。這個系統只有兩個 I/O 群組:03

如果要檢視輸出,請指定下列指令:

lsiscsistorageportcandidate

畫面上會顯示下列簡要的結果輸出:

id  src_port_id target_ipv4 target_ipv6 target_iscsiname  iogroup_list configured status site_id site_name
0   1           IP2                     IQN1              1:-:-:0        no       Full
1   1           IP2                     IQN2              1:-:-:0        no       Full
2   1           IP2                     IQN3              1:-:-:0        no       Full

詳細呼叫範例

首先,您必須透過來源埠 ID 1 和目標 IP 位址,利用目標 iSCSI 控制器的 IPv4 IP 位址來指定目標探索。
detectiscsistorageportcandidate –srcportid 1 -targetip 10.10.10.1

簡要視圖中的每個 IQN 各一列,如第一個簡要視圖範例所示。簡要視圖中的每一個列 ID 識別一個 iSCSI 完整名稱 (IQN)。如果要檢視 IQN 的詳細資訊,請指定列 ID (id):

lsiscsistorageportcandidate 0

結果輸出會列出針對該 IQN 而探索到的入口網站 IP 位址的詳細資料:

SendTargets Portal IPs
10.10.10.1
10.10.10.2
fe:65::00:01
fe:65::00:02