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

開始之前

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

執行這項作業的原因和時機

舉例來說,當載入新的多重路徑外掛程式 (MPP) 並需要定義此模組應宣告的路徑時,就會新增 PSA 宣告規則。如果新增路徑並需要用現有的 MPP 對它們進行宣告,則可能需要建立宣告規則。

警告︰

在建立新宣告規則時,請注意避免出現下列情況:不同的 MPP 對相同 LUN 宣告不同的實體路徑。除非其中某個 MPP 是 MASK_PATH MPP,否則,此組態將造成效能問題。

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

程序

  1. 若要定義新宣告規則,請執行下列命令:

    esxcli --server=server_name storage core claimrule add

    該命令採用下列選項:

    選項

    說明

    -A|--adapter=<str>

    指示此作業中要使用的路徑的介面卡。

    -u|--autoassign

    系統將自動指派規則識別碼。

    -C|--channel=<long>

    指示此作業中要使用的路徑的通道。

    -c|--claimrule-class=<str>

    指示此作業中要使用的宣告規則類別。

    有效值為:MP、篩選器和 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 命令之後,您可以看到新的宣告規則出現在清單中。

備註︰

宣告規則的兩行,一行中的「Class」為 runtime,另一行中的「Class」為 file,指示新宣告規則已載入到系統中且處於作用中。

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