addiscsistorageport

請使用 addiscsistorageport 指令來建立「網際網路小型電腦系統介面 (iSCSI) 」登入階段作業，以便從指定之 I/O 群組（或整個叢集系統）中的任何（或所有）節點，登入探索到的後端目標 iSCSI 控制器。

語法


>>-addiscsistorageport--+-------------------------+------------->
                        '- -iogrp--+-iogrp_id---+-'   
                                   '-iogrp_name-'     

>--+------------------------------+----------------------------->
   '- -username--target_user_name-'   

>--+---------------------------+--+-----------------------+----->
   '- -chapsecret--target_chap-'  '- -site--+-site_id---+-'   
                                            '-site_name-'     

>--candidate_id------------------------------------------------><

參數

-iogrp iogrp_id | iogrp_name

（選用）指定新增的 I/O 群組 ID 或名稱。iogrp_id 值必須是 0、1、2 或 3。iogrp_name 此值必須是英數字串。

指定這個參數會透過指定 I/O 群組的兩個節點來觸發探索。在指定 detectiscsistorageportcandidate 之後所產生的探索結果中，選取的列會顯示每一個節點上的埠號（用於建立階段作業）。

-username target_user_name

（選用）指定新增的目標控制器使用者名稱。這個值必須是一個最多 256 個字元的英數字串。

如果目標控制器需要 target_user_name 和 target_chap 來進行探索，則必須指定目標控制器的使用者名稱。

部分控制器可能會要求您使用 iSCSI 完整名稱 (IQN) 使用者名稱來進行探索。每個節點 IQN 都會自動提取，必要的話，會加以使用。

-chapsecret target_chap

（選用）指定要探索新增的目標 iSCSI 控制器時所需的「盤查信號交換驗證通訊協定 (CHAP)」密碼 (target_chap)。這個值必須是一個最多 79 個字元的英數字串（區分大小寫）。如果指定 -username，就需要這個關鍵字。

-site site_id | site_name

（選用）指定要偵測之主機的站台 ID 或站台名稱。站台 ID 必須是 1（預設值）或 2。站台名稱必須是一個英數值。

重要：必須為 HyperSwap® 或延伸系統指定此參數。

如果是 HyperSwap 或延伸叢集拓蹼，必須指定站台 ID，以確保會從 iSCSI 儲存體控制器所在站台中的節點來試圖建立階段作業。

candidate_id

（必要）指出列 ID，用以表示 lsiscsistorageportcandidate 輸出中選取的列。

說明

這個指令會建立從指定 I/O 群組（或者，如果未指定 I/O 群組，則是整個叢集系統）至探索到的後端 iSCSI 目標控制器的 iSCSI 登入階段作業。

如果要使用這個指令，您必須先執行下列步驟：

指定 detectiscsistorageportcandidate 來偵測或探索後端控制器目標埠。
指定 lsiscsistorageportcandidate 來顯示探索輸出，並在探索到的 iSCSI 儲存體控制器上，尋找唯一的 IQN 和「網際網路通訊協定 (IP)」組合。
指定 addiscsistorageport。您可以指定起始 iSCSI 階段作業之來源埠的 I/O 群組號碼，以建立指向 iSCSI 控制器埠的階段作業（從單一 I/O 群組中的所有節點）。

如果未指定 I/O 群組，會從系統中的所有節點建立階段作業。來源埠 ID 會在探索結果中。因為某些 iSCSI 控制器會以 IQN 來代表邏輯單元編號 (LUN)，而且對於每一個 IQN，可能需要不同的 target_user_name 和 target_chap，所以在建立階段作業時，也可以指定這些值來進行鑑別。

註：您可以利用 chiscsistorageport 指令來新增更多起始器節點鑑別認證。

詳細的呼叫範例

這個範例顯示的目標探索使用目標 iSCSI 控制器的 IPv4 IP 位址，而且透過來源埠 ID 0。例如，您可能先指定：

detectiscsistorageportcandidate -targetip 192.168.81.91  -srcportid 3 -chapsecret Vardy -site 1

接著指定 lsiscsistorageportcandidate 來列出 iSCSI 埠資訊：

id src_port_id target_ipv4    target_ipv6 target_iscsiname   iogroup_list configured status
0  4           192.168.213.33             IQN1                1:1:1:1      yes        full

然後，針對探索輸出列 0，使用 addiscsistorageport 來建立階段作業。

註：如果您在探索期間對 detectiscsistorageportcandidate 指定 -username 或 -chapsecret，則建立階段作業時也必須指定 -username 或 -chapsecret。

addiscsistorageport 0

詳細的結果輸出：

No feedback