Befehl "chpath"

Zweck

Ändert den Betriebsstatus von Pfaden in eine MPIO-fähige (Multipath I/O) Einheit oder ändert ein Attribut eines Pfads in eine MPIO-fähige Einheit.

Syntax

chpath -l Name -s OpStatus [ -p Übergeordnet ] [ -w Verbindung ] [ -i PathID ]

Chpath -l Name -p Übergeordnet [ -w Verbindung ] [ -P ] -a Attribut=Wert [ -a Attribut=Wert ... ] [ -g ]

chpath -l Name -i PathID -P ] -a Attribut=Wert [ -a Attribut=Wert ...]

chpath -h

Beschreibung

Der Befehl chpath ändert den Betriebsstatus von Pfaden in die angegebene Einheit (Flag -l Name) oder ein oder mehrere Attribute, die einem bestimmten Pfad zugeordnet sind, in die angegebene Einheit. Die erforderliche Syntax variiert je nach vorgenommener Änderung geringfügig.

Die erste zuvor gezeigte Syntax ändert den Betriebsstatus eines oder mehrerer Pfade in die angegebene Einheit. Die Gruppe der zu ändernden Pfade wird durch einen Abgleich der Pfade anhand der folgenden Kriterien ermittelt:

Die Zieleinheit stimmt mit der angegebenen Einheit überein.
Die übergeordnete Einheit stimmt mit der angegebenen übergeordneten Einheit (-p Übergeordnet), sofern angegeben, überein.
Die Verbindung stimmt mit der angegebenen Verbindung (-w Verbindung), sofern angegeben, überein.
Der Pfadstatus ist PATH_AVAILABLE.

Der Betriebsstatus eines Pfads bezieht sich auf die Verwendung des Pfads bei der MPIO-Pfadauswahl. Der Wert enable gibt an, dass der Pfad verwendet werden soll, wohingegen disable angibt, dass der Pfad nicht verwendet werden soll. Es muss beachtet werden, dass sich die Angabe von disable für einen Pfad auf die künftige Ein-/Ausgabe und nicht auf die bereits in Bearbeitung befindliche Ein-/Ausgabe auswirkt. Ein Pfad kann somit zwar inaktiviert werden, aber weiterhin anstehende Eingabe/Ausgabe haben, aber die tatsächliche Inaktivierung des Pfads findet erst statt, wenn die bereits in Bearbeitung befindliche Eingabe/Ausgabe abgeschlossen ist. Wenn also -s disable für einen Pfad angegeben wird und Ein-/Ausgabe in diesem Pfad ansteht, wird dies ausgegeben.

Das Inaktivieren eines Pfads wirkt sich auf die Pfadauswahl auf Einheitentreiberebene aus. Die path_status-Einstellung des Pfads in der Einheitenkonfigurationsdatenbank wird nicht geändert. Zur Anzeige des aktuellen Betriebsstatus eines Pfads muss der Befehl lspath verwendet werden.

Die zweite zuvor gezeigte Syntax ändert ein oder mehrere pfadspezifische Attribute, die einem bestimmten Pfad zugeordnet sind, in eine bestimmte Einheit. Beachten Sie, dass mehrere Attribute in einem einzigen Aufruf des Befehl chpath geändert werden können. Alle Attribute müssen aber einem einzigen Pfad zugeordnet sein. Anders ausgedrückt, es ist nicht möglich, in einem einzigen Aufruf des Befehls chpath Attribute für mehrere Pfade zu ändern. Wenn Sie Attribute für mehrere Pfade ändern möchten, sind separate Aufrufe des Befehls chpath erforderlich, einer für jeden zu ändernden Pfad.

Flags

Element	Beschreibung
-a Attribut=Wert	Gibt das zu ändernde Attribut und den neuen Wert für das Attribut an. Der Parameter Attribut gibt den Namen eines pfadspezifischen Attributs an. Der Parameter Wert gibt den Wert an, der den aktuellen Wert von Attribut ersetzen soll. Sie können mehrere Instanzen von -a Attribut=Wert angeben, wenn Sie mehrere Attribute ändern möchten.
-G	Erzwingt die Pfadänderungsoperation für eine gesperrte Einheit.
-H	Zeigt den Verwendungshinweis für den Befehl an.
-i PathID	Gibt die ID des Pfads an, der von der Änderung betroffen ist. Dieses Flag wird verwendet, um einen Pfad eindeutig zu identifizieren.
-l Name	Gibt den logischen Einheitennamen der Zieleinheit für die von der Änderung betroffenen Pfade an. Dieses Flag ist in allen Fällen erforderlich.
-p Übergeordnetes Element	Gibt den logischen Einheitennamen der übergeordneten Einheit an, der für die Qualifizierung der zu ändernden Pfade verwendet werden soll. Dieses Flag ist erforderlich, wenn Attribute geändert werden, aber optional, wenn der Betriebsstatus geändert wird.
-P	Ändert die Merkmale des Pfads permanent in der ODM-Objektklasse, ohne den Pfad tatsächlich zu ändern. Die Änderung wirkt sich auf den Pfad aus, wenn der Pfad das nächste Mal dekonfiguriert und anschließend (möglicherweise beim nächsten Bootvorgang) wieder konfiguriert wird.
-w Verbindung	Gibt die Verbindungsinformationen an, die für die Qualifizierung der zu ändernden Pfade verwendet werden sollen. Dieses Flag ist optional, wenn der Betriebsstatus geändert wird. Beim Ändern von Attributen ist dieses Flag optional, wenn die Einheit nur einen einzigen Pfad zur angegebenen übergeordneten Einheit hat. Wenn mehrere Pfade von der übergeordneten Einheit zur Einheit existieren, muss mit diesem Flag der spezifische Pfad, der geändert werden soll, angegeben werden.
-s OpStatus	Gibt den Betriebsstatus an, in den die angegebenen Pfade geändert werden sollen. Der Betriebsstatus eines Pfads wird auf Einheitentreiberebene verwaltet. Er bestimmt, ob der Pfad bei der Pfadauswahl berücksichtigt wird. Die zulässigen Werte für dieses Flag sind im Folgenden beschrieben: aktivieren Setzt den Betriebsstatus für die MPIO-Pfadauswahl auf enabled (aktiviert). Ein Pfad mit diesem Status wird bei der Pfadauswahl berücksichtigt. Beachten Sie, dass die Aktivierung eines Pfads die einzige Möglichkeit ist, einen Pfad mit einem Fehlerzustand (Bedingung failed) wiederherzustellen. disable Setzt den Betriebsstatus für die MPIO-Pfadauswahl auf disabled (inaktiviert). Ein Pfad mit diesem Status wird bei der Pfadauswahl nicht berücksichtigt. Dieses Flag ist erforderlich, wenn der Betriebsstatus geändert wird. Wenn dieses Flag zusammen mit dem Flag -a Attribut=Wert verwendet wird, wird ein Verwendungsfehler generiert.

Sicherheit

Zugriffssteuerung: Dieser Befehl kann nur von Rootbenutzern und Mitgliedern der Gruppe system ausgeführt werden.

Prüfereignisse:

Ereignis	Informationen
DEV_Change	Die chpath-Befehlszeile.

Beispiele

Geben Sie Folgendes ein, um die Pfade zwischen scsi0 und der Platteneinheit hdisk1 zu inaktivieren:
```
chpath -l hdisk1 -p scsi0 -s disable
```
Das System zeigt eine Nachricht ähnlich der folgenden an:
```
paths disabled
```
oder
```
some paths disabled
```
Die erste Nachricht zeigt an, dass alle PATH_AVAILABLE-Pfade von scsi0 zu hdisk1 erfolgreich inaktiviert wurden. Die zweite Nachricht zeigt an, dass nur einige der PATH_AVAILABLE-Pfade von scsi0 zu hdisk1 erfolgreich inaktiviert wurden.

Dateien

Element	Beschreibung
/usr/sbin/chpath	Enthält den Befehl chpath.

Zugehörige Informationen

Befehl lspath , Befehl mkpath , Befehl rmpath .