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
- 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. |
- 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.
- 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