cfgportip
請使用 cfgportip 指令將「網際網路通訊協定 (IP)」位址指派給每個節點乙太網路埠，以進行「網際網路小型電腦系統介面 (iSCSI)」輸入/輸出 (I/O)。
語法
適用於網際網路通訊協定第 4 版 (IPv4) 和網際網路通訊協定第 6 版 (IPv6)：
>>-cfgportip-- -node--+-node_name-+-----------------------------> '-node_id---' >--+- -ip--ipv4addr-- -mask--subnet_mask-- -gw--ipv4gw--+-------> '- -ip_6--ipv6addr--prefix_6--prefix-- -gw_6--ipv6gw-' >--+------------+--+-------------------+------------------------> '- -failover-' +- -host--+-yes-+---+ | '-no--' | '- -host_6--+-yes-+-' '-no--' >--+-------------------------------------------+----------------> +- -remotecopy--remote_copy_port_group_id---+ '- -remotecopy_6--remote_copy_port_group_id-' >--+----------------------+--+-----------------------+----------> +- -vlan-- vlan_id_ip4-+ +- -vlan_6-- vlanid_ip6-+ '- -novlan-------------' '- -novlan_6------------' >--+----------------------+--+---------+--port_id-------------->< +- -storage--+-yes-+---+ '- -force-' | '-no--' | '- -storage_6--+-yes-+-' '-no--'
針對最大傳輸單位 (MTU)：
參數
- （必要）指定哪個節點具有要指派 IP 位址的乙太網路埠。註： 要設定埠 IP 位址需要這個參數。它不能與 -mtu 參數一起使用。
- （必要）設定乙太網路埠的「網際網路通訊協定第 4 版 (IPv4)」位址。此參數不能與 ip_6 參數一起使用。
- （必要）設定乙太網路埠的「網際網路通訊協定第 6 版 (IPv6)」位址。此參數不能與 ip 參數一起使用。
- （必要）設定 IPv4 閘道 IP 位址。此參數不能與 gw_6 參數一起使用。
- （必要）設定埠的 IPv6 預設閘道位址。此參數不能與 gw 參數一起使用。
- （必要）設定 IPv4 子網路遮罩。此參數不能與 prefix_6 參數一起使用。
- （必要）設定 IPv6 字首。此參數不能與 mask 參數一起使用。
- （選用）指定屬於 I/O 群組中的夥伴節點的 IP 位址。如果夥伴節點未配置或離線，則由這個節點來配置及呈現該位址。當 I/O 群組中的另一個節點上線時，便由該節點來呈現失效接手位址。
如果夥伴節點在線上，請勿使用這個選項。
- （必要）指定最大傳輸單位 (MTU)。預設值 1500，上限為 9000。MTU 9000 可讓您節省 4 KB 及以上大小封包的 CPU 使用率。MTU 的增加可以改善「網際網路小型電腦系統介面 (iSCSI)」效能。指定 -defaultmtu 以使用預設值。附註： 這個參數有下列限制：
- （選用）指定包含要修改之節點的 I/O 群組。
- （選用）指定用於主機連接的 IPv4 位址（保持現有的系統設定）。指定：
- yes 會在目標探索期間向主機報告 IPv4 位址（預設值）
- no 會關閉此報告（在主機探索期間不會報告 IPv4 位址）。
- （選用）指定用於遠端副本功能的 IPv4 位址。遠端副本包括 HyperSwap®、Metro Mirror 和 Global Mirror。這也會指定關聯埠群組的 ID。這些 ID 是數值（0、1 或 2），指定系統上的 IP 位址可以是登入的夥伴關係的一部分。如果要形成登入，IP 位址必須是在相同的埠群組。預設值為 0，表示此埠無法使用於夥伴關係。重要： 如果要在抄寫群組中新增或刪除埠，請確定使用該埠群組的夥伴關係為已停止狀態。
- （選用）指定用於主機連接的 IPv6 位址（保持現有的系統設定）。指定：
- yes 會在目標探索期間向主機報告 IPv6 位址（預設值）。
- no 會關閉此報告（在主機探索期間不會報告 IPv6 位址）。
註： 關閉設為 yes 的 IP 位址的主機連接設定時中斷，因為該 IP 位址的所有主機 iSCSI 階段作業都已登出。 - （選用）指定用於遠端副本功能的 IPv6 位址。遠端副本包括 HyperSwap、Metro Mirror 和 Global Mirror。這也會指定關聯埠群組的 ID。這些 ID 是數值（0、1 或 2），指定系統上的 IP 位址可以是登入的夥伴關係的一部分。如果要形成登入，IP 位址必須是在相同的埠群組。預設值為 0，表示此埠無法使用於夥伴關係。重要： 如果要在抄寫群組中新增或刪除埠，請確定使用該埠群組的夥伴關係為已停止狀態。
- （選用）就針對 iSCSI 主機連接或遠端副本功能而配置的 IPv4 位址，設定虛擬區域網路 (VLAN) ID。遠端副本包括 HyperSwap、Metro Mirror 和 Global Mirror。只有當已設定該埠的 IP 位址時，才能指定 IPv4 類型位址的 VLAN ID。對於任何的 IP 位址都已停用 VLAN 標記，所以必須使用 -vlan 來指定 VLAN ID 以開啟 VLAN 標記。記住： 請小心使用 -vlan。您可以：
- 重設 VLAN 設定，這可能會中斷與主機或系統的埠通訊（連線）（包括重設作用中的 iSCSI 或 IP 夥伴關係的 VLAN ID）
- 針對沒有 VLAN 標記或未配置 IP 位址的埠重設 VLAN 值
可以對使用 -failover 屬性的失效接手埠設定 VLAN ID。
- （選用）停用乙太網路埠的 IPv4 位址的 VLAN 標記（表示沒有 VLAN 標記與該埠相關聯）。
- （選用）針對配置給 iSCSI 主機連接或遠端副本功能的 IPv6 位址，設定虛擬區域網路 (VLAN) ID。遠端副本包括 HyperSwap、Metro Mirror 和 Global Mirror。只有當已設定該埠的 IP 位址時，才能指定 IPv6 類型位址的 VLAN ID。對於任何的 IP 位址都已停用 VLAN 標記，所以必須使用 -vlan 來指定 VLAN ID 以開啟 VLAN 標記。記住： 請小心使用 -vlan_6：
- 重設 VLAN 設定可能會中斷與主機或系統的埠通訊（連線），包括重設作用中的 iSCSI 或 IP 夥伴關係的 VLAN ID。
- 您可以針對沒有 VLAN 標記或未配置 IP 位址的埠重設 VLAN 標記。
可以使用 -failover 屬性設定失效接手埠的 VLAN ID。
- （選用）停用乙太網路埠的 IPv6 位址的虛擬區域網路 (VLAN) 標記（這表示沒有 VLAN 標記與該埠相關聯）。記住： 請小心使用 -novlan_6：
- 重設 VLAN 設定可能會中斷與主機或系統的埠通訊（連線），包括重設作用中的 iSCSI 或 IP 夥伴關係的 VLAN ID。
- 您可以針對沒有 VLAN 標記或未配置 IP 位址的埠重設 VLAN 標記。
- （選用）指定後端儲存體連接功能是否可以使用 IPv4 位址。yes 值指示這個 IPv4 位址可用於 iSCSI 目標探索和後端儲存體連線功能。如果未使用儲存體連接 IP 位址，您必須指定 no（預設值）。如果與特定埠（節點上）相關聯的 IPv4 位址已改變，則會保留現有的儲存體連接設定。值為 yes 和 no。
- （選用）指定後端儲存體連接功能是否可以使用 IPv6 位址。yes 值（預設值）指示這個 IPv6 位址可用於 iSCSI 目標探索和後端儲存體連線功能。如果不使用儲存體連接 IP 位址，則必須指定 no。如果與特定埠（節點上）相關聯的 IPv6 位址已改變，則會保留現有的儲存體連接設定。值為 yes 和 no。
- （選用）強迫變更節點乙太網路埠的 IP 位址，即使這會導致移除 iSCSI 後端控制器，或使 MDisk 進入欠佳或離線狀態也一樣。重要： 請儘量不要使用 force 屬性，以免無法存取節點或 MDisk。
變更 IP 位址屬性可能會造成 MDisk 進入欠佳狀態一段時間。如果 iSCSI 後端控制器連線功能正在使用來源 IP 位址，則變更 IP 位址、子網路遮罩或 IP 閘道會移除現有的階段作業，並建立新的階段作業。在此階段期間，透過重新配置的來源埠而出現的 MDisk 會短暫變成欠佳狀態，直到建立新的階段作業為止。
只要您明白所有可能涉及的風險，就可以使用 -force 旗標來繼續重新配置。如果不確定可能發生的情況，則務必在支援人員的指示下使用 force 屬性。
如果您在系統中新增 I/O 群組，可能會看到 CMMVC8915E 訊息。在新的 I/O 群組上配置 iSCSI IP 位址時，務必將 IP 位址指派給未配置的埠，並使用 -force 旗標來指派 IP。
- （必要）指定要套用變更的埠（1、2、3 或 4）。
說明
cfgportip 指令可設定 iSCSI 的乙太網路埠 IP 位址，或配置一組埠的 MTU。這個指令會將 IPv4 或 IPv6 位址指派給節點的指定乙太網路埠。此 IP 位址用於 iSCSI I/O。請使用 chsystemip 指令來指派叢集系統 IP 位址。
記住： 如果對 I/O 群組的每一個節點配置了具有相同遠端抄寫埠群組 ID 的
IP 位址（為了備援），請確定配置期間兩個節點是使用相同的乙太網路埠。MTU 是使用相同 I/O 群組中的對稱乙太網路埠來設定。為了確保替代遠端抄寫
埠群組使用相同的 MTU 設定，必須對遠端抄寫埠群組配置對稱的乙太網路埠。
IPv4 位址需要 ip、mask 和 gw 參數。您必須指定所有 IPv4 IP 參數，才能將 IPv4 位址指派給乙太網路埠。
IPv6 位址需要 ip_6、prefix_6 和 gw_6 參數。您必須指定所有 IPv6 IP 參數，才能將 IPv6 位址指派給乙太網路埠。
如果指定主機的 IP 位址，主機可以利用 iSNS 伺服器（或 SendTargets 之類的其他探索機制）來探索指定的埠。這些 IP 位址不會向夥伴系統報告，以便建立用於遠端副本的 TCP 階段作業。這些埠也不能用於登入後端 iSCSI 儲存體控制器，以及對控制器進行 SendTargets 型探索。
主機無法探索遠端副本的指定 IP 位址，這表示主機連接無法使用它們。這些埠不會向夥伴系統報告，以便建立用於遠端副本的 TCP 階段作業。當考量探索後端 iSCSI 儲存體控制器時，這些埠也不能用於登入，以及用於 SendTargets。
配置 IP 之後，host_port_group_id 會自動指派給 iSCSI 埠。主機埠分組可以將速度相同的埠分在同一組，以確保一個主機探索到的埠不超過四個。其他 host_port_group_id 準則包括：
主機無法探索儲存體的指定 IP 位址，這表示主機連接無法使用它們。這些 IP 位址不會向夥伴系統報告，以便建立及設定遠端副本的 TCP 階段作業。
如果要將相同的 IP 位址用於主機 I/O 和後端儲存體連接功能（但不用於遠端副本）：
- -host 參數必須設為 yes。
- -storage 參數必須設為 yes。
- -remotecopy 參數必須設為 no。
如果要將相同的 IP 位址用於後端儲存體連接功能和遠端副本功能（但不用於主機 I/O 作業）：
- -storage 參數必須設為 yes。
- -remotecopy 參數必須與必要的遠端副本埠群組 ID 一起指定。
- -host 參數必須設為 no。
如果要將相同的 IP 位址用於主機 I/O 和遠端副本功能（但不用於後端儲存體連接功能）：
- -host 參數必須設為 yes。
- -remotecopy 參數必須與必要的遠端副本埠群組 ID 一起呼叫。
- -storage 參數必須設為 no。
請搭配使用 lsportip 指令和 ethernet_port_id 選用參數，以列出所指定埠的埠 IP 位址。
記住：
如果使用 cfgportip 來修改與特定乙太網路埠相關聯的 IP 位址，但沒有指定新的 VLAN ID，則新的（修改後的）IP 位址會繼承先前 IP 位址（IPv4 或 IPv6）的現有 VLAN ID 設定。
IPv4 呼叫範例
cfgportip -node 1 -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 1結果輸出：
No feedbackIPv6 呼叫範例
cfgportip -node 1 -ip_6 3:3:0:4::0 -gw_6 ffe8::0 -prefix_6 64 2結果輸出：
No feedback在 I/O 群組 0 中的埠 1 上將 MTU 設為 1600 的呼叫範例
cfgportip –mtu 1600 -iogrp 0 1結果輸出：
No feedback將 MTU 設為其預設值的呼叫範例
cfgportip –defaultmtu -iogrp 0 1結果輸出：
No feedback為基於 IP 的抄寫配置新的 IPv4 位址的呼叫範例
cfgportip -node 1 -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 –remotecopy 1 –host no -host_6 no 1結果輸出：
No feedback為主機連接配置新的 IPv4 位址的呼叫範例
cfgportip -node 1 -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 –host yes 1結果輸出：
No feedback為現有的 IPv6 位址配置抄寫的呼叫範例
cfgportip -node 1 –remotecopy_6 2 1結果輸出：
No feedback為新的 IPv6 位址配置主機連接的呼叫範例
cfgportip -node 1 –ip_6 2001:db8::1:0:0:1 –host_6 yes 1結果輸出：
No feedback以 VLAN ID 105 配置新的 IPv4 位址的呼叫範例
cfgportip -node 1 -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 –vlan 105 1結果輸出：
No feedback以 VLAN ID 1063 配置新的 IPv6 位址的呼叫範例
cfgportip -node 1 -ip_6 2001:db8::1:0:0:101 -prefix_6 64 -gw_6 2001:db8::1:0:0:1 -vlan_6 1063 1結果輸出：
No feedback為使用 iSCSI 的後端儲存體連接功能配置新的 IPv4 位址的呼叫範例
cfgportip -node 1 -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 –storage yes -remotecopy 0 –host no 1
cfgportip -node 1 -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 –storage yes –host no 1結果輸出：
No feedback僅為主機連接配置新的 IPv4 位址的呼叫範例
cfgportip -node 1 -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 –host yes -storage no 1
cfgportip -node 1 -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 –host yes -storage no -remotecopy 0 1
cfgportip -node 1 -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 1結果輸出：
No feedback為基於 IP 的抄寫配置新的 IPv4 位址的呼叫範例
cfgportip -node 1 -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 -storage no –remotecopy 1 –host no 1結果輸出：
No feedback為新的 IPv6 位址配置儲存體連接功能的呼叫範例
cfgportip -node 1 –ip_6 2001:db8::1:0:0:1 –storage_6 yes 1
cfgportip -node 1 –ip_6 2001:db8::1:0:0:1 1結果輸出：
No feedback為現有的 IPv6 位址變更儲存體規格的呼叫範例
cfgportip -node 1 –storage_6 no 1
cfgportip -node 1 –storage_6 yes 1結果輸出：
No feedback