Befehl "mkpath"

Zweck

Fügt dem System einen anderen Pfad zu einer MPIO-fähigen Einheit hinzu.

Syntax

mkpath [ -l Name ] [ -p Übergeordnet ] [ -w Verbindung ] [ -i PathID

mkpath [ -l Name ] [ -p Übergeordnetes Element ] [ -w Verbindung ] [ -d

mkpath -h

Beschreibung

Der Befehl mkpath definiert einen oder mehrere Pfade zur Zieleinheit (-l Name) und konfiguriert diese möglicherweise. Die Pfade werden durch eine Kombination der Flags -l Name, -pÜbergeordnet und -w Verbindung identifiziert. Sowohl die Zieleinheit als auch die übergeordnete Einheit müssen zuvor im System definiert werden, um einen Pfad zu definieren. Beide müssen verfügbar sein, um einen Pfad konfigurieren zu können.

Wenn das Flag -d angegeben ist, definiert der Befehl mkpath nur die neue Pfaddefinition für das System. Wenn das Flag -d nicht angegeben ist, versucht der Befehl mkpath, den Pfad zu definieren, falls er nicht bereits vorhanden ist, bevor er versucht, den Pfad zu konfigurieren. Zur Konfiguration eines Pfads muss der Pfad bereits definiert sein und sowohl die Einheit als auch die übergeordnete Einheit müssen bereits konfiguriert sein.

Der Befehl mkpath zeigt nach Abschluss eine Statusnachricht an. Es ist möglich, dass einige Pfade konfiguriert werden und bei anderen die Konfiguration fehlschlägt.

Beachten Sie, dass für jede Einheit, die nicht manuell mit dem Befehl mkdev definiert werden kann, Pfade nicht manuell für die Verwendung des Befehls mkpath definiert werden können. Diese Einschränkungen sind auf die Art und Weise zurückzuführen, in der die Pfadinformationen für diese Einheiten gespeichert werden. Zu dieser Kategorie gehören Fibre Channel-Einheiten.

Der Befehl mkpath gibt Statusnachrichten zu den Ergebnissen der Operation aus. Es werden Nachrichten in einem der folgenden Formate generiert:

Pfad [ available | defined ]: Diese Nachricht wird angezeigt, wenn mkpath in einem einzigen Pfad ausgeführt wird. Wenn der Pfad erfolgreich konfiguriert wurde, wird die Nachricht "path available" angezeigt. Wenn der Pfad nicht erfolgreich konfiguriert wurde und kein expliziter Fehlercode von der Methode zurückgegeben wird, wird die Nachricht "path defined" angezeigt.
paths available: Diese Nachricht wird angezeigt, wenn mehrere Pfade gefunden und alle Pfade erfolgreich konfiguriert wurden.
some paths available: Diese Nachricht wird angezeigt, wenn mehrere Pfade identifiziert wurden, aber nur einige erfolgreich konfiguriert wurden.
no paths processed: Diese Nachricht wird generiert, wenn keine Pfade gefunden wurden, die den Auswahlkriterien entsprechen.

Flags

Element	Beschreibung
-d	Definiert einen neuen Pfad zu einer Einheit, indem dem System eine Pfaddefinition hinzugefügt wird. Der neue Pfad wird nicht automatisch konfiguriert, wenn das Flag -d angegeben ist. Beachten Sie, dass jeweils nur ein Pfad definiert werden kann.
-H	Zeigt den Verwendungshinweis für den Befehl an.
-i PathID	Gibt die Pfad-ID an, die dem hinzuzufügenden Pfad zugeordnet ist, und dient der eindeutigen Identifizierung eines Pfads. Dieses Flag kann nicht zusammen mit dem Flag -d verwendet werden.
-l Name	Gibt den logischen Einheitennamen der Zieleinheit an, der die Pfade hinzugefügt werden. Die hinzuzufügenden Pfade werden mit den Flags -p und -w qualifiziert.
-p Übergeordnetes Element	Gibt den logischen Einheitennamen der übergeordneten Einheit an, die den hinzuzufügenden Pfaden zugeordnet ist. Dieses Flag ist erforderlich, wenn das Flag -d angegeben ist.
-w Verbindung	Gibt die Verbindungsinformationen an, die dem hinzuzufügenden Pfad zugeordnet sind. Dieses Flag ist erforderlich, wenn das Flag -d angegeben ist.

Sicherheit

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

Prüfereignisse:

Ereignis	Informationen
DEV_Change	mkpath, Definieren,<define method arguments>
DEV_Change	mkpath, Konfigurieren,<configure method arguments>

Beispiele

Geben Sie Folgendes ein, um einen bereits definierten Pfad zwischen scsi0 und der Einheit "hdisk1" an SCSI-ID 5 und LUN 0 (d. h. Verbindung 5,0) zu definieren und zu konfigurieren:
```
mkpath -l hdisk1 -p scsi0 -w 5,0
```
Das System zeigt eine Nachricht wie die folgende an:
```
path available
```
Verwenden Sie den folgenden Befehl, wenn Sie einen bereits definierten Pfad von fscsi0 zur Fibre Channel-Platte hdisk1 konfigurieren möchten:
```
mkpath -l hdisk1 -p fscsi0
```
Die Nachricht gleicht der folgenden:
```
path available
```
Geben Sie Folgendes ein, um der Objektklasse "Customized Paths" nur eine Pfaddefinition zwischen scsi0 und der Platteneinheit hdisk1 an SCSI-ID 5 und LUN 0 hinzuzufügen:
```
mkpath -d -l hdisk1 -p scsi0 -w 5,0
```
Das System zeigt eine Nachricht wie die folgende an:
```
path defined
```

Dateien

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