Commande lspath

Fonction

Afficher les informations sur les chemins d'accès d'une unité compatible MPIO (MultiPath I/O).

Syntaxe

lspath [ -dev NomUnité ] [ -pdev Parent ] [ -status Etat ] [ -conn Connexion ] [ -field NomZone ] [ -fmt Délimiteur ]

lspath -dev NomUnité -pdev Parent [ -conn Connexion ] -lsattr [ -attr Attribut... ]

lspath -dev NomUnité -pdev Parent [ -conn Connexion ] -range -attr Attribut

Description

La commande lspath permet d'afficher l'un des trois types d'informations sur les chemins d'accès d'une unité compatible MPIO. Elle affiche l'état d'exploitation pour un ou plusieurs chemins d'accès à une unité ou elle affiche un ou plusieurs attributs pour un chemin d'accès vers une unité compatible MPIO. La première syntaxe ci-dessus affiche l'état d'exploitation pour un ou plusieurs chemins d'accès vers une unité compatible MPIO donnée. La seconde syntaxe affiche un ou plusieurs attributs pour un chemin d'accès vers une unité compatible MPIO donnée. Enfin, la troisième syntaxe affiche la plage de valeurs possibles d'un attribut pour un chemin d'accès vers une unité compatible MPIO donnée.

Affichage d'états de chemin d'accès à l'aide de la commande lspath

Lorsque vous affichez l'état du chemin d'accès, vous obtenez l'ensemble des chemins à afficher en recherchant, dans la base de données de configuration des unités, les chemins correspondant aux critères suivants :

Le nom de l'unité cible correspond à l'unité spécifiée par l'option -dev. Si vous n'indiquez pas l'option -dev, l'unité cible n'est pas utilisée dans les critères.
Le nom de l'unité parent correspond à l'unité spécifiée par l'option -pdev. Si vous n'indiquez pas l'option -pdev, l'unité parent n'est pas utilisée dans les critères.
La connexion correspond à la connexion spécifiée par l'option -conn. Si vous n'indiquez pas l'option -conn, la connexion n'est pas utilisée dans les critères.
L'état du chemin d'accès correspond à l'état spécifié par l'option -status. Si vous n'indiquez pas l'option -status, l'état du chemin d'accès n'est pas utilisé dans les critères.

Si aucune des options -dev, -pdev, -conn ou -status n'est indiquée, tous les chemins d'accès reconnus par le système sont affichés.

Par défaut, cette commande affiche les informations sous forme de colonne. Si vous n'indiquez aucune option qualifiant les chemins d'accès à afficher, le format de la sortie est :

status device  parent

Les valeurs pouvant apparaître dans la colonne d'état sont les suivantes :

enabled: Indique que le chemin d'accès est configuré et opérationnel. Il sera pris en compte lors de la sélection des chemins d'accès pour les E-S.
disabled: Indique que le chemin d'accès est configuré mais n'est pas opérationnel dans l'immédiat. Il a été désactivé manuellement et ne sera pas pris en compte lors de la sélection des chemins d'accès pour les E-S.
failed: Indique que le chemin d'accès est configuré mais les échecs d'E-S qui se sont produits l'ont rendu inutilisable. Il ne sera pas pris en compte lors de la sélection des chemins d'accès pour les E-S.
defined: Indique que le chemin d'accès n'a pas été configuré dans le pilote de périphérique.
missing: Indique que le chemin d'accès a été défini lors d'un amorçage précédent, mais qu'il n'a pas été détecté lors du dernier amorçage du système.
detected: Indique que le chemin d'accès a été défini lors du dernier amorçage du système, mais il n'a pas été configuré. Un chemin d'accès doit uniquement avoir cet état pendant l'amorçage et, par conséquent, cet état ne doit jamais apparaître comme un résultat de la commande lspath.

Affichage d'attributs de chemin d'accès à l'aide de la commande lspath

Lors de l'affichage d'attributs d'un chemin d'accès, ce dernier doit toujours être entièrement qualifié. Vous pouvez afficher plusieurs attributs d'un chemin d'accès mais les attributs appartenant à plusieurs chemins d'accès ne peuvent pas être affichés à l'aide d'une seule exécution de la commande lspath. Par conséquent, outre les options -lsattr, -dev et -pdev, vous devez indiquer l'option -conn pour identifier de manière unique un chemin d'accès. Par exemple :

