使用 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