addhostport
使用 addhostport 指令將全球埠名 (WWPN)、網際網路小型電腦系統介面 (iSCSI) 名或 NVMe 完整名稱 (NQN) 新增到現有主機物件。
語法
參數
- -saswwpn wwpn_list
- (在不使用 -iscsiname、-fcwwpn 或 -nqn 的情況下為必需。)指定序列連接 SCSI (SAS) WWPN(16 個字元的十六進位字串)的清單。
- -fcwwpn wwpn_list
- (在不使用 -iscsiname、-saswwpn 或 -nqn 的情況下為必需。)指定「光纖通道 (FC)」WWPN(16 個字元的十六進位字串)的清單。
- -iscsiname iscsi_name_list
- (在不使用 -fcwwpn、-saswwpn 或 -nqn 的情況下為必需。)指定要新增到主機的 iSCSI 名稱的逗點區隔清單。必須指定至少一個 WWPN 或 iSCSI 名稱。這個參數不能與 -fcwwpn 或 -saswwpn 參數搭配使用。
- -nqn nqn_list
- (在不使用 -fcwwpn、-saswwpn 或 -iscsiname 的情況下為必需。)指定要新增到主機的 NVMe 完整名稱 (NQN) 的逗號分隔清單。主機通訊協定必須為 nvme 才能使用此參數。
- -force
- (選用)指定將埠清單新增至主機時,不驗證任何 WWPN 或 iSCSI 名稱。
- host_id | host_name
- (必要)依 ID 或名稱來指定要在其中新增埠的主機物件。
說明
這個指令會將主機匯流排配接卡 (HBA) WWPN、iSCSI 名稱或 NQN 清單新增至指定的主機物件。對映至這個主機物件的任何磁區,都會自動對映至新的埠。
註: 主機埠只能在其與主機的通訊協定相容時新增(SCSI 可以具有 NQN 以外的所有埠類型,而 NVMe 只能具有 NQN)。
只能新增已登入而未配置的 WWPN。如需候選 WWPN 的清單,請使用 lssasportcandidate 或 lsfcportcandidate 指令。
部分 HBA 裝置驅動程式在能夠辨識目標邏輯單元編號 (LUN) 之前,並不會登入架構。由於它們並未登入,也就無法將它們的 WWPN 辨識為候選埠。您可以在 addhostport 指令中指定 force 參數,以停止驗證 WWPN 清單。
註: 從 iSCSI 主機中移除所有 I/O 群組後,則要直到您將 iSCSI 主機對映至至少一個 I/O 群組,才能將埠新增至 iSCSI 主機。將 iSCSI 主機對映至至少一個 I/O 群組之後,請重新提交 addhostport 指令。將埠新增至主機之後,您必須使用 chhost 指令建立主機鑑別項目。
如果有下列情況,addhostport 指令會失敗:
- 主機對映至的磁區在存取集裡有多個 I/O 群組,而且您新增的主機埠是「網際網路小型電腦系統介面 (iSCSI)」名稱
- 新增的埠所來自的主機系統,不支援從多個 I/O 群組對映的磁區
呼叫範例
addhostport -saswwpn 210100E08B251DD4 host1
結果輸出:
No feedback
呼叫範例
addhostport -fcwwpn 210100E08B251EE6 host1
結果輸出:
No feedback
呼叫範例
addhostport -iscsiname iqn.localhost.hostid.7f000001 mchost13結果輸出:
No feedback