s'il n'existe qu'un seul chemin d'accès entre une unité et un parent spécifique, l'option -conn n'est pas requise
s'il existe plusieurs chemins d'accès entre une unité et un parent spécifique, l'option -conn est requise

En outre, l'option -status n'est pas autorisée.

Par défaut, cette commande affiche les informations sous forme de colonne.

attribute   value    description         user_settable

Options

-attr Attribut	Identifie l'attribut spécifique à afficher. L'Attribut' est le nom d'un attribut spécifique du chemin d'accès. Lorsque vous indiquez cette option, seul l'attribut identifié est affiché. Vous pouvez utiliser plusieurs instances de cette option pour répertorier plusieurs attributs. Si vous n'indiquez pas cette option, tous les attributs associés au chemin d'accès identifié seront affichés.
-lsattr	Affiche les noms d'attribut, les valeurs en cours, les descriptions et les valeurs d'option paramétrables pour un chemin d'accès spécifique.
-dev Nom	Indique le nom d'unité logique de l'unité cible dont vous souhaitez afficher les informations de chemin d'accès.
-field NomsZone	Définit la liste des zones à afficher. Les zones suivantes sont prises en charge : status Etat du chemin name Nom de l'unité parent Nom de l'unité parent conn Connexion relative au chemin
-fmt Délimiteur	Indique un caractère de séparation des zones de sortie.
-pdev Parent	Indique le nom d'unité logique de l'unité parent dont vous souhaitez afficher le ou les chemins d'accès.
-range	Affiche les valeurs autorisées pour un nom d'attribut. L'option -range affiche la liste des valeurs d'attribut dans une colonne, comme suit : Valeur1 Valeur2 . . ValeurN L'option -range affiche la plage des valeurs d'attribut sous la forme x...n(+i) où x est le début de la plage, n la fin de la plage et i est l'incrément.
-status Etat	L'option -status Etat indique l'état à utiliser pour la qualification des chemins d'accès à afficher. Lors de l'affichage des informations de chemin d'accès, les valeurs admises pour cette option sont les suivantes : enabled Affiche les chemins d'accès activés (enabled) pour la sélection des chemins MPIO. disabled Affiche les chemins d'accès désactivés (disabled) de la sélection des chemins MPIO. failed Affiche les chemins d'accès en échec (failed) en raison d'erreurs d'E-S. available Affiche les chemins d'accès dont l'état (path_status) est disponible (PATH_AVAILABLE), c'est-à-dire les chemins d'accès configurés dans le système, y compris les chemins à l'état enabled, disabled et failed). defined Affiche les chemins d'accès dont l'état (path_status) est défini (PATH_DEFINED). missing Affiche les chemins d'accès dont l'état (path_status) est manquant (PATH_MISSING).
-conn Connexion	Indique les informations de connexion à utiliser pour la qualification des chemins d'accès à afficher.

Etat de sortie

Code retour	Description
1	Valeur d'état incorrecte.

Exemples

Pour afficher, sans en-tête de colonne, l'ensemble des chemins d'accès dont l'état d'exploitation est désactivé, entrez :
```
lspath -status disabled
```
Le système affiche un message similaire au texte suivant :
```
 disabled  hdisk1   scsi1 
disabled  hdisk2   scsi1 
disabled  hdisk23  scsi8 
disabled  hdisk25  scsi8
```
Pour afficher l'ensemble des chemins d'accès dont l'état d'exploitation est en échec, entrez :
```
 lspath -status failed
```
Le système affiche un message similaire au texte suivant :
```
  failed  hdisk1   scsi1 
failed  hdisk2   scsi1 
failed  hdisk23  scsi8 
failed  hdisk25  scsi8
```
Si l'unité cible est un disque SCSI, pour afficher tous les attributs pour le chemin d'accès du parent scsi0 à la connexion 5,0, utilisez la commande :
```
 lspath -dev hdisk10 -pdev scsi0 -conn "5,0" -lsattr
```
Le système affiche un message similaire au texte suivant :
```
weight     1      Order of path failover selection  true
```

Rubriques connexes

Commandes lsmap, mkpath, chpath et rmpath.

Envoyer un commentaire | Evaluer la page