Verwenden Sie die esxcli-Befehle, um dem Satz der Beanspruchungsregeln im System eine Multipathing-PSA-Beanspruchungsregel hinzuzufügen. Zur Aktivierung der neuen Beanspruchungsregeln müssen Sie diese zunächst definieren und dann in Ihr System laden.

Beispiele für das Hinzufügen einer PSA-Beanspruchungsregel:
  • Sie laden ein neues Multipathing-Plug-In (MPP) von einem Drittanbieter und müssen die Pfade, die dieses Modul beansprucht, definieren.
  • Sie müssen das native HPP aktivieren.
Warnung: Sie können keine Regeln erstellen, bei denen zwei verschiedene Plug-Ins Pfade zum selben Gerät beanspruchen. Ihre Versuche, diese Beanspruchungsregeln zu erstellen, scheitern mit einer Warnung in der Datei vmkernel.log.

Voraussetzungen

Installieren Sie vCLI oder stellen Sie die virtuelle vSphere Management Assistant (vMA)-Maschine bereit. Siehe Erste Schritte mit vSphere Command-Line Interfaces. Führen Sie zwecks Fehlerbehebung esxcli-Befehle in der ESXi Shell aus.

Prozedur

  1. Verwenden Sie zum Definieren einer neuen Beanspruchungsregel den folgenden Befehl:
    esxcli storage core claimrule add

    Der Befehl verfügt über die folgenden Optionen:

    Option Beschreibung
    -A|--adapter=<adapter> Adapter der zu verwendenden Pfade. Nur gültig, wenn --type gleich location ist.
    -u|--autoassign Fügt eine Beanspruchungsregel basierend auf deren Merkmale hinzu. Die Regelnummer ist nicht erforderlich.
    -C|--channel=<channel> Kanal der zu verwendenden Pfade. Nur gültig, wenn --type gleich location ist.
    -c|--claimrule-class=<cl> Die Beanspruchungsregel-Klasse, die für diesen Vorgang verwendet werden soll. Sie können MP (Standard) Filter oder VAAI angeben.

    Um Hardwarebeschleunigung für einen neuen Array zu konfigurieren, fügen Sie zwei Beanspruchungsregeln hinzu, eine für den VAAI-Filter und eine andere für das VAAI-Plug-In. Detaillierte Anweisungen finden Sie unter Hinzufügen von Hardwarebeschleunigungs-Beanspruchungsregeln.

    -d|--device=<device_uid> UID des Geräts. Nur gültig, wenn --type gleich device ist.
    -D|--driver=<driver> Treiber für den HBA der zu verwendenden Pfade. Nur gültig, wenn --type gleich driver ist.
    -f|--force Erzwingt, dass Beanspruchungsregeln Gültigkeitsprüfungen ignorieren und die Regel in jedem Fall installieren.
    --force-reserved Überschreibschutz für reservierte Regel-ID-Bereiche.

    Reservierte Beanspruchungsregeln sind Regeln mit einer ID unter 100. Sie können sie dazu verwenden, bestimmten Plug-Ins lokale Geräte neu zuzuordnen, z. B. das NVMe-Gerät dem HPP.

    --if-unset=<str> Führen Sie diesen Befehl aus, falls diese erweiterte Benutzervariable nicht auf 1 festgelegt ist.
    -i|--iqn=<iscsi_name> iSCSI Qualified Name für das Ziel. Nur gültig, wenn --type gleich target ist.
    -L|--lun=<lun_id> LUN der Pfade. Nur gültig, wenn --type gleich location ist.

    Wert der LUN-ID darf nicht höher sein als der Wert der erweiterten Konfigurationsoption /Disk/MaxLUN.

    -M|--model=<model> Modell der zu verwendenden Pfade. Nur gültig, wenn --type gleich vendor ist.

    Gültige Werte sind Werte für die Modellzeichenfolge aus der SCSI-Anfragezeichenfolge. Führen Sie auf jedem Gerät vicfg-scsidevs <conn_options> -l aus, um Werte für die Modellzeichenfolge anzuzeigen.

    -P|--plugin=<plugin> Zu verwendendes PSA-Plug-In. Die möglichen Werte sind NMP, MASK_PATH oder HPP. Drittanbieter können auch ihr eigenes PSA-Plug-In bereitstellen. Erforderlich.
    -r|--rule=<rule_ID> Zu verwendende Regel-ID. Die Regel-ID gibt die Reihenfolge an, in der die Beanspruchungsregel ausgewertet werden soll. Benutzerdefinierte Beanspruchungsregeln werden in numerischer Reihenfolge ihrer IDs, beginnend mit 101, ausgewertet.

    Sie können den Befehl esxcli storage core claimrule list ausführen , um zu ermitteln, welche Regel-IDs verfügbar sind.

    -T|--target=<target> Ziel der zu verwendenden Pfade. Nur gültig, wenn --type gleich location ist.
    -R|--transport=<transport>

    Transport der zu verwendenden Pfade. Nur gültig, wenn --type gleich transport ist. Folgende Werte werden unterstützt:

    • block – Blockspeicher
    • fc – Fibre Channel
    • iscsivendor – iSCSI
    • iscsi – wird derzeit nicht verwendet
    • ide – IDE-Speicher
    • sas – SAS-Speicher
    • sata – SATA-Speicher
    • usb – USB-Speicher
    • parallel – Parallel
    • fcoe – FCoE
    • unknown
    -t|--type=<type> Art des für den Vorgang zu verwendenden Abgleichs. Gültige Werte sind die folgenden. Erforderlich.
    • vendor
    • location
    • driver
    • transport
    • device
    • target
    -V|--vendor=<vendor> Anbieter der zu verwendenden Pfade. Nur gültig, wenn --type gleich vendor ist.

    Gültige Werte sind Werte für die Herstellerzeichenfolge aus der SCSI-Abfragezeichenfolge. Führen Sie auf jedem Gerät vicfg-scsidevs <conn_options> -l aus, um Werte für die Herstellerzeichenfolge anzuzeigen.

    --wwnn=<wwnn> World Wide Node Number für das Ziel.
    --wwpn=<wwpn> World Wide Port Number für das Ziel.
    -a|--xcopy-use-array-values Verwenden Sie die vom Array übermittelten Werte zum Konstruieren des XCOPY-Befehls, der an das Speicher-Array gesendet werden soll. Dies betrifft nur VAAI-Beanspruchungsregeln.
    -s|--xcopy-use-multi-segs Verwenden Sie mehrere Segmente, wenn Sie eine XCOPY-Anforderung übermitteln. Nur gültig, wenn --xcopy-use-array-values angegeben ist.
    -m|--xcopy-max-transfer-size Maximale Datenübertragungsgröße in MB, wenn Sie eine andere Übertragungsgröße als die vom Array gemeldete verwenden. Nur gültig, wenn --xcopy-use-array-values angegeben ist.
    -k|--xcopy-max-transfer-size-kib Maximale Übertragungsgröße in KiB für die XCOPY-Befehle, wenn Sie eine andere Übertragungsgröße als die vom Array gemeldete verwenden. Nur gültig, wenn --xcopy-use-array-values angegeben ist.
  2. Verwenden Sie den folgenden Befehl, um die neue Beanspruchungsregel in Ihr System zu laden:
    esxcli storage core claimrule load
    Dieser Befehl lädt alle neu erstellten Multipathing-Beanspruchungsregeln aus der Konfigurationsdatei esx.conf in den VMkernel. Der Befehl hat keine Optionen.
  3. Um geladene Beanspruchungsregeln anzuwenden, verwenden Sie den folgenden Befehl:
    esxcli storage core claimrule run

    Der Befehl verfügt über die folgenden Optionen:

    Option Beschreibung
    -A|--adapter=<adapter> Wenn --type gleich location ist, der Name des HBAs für die Pfade, auf die die Beanspruchungsregeln angewendet werden sollen. Um Beanspruchungsregeln auf Pfade von allen Adaptern anzuwenden, lassen Sie diese Option weg.
    -C|--channel=<channel> Wenn --type gleich location ist, der Wert der SCSI-Kanalnummer für die Pfade, auf die die Beanspruchungsregeln angewendet werden sollen. Um Beanspruchungsregeln auf Pfade mit beliebiger Kanalnummer anzuwenden, lassen Sie diese Option weg.
    -c|--claimrule-class=<cl> Die Beanspruchungsregel-Klasse, die für diesen Vorgang verwendet werden soll.
    -d|--device=<device_uid> UID des Geräts.
    -L|--lun=<lun_id> Wenn --type gleich location ist, der Wert der SCSI-LUN für die Pfade, auf die die Beanspruchungsregeln angewendet werden sollen. Um Beanspruchungsregeln auf Pfade mit beliebiger LUN anzuwenden, lassen Sie diese Option weg.
    -p|--path=<path_uid> Wenn --type gleich path ist, zeigt diese Option die eindeutige Pfad-ID (UID) oder den Laufzeitnamen eines Pfads an, auf den die Beanspruchungsregeln angewendet werden sollen.
    -T|--target=<target> Wenn --type gleich location ist, der Wert der SCSI-Zielnummer für die Pfade, auf die die Beanspruchungsregeln angewendet werden sollen. Um Beanspruchungsregeln auf Pfade mit beliebiger Zielnummer anzuwenden, lassen Sie diese Option weg.
    -t|--type=<location|path|all> Typ der durchzuführenden Beanspruchung. Verwendet standardmäßig all, d. h., die Beanspruchungsregeln werden ohne Beschränkung auf bestimmte Pfade oder SCSI-Adressen angewendet. Gültige Werte sind location, path und all.
    -w|--wait Sie können diese Option nur dann verwenden, wenn Sie auch --type all verwenden.

    Wenn die Option einbezogen wird, wartet der Beanspruchungsprozess vor dem Ausführen des Beanspruchungsvorgangs darauf, dass zu beanspruchende Pfade gefunden werden. In diesem Fall startet das System den Beanspruchungsprozess erst dann, wenn es wahrscheinlich ist, dass alle Pfade im System erkannt sind, bevor es den Prozess gestartet hat.

    Nach dem Starten des Beanspruchungsprozesses kehrt der Befehl erst zurück, wenn die Geräteregistrierung abgeschlossen ist.

    Wenn Sie während des Beanspruchungs- oder Erkennungsprozesses Pfade hinzufügen oder entfernen, funktioniert diese Option möglicherweise nicht korrekt.

Beispiel: Definieren von Multipathing-Beanspruchungsregeln

Im folgenden Beispiel fügen Sie Regel Nummer 500 hinzu und laden diese. Die Regel beansprucht alle Pfade mit der Modellzeichenfolge „NewMod“ und der Herstellerzeichenfolge „NewVend“ für das NMP-Plug-In.

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

# esxcli storage core claimrule load

Nachdem Sie den Befehl esxcli storage core claimrule list ausgeführt haben, wird die neue Beanspruchungsregel in der Liste angezeigt.

Die folgende Ausgabe gibt an, dass die Beanspruchungsregel 500 in das System geladen wurde und aktiv ist.
Rule Class  Rule   Class    Type       Plugin     Matches
...         ...    ...      ...        ...        ...
MP          500    runtime  vendor     NMP        vendor=NewVend model=NewMod  
MP          500    file     vendor     NMP        vendor=NewVend model=NewMod