mkhost
使用 mkhost 指令,來建立邏輯主機物件。
語法
參數
- -name new_name
- (選用)指定新主機物件的名稱或標籤。
- -protocol scsi | nvme
- (選用)指定主機用來與儲存體系統通訊的通訊協定。預設值為 scsi。
- -saswwpn wwpn_list
- (在不使用 -iscsiname、-fcwwpn 或 -nqn 的情況下為必需。)指定序列連接 SCSI (SAS) WWPN(16 個字元的十六進位字串)的清單。
- -fcwwpn wwpn_list
- (在不使用 -saswwpn、-iscsiname 或 -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 才能使用此參數。
- -iogrp iogrp_list
- (選用)指定主機可從中存取磁區的一或多個輸入/輸出 (I/O) 群組集。I/O 群組是以名稱或 ID 來指定,並以冒號區隔。在清單中,名稱和 ID 可能會混合。如果未指定這個參數,主機會與所有 I/O 群組相關聯。
- -mask port_login_mask
- (選用)指定主機所能存取的節點目標埠,以及主機的「光纖通道 (FC)」埠遮罩。主機物件中的全球埠名稱 (WWPN)
必須從節點埠存取磁區,這些埠包含在遮罩中,且在主機物件的 I/O 群組中。埠遮罩是 64 二進位位元,由 0 和 1 的組合所組成,
0表示對應的 FC I/O 埠無法使用,1表示使用對應的 FC I/O 埠。遮罩中最右邊的位元對應到 FC I/O 埠 1。有效的遮罩值範圍可從0000(未啟用任何埠)到1111111111111111111111111111111111111111111111111111111111111111(啟用所有的埠)。例如,遮罩為111111101101,表示啟用埠 1、3、4、6、7、8、9、10、11 和 12。 - -force
- (選用)指定建立邏輯主機物件,且不驗證 WWPN。
- -type hpux | tpgs | generic | openvms | adminlun | hide_secondary
- (選用)指定主機的類型。預設值為 generic。adminlun 主機類型相當於管理 GUI 中的 VVOL 主機類型。
- -hostcluster host_cluster_id | host_cluster_name
- (選用)指定新主機物件建立在其中的主機叢集 ID(數值)或名稱(英數值)。
- -ownershipgroup owner_id | owner_name
- (選用)要向其新增物件的所有權群組的名稱或 ID。
說明
mkhost 指令可將一個以上 HBA WWPN、iSCSI 名稱或 NQN 關聯於一個邏輯主機物件。這個指令會建立新的主機。當指令完成時,會顯示 ID。之後,當您利用 mkvdiskhostmap 指令將磁區對映至主機時,就可以使用這個物件。如果您指定 -hostcluster,直接在主機叢集內建立主機,它會繼承任何存在的共用對映。
只有在 protocol 為 nvme 時,才能新增 NQN。只有在主機 protocol 為 scsi 時,才能新增其他所有埠類型。不支援雙通訊協定主機。無法將主機新增至其中主機具有不同通訊協定的主機叢集。NVMe 主機必須將 type 設為 default。
請只發出 mkhost 指令一次。叢集系統會掃描光纖,以找出主機區域中的 WWPN。系統本身無法在主機內部過濾,以判斷哪些 WWPN 是在哪些主機中。因此,您必須使用 mkhost 指令來識別主機。
識別主機之後,會在主機和磁區之間建立對映。這些對映會將磁區有效呈現給 它們所對映的主機。主機物件中的所有 WWPN 都會對映至磁區。
部分 HBA 裝置驅動程式在辨識目標邏輯單元編號 (LUN) 之前,並不會登入 光纖。由於它們並未登入,也就無法將它們的 WWPN 辨識為候選埠。您可以在這個指令中指定 force 參數來停止驗證 WWPN 清單。
如果您將主機新增到一個 I/O 群組中,而此群組關聯於比系統內部限制 所允許的數目還多的主機埠或主機物件時,則這個指令會失敗。
如需相關資訊,請參閱 mkvdiskhostmap、lssasportcandidate 和 lsfcportcandidate 指令。
有關特定主機的參數需求的更多資訊,請訪問下列支援網站:http://www-03.ibm.com/systems/support/storage/ssic/interoperability.wss。
呼叫範例
mkhost -name hostone -saswwpn 210100E08B251DD4:210100F08C262DD8 -force -mask 111111101101
結果輸出:
Host id [1] successfully created
呼叫範例
mkhost -iscsiname iqn.localhost.hostid.7f000001 -name newhost結果輸出:
Host, id [10], successfully created
呼叫範例
mkhost -fcwwpn 210100E08B251EE6:210100F08C262EE7 -type openvms
結果輸出:
Host, id [1], successfully created
呼叫範例
mkhost -fcwwpn 210100E08B251EE6 -site site1結果輸出:
Host, id [1], successfully created
呼叫範例
mkhost -nqn nqn.2014-08.org.nvmexpress:NVMf:uuid:644f51bf-8432-4f59-bb13-5ada20c06397 -protocol nvme
結果輸出:
Host, id [1], successfully created
