mkhost
使用 mkhost 指令，來建立邏輯主機物件。
語法
>>-mkhost--+------------------+--+----------------------+-------> '- -name--new_name-' '- -protocol--+-scsi-+-' '-nvme-' >--+- -saswwpn--wwpn_list---------+--+---------------------+----> +- -fcwwpn--wwpn_list----------+ '- -iogrp--iogrp_list-' +- -iscsiname--iscsi_name_list-+ '- -nqn--nqn_list--------------' >--+-------------------------+--+---------+---------------------> '- -mask--port_login_mask-' '- -force-' >--+----------------------------+-------------------------------> '- -type--+-hpux-----------+-' +-tpgs-----------+ +-generic--------+ +-openvms--------+ +-adminlun-------+ '-hide_secondary-' >--+-------------------------------------------------------------+->< '- -site--+-site_name-+-- -hostcluster--+-host_cluster_id---+-' '-site_id---' '-host_cluster_name-'
參數
- -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（數值）或名稱（英數值）。
說明
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