chhost

參數

-type hpux | tpgs | generic | openvms | adminlun | hide_secondary

（選用）指定主機的類型。下列值是可用的主機類型：

• generic 表示預設值。
• tpgs 表示當目標埠資訊變更時（對主機提供額外的單位警示）。
• openvms 表示 OpenVMS。
• adminlun 表示在主機上啟用的虛擬磁區。
• hpux 表示 HP-UX 韌體。
• hide_secondary 表示所有遠端副本關係次要磁區都無法供主機使用。

無法變更 NVMe 主機的主機類型。有關需要 type 參數之主機的相關資訊，請參閱 IBM Spectrum Virtualize 主機連接說明文件。

-name new_name_arg

（選用）指定您想要指派給主機物件的新名稱。

-protocol scsi | nvme

（選用）指定主機用來與儲存體系統通訊的通訊協定。預設值為 scsi。不得同時變更主機的 -protocol 及主機的 -type。僅當滿足下列條件時才能變更主機通訊協定：

• 沒有磁區對映到主機。
• 未在主機上定義任何埠。
• 主機類型與新的通訊協定相容。使用 NVMe 通訊協定的主機類型必須為 generic。

-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）而變更。

註： 如果主機對映至主動-主動關係 (HyperSwap®) 的磁區，則您無法指定 -nosite。

-nosite

（選用）重設站台值。

-statuspolicy redundant | complete

（選用）指定 complete 或 redundant 原則是否用於線上狀態計算。

• 在完整連線中，online 主機狀態指出完整連線，其中每個主機埠都 登入該主機可從中存取磁區的每個節點，而 degraded 主機狀態則指出其中一 或多個節點沒有登入。
• 在備援連線計算中，online 主機狀態指出備援連線，其中有足夠多 的主機埠登入足夠多的節點，以便移除單一節點或單一主機埠時可 容許該主機存取其所有磁區。此外，從主機登入 I/O 群組內每個 節點的登入總數必須相同。 Degraded 主機狀態指出非備援連線，在此狀態下，單一失敗點即會使主機至少無法存取其部分磁區， 或沒有單一失敗點，但從主機登入 I/O 群組內每個節點的登入總數不同。

預設值為 redundant。

-statussite all | local

（選用）指定使用 all（所有）站台還是僅使用 local（本端）主機站台連線來判斷線上狀態。 local 僅適用於具有有效站台之主機的雙站台拓蹼。預設值是 all。

-ownershipgroup owner_id | owner_name

（選用）要向其新增物件的所有權群組的名稱或 ID。

-noownershipgroup

（選用）如果指定，則會從物件所屬的所有權群組中移除物件。

host_name | host_id

（必要）依 ID 或現行名稱來指定要修改的主機物件。