chhost
使用 chhost 指令,來變更主機物件的名稱或類型。這個指令不會影響任何現有的主機對映。
語法
>>- chhost -- --+----------------------------------+------------> '- -type --+- hpux -----------+-- -' +- tpgs------------+ +- generic --------+ +- openvms --------+ +- adminlun -------+ '- hide_secondary -' >--+---------------------------+-- -----------------------------> '- -mask-- port_login_mask -' >--+-------------------------+-- -------------------------------> '- -name -- new_name_arg -' >--+-------------------------------------------------+-- -------> '- -iscsiusername -- username_for_authentication -' >--+------------------------------+-----------------------------> +- -chapsecret -- chap_secret -+ '- -nochapsecret --------------' >--+--------------------------+--+- host_name -+--------------->< +- -site --+- site_name -+-+ '- host_id ---' | '- site_id ---' | '- -nosite ----------------'
參數
- -type hpux | tpgs | generic | openvms | adminlun | hide_secondary
- (選用)指定主機的類型。下列值是可用的主機類型:
- generic 表示預設值。
- tpgs 表示當目標埠資訊變更時(對主機提供額外的單位警示)。
- openvms 表示 OpenVMS。
- adminlun 表示在主機上啟用的虛擬磁區。
- hpux 表示 HP-UX 韌體。
- hide_secondary 表示所有遠端副本關係次要磁區都無法供主機使用。
有關需要 type 參數之主機的相關資訊,請參閱 IBM Spectrum Virtualize™ 主機連接說明文件。
- -name new_name_arg
- (選用)指定您想要指派給主機物件的新名稱。
- -mask port_login_mask
- (選用)指定主機所能存取的節點目標埠,以及主機的「光纖通道 (FC)」埠遮罩。主機物件中的全球埠名稱 (WWPN) 必須從節點埠存取磁區,這些埠包含在遮罩中,且在主機物件的 I/O 群組中。埠遮罩是 64 二進位位元,由 0 和 1 的組合所組成,0 表示對應的 FC I/O 埠無法使用,1 表示可以使用。遮罩中最右邊的位元對應到 FC I/O 埠 1。有效的遮罩值範圍可從 0000(未啟用任何埠)到 1111111111111111111111111111111111111111111111111111111111111111 (啟用所有的埠)。例如,遮罩為 111111101101,表示啟用埠 1、3、4、6、7、8、9、10、11 和 12。
- -iscsiusername username_for_authentication
- (選用)針對「網際網路小型電腦系統介面 (iSCSI)」主機連接登入的單向鑑別,指定主機物件的使用者名稱。如果指定這個參數,此值將作為 iSCSI 主機連接登入時用於單向鑑別的「使用者名稱」。如果未指定 iscsiusername 參數,依預設會使用主機物件的 IQN 作為使用者名稱。如果未提供 iscsiusername 參數,且相同主機物件中存在多個 IQN,則每個 IQN 的使用者名稱就是 IQN 本身。如果為多重 IQN 主機提供 iscsiusername 參數,則使用提供的 IQN 登入所有主機。如果使用 iscsiusername 參數,則還必須指定 chapsecret 參數。
- -chapsecret chap_secret
- (選用)設定進行 iSCSI I/O 時用來鑑別主機的「盤查信號交換驗證通訊協定 (CHAP)」密碼。主機和叢集之間會共用這個密碼。您可以利用 lsiscsiauth 指令,來列出每一個主機的 CHAP 密碼。
- -nochapsecret
- (選用)清除這個主機先前設定的任何 CHAP 密碼。如果指定了 chapsecret 參數,則不能指定 nochapsecret 參數。
- -site site_name | site_id
- (選用)指定主機的數值站台值或站台名稱。站台名稱必須是英數值。站台 ID 必須為 1 或 2。指派給主機的站台,可以隨任何拓蹼(hyperswap、stretched 或 standard)而變更。註: 如果主機對映至主動關係的磁區,您不能指定 -nosite。
- -nosite
- (選用)重設站台值。
- host_name | host_id
- (必要)依 ID 或現行名稱來指定要修改的主機物件。
說明
這個指令可以將指定之主機的名稱改成新的名稱,也可以變更主機的類型。 這個指令不會影響任何現行的主機對映。
埠遮罩適用於從主機物件的相關聯主機起始器埠進行的登入。針對在主機匯流排配接卡 (HBA) 埠和節點埠之間進行的每一項登入,節點會檢查主機 HBA 所屬之主機物件相關聯的埠遮罩,並決定要允許或拒絕存取。如果拒絕存取,節點會回應給 SCSI 指令,就好像 HBA 埠不明一般。
註: 當從 iSCSI 主機移除所有 I/O 群組時,lsiscsiauth
指令不會顯示該主機的鑑別項目。請利用 addhostiogrp 指令,將 iSCSI 主機對映至至少一個
I/O 群組,然後使用 addhostport 指令,將 iSCSI 埠新增到其中。此外,您也必須搭配 chapsecret 或 nochapsecret 參數來使用 chhost 指令,以新增該主機的鑑別。
呼叫範例
chhost -name testhostlode -mask 111111101101 hostone
顯示的輸出如下:
No feedback
呼叫範例
chhost -type openvms 0
顯示的輸出如下:
No feedback
呼叫範例
chhost -site site1 host3
顯示的輸出如下:
No feedback
