使用 esxcli 命令將多重路徑 PSA 宣告規則新增到系統上的宣告規則集。為啟用新宣告規則，請先定義規則，然後載入到系統中。

當您新增 PSA 宣告規則時，範例包括：
  • 載入新的多重路徑外掛程式 (MPP)，且必須定義此模組宣告的路徑。
  • 新增路徑並想要現有 MPP 進行宣告。
注意： 在建立宣告規則時，請避免出現下列情況：不同的 MPP 對相同 LUN 宣告不同的實體路徑。除非其中一個 MPP 是 MASK_PATH MPP，否則，此組態可能會造成效能問題。

在此程序中，--server=server_name 指定目標伺服器。指定的目標伺服器會提示您輸入使用者名稱和密碼。支援其他連線選項，如組態檔或工作階段檔案。如需連線選項的清單，請參閱 vSphere Command-Line Interface 入門。

必要條件

安裝 vCLI 或部署 vSphere Management Assistant (vMA) 虛擬機器。請參閱vSphere Command-Line Interface 入門。若要進行疑難排解，請在 ESXi Shell 中執行 esxcli命令。

程序

  1. 若要定義新宣告規則，請執行下列命令：
    esxcli --server=server_name storage core claimrule add

    該命令採用下列選項：

    選項 說明
    -A|--adapter=<str> 指示路徑的介面卡。
    -u|--autoassign 系統將自動指派規則識別碼。
    -C|--channel=<long> 指示路徑的通道。
    -c|--claimrule-class=<str> 指示宣告規則類別。

    有效值為：MP, Filter, VAAI。

    -d|--device=<str> 指示裝置 UID。
    -D|--driver=<str> 指示路徑的驅動程式。
    -f|--force 強制宣告規則在任何情況下均略過有效性檢查並安裝規則。
    --if-unset=<str> 如果此進階使用者變數未設定為 1，則執行該命令。
    -i|--iqn=<str> 指示目標的 iSCSI 限定名稱。
    -L|--lun=<long> 指示路徑的 LUN。
    -M|--model=<str> 指示路徑的型號。
    -P|--plugin=<str> 指示是哪個 PSA 外掛程式。(必要)
    -r|--rule=<long> 指示規則識別碼。
    -T|--target=<long> 指示路徑的目標。
    -R|--transport=<str> 指示路徑的傳輸。

    有效值為：block, fc, iscsi, iscsivendor, ide, sas, sata, usb, parallel, unknown。

    -t|--type=<str> 指示用於宣告/取消宣告或宣告規則的符合類型。

    有效值為：vendor, location, driver, transport, device, target。(必要)

    -V|--vendor=<str> 指示路徑的廠商。
    --wwnn=<str> 指示目標的全球節點編號。
    --wwpn=<str> 指示目標的全球連接埠號碼。
  2. 若要將新的宣告規則載入到系統中，請執行下列命令：
    esxcli --server=server_name storage core claimrule load
    此命令會從系統的組態檔中載入所有新建立的多重路徑宣告規則。

範例： 定義多重路徑宣告規則

在下列範例中，您可以新增並載入編號為 500 的規則。該規則會為 NMP 外掛程式宣告型號字串為 NewMod 以及廠商字串為 NewVend 的所有路徑。

# esxcli --server=server_name storage core claimrule add -r 500 -t vendor -V NewVend -M NewMod -P NMP

# esxcli --server=server_name storage core claimrule load

執行 esxcli --server=server_namestorage core claimrule list 命令之後，您可以看到新的宣告規則出現在清單中。

下列輸出指示宣告規則 500 已載入到系統中，且處於作用中狀態。 
Rule Class  Rule   Class    Type       Plugin     Matches
MP          0      runtime  transport  NMP        transport=usb
MP          1      runtime  transport  NMP        transport=sata
MP          2      runtime  transport  NMP        transport=ide
MP          3      runtime  transport  NMP        transport=block
MP          4      runtime  transport  NMP        transport=unknown
MP          101    runtime  vendor     MASK_PATH  vendor=DELL model=Universal Xport
MP          101    file     vendor     MASK_PATH  vendor=DELL model=Universal Xport
MP          500    runtime  vendor     NMP        vendor=NewVend model=NewMod  
MP          500    file     vendor     NMP        vendor=NewVend model=NewMod