Commande chpath

Objectif

Modifie le statut opérationnel des chemins d'accès à une unité compatible MPIO ( MultiPath I/O) ou modifie un attribut associé à un chemin d'accès à une unité compatible MPIO.

Syntaxe

chpath -l Nom -s OpStatus [ -p Parent ] [ -w Connexion ] [ -i PathID ]

chpath -l Nom -p Parent [ -w Connexion ] [ -P ] -a Attribut=Valeur [ -a Attribut=Valeur ... ] [ -g ]

chpath -l Nom -i PathID [ -P ] -a Attribut=Valeur [ -a Attribut=Valeur ... ]

chpath -h

Descriptif

La commande chpath modifie l'état opérationnel des chemins d'accès à l'unité spécifiée (indicateur -l Nom ) ou modifie un ou plusieurs attributs associés à un chemin d'accès spécifique à l'unité spécifiée. La syntaxe requise diffère légèrement en fonction de la modification apportée.

La première syntaxe illustrée ci-dessus permet de modifier l'état opérationnel d'un ou de plusieurs chemins d'accès vers une unité spécifique. L'ensemble des chemins d'accès à modifier répond aux critères ci-après :

L'unité cible correspond à celle qui a été spécifiée.
L'unité parent correspond au parent spécifié (-p Parent), si un parent est spécifié.
La connexion correspond à la connexion spécifiée (-w Connexion), si une connexion est spécifiée.
Le statut du chemin d'accès est PATH_AVAILABLE.

L'état opérationnel d'un chemin d'accès fait référence à l'utilisation de celui-ci et fait partie de la sélection de chemin d'accès MPIO. La valeur de enable indique que le chemin doit être utilisé tandis que disable indique que le chemin ne doit pas être utilisé. Il est à noter que la définition d'un chemin d'accès sur disable a un impact sur les E-S futures, et non sur les E-S déjà en cours. De ce fait, un chemin d'accès peut être désactivé, mais disposera d'entrées-sorties en suspens tant que toutes celles en cours ne seront pas terminées. Par conséquent, si -s disable est spécifié pour un chemin et que des entrées-sorties sont en attente sur le chemin, ce fait est généré.

La désactivation d'un chemin d'accès affecte la sélection de chemin d'accès au niveau du pilote de périphérique. La valeur path_status du chemin d'accès n'est pas modifiée dans la base de données de configuration des unités. La commande lspath doit être utilisée pour afficher l'état opérationnel en cours d'un chemin d'accès.

La seconde syntaxe illustrée ci-dessus permet de modifier un ou plusieurs attributs associés à un chemin d'accès spécifique vers une unité particulière. Notez que plusieurs attributs peuvent être modifiés en appelant une seule fois la commande chpath, mais la totalité des attributs doit être associée à un seul chemin d'accès. En d'autres termes, vous ne pouvez pas modifier des attributs de plusieurs chemins d'accès en appelant une seule fois la commande chpath. Un appel de la commande chpath doit être effectué pour chacun des chemins d'accès devant être modifiés.

Indicateurs

Article	Descriptif
-a Attribut=Valeur	Permet d'identifier l'attribut à modifier et la nouvelle valeur à lui affecter. Attribut est le nom d'un attribut spécifique au chemin. La Valeur est la valeur qui doit remplacer la valeur en cours de l' attribut. Plusieurs instances de -a Attribut=Valeur peuvent être spécifiées afin de modifier plusieurs attributs.
-g	Force l'opération de changement de chemin à être effectuée sur une unité verrouillée.
-h	Affiche le message d'utilisation de la commande.
-i PathID	Indique l'ID du chemin d'accès affecté par la modification. Cet indicateur est utilisé pour identifier de manière unique un chemin.
-l Nom	Permet de préciser le nom d'unité logique de l'unité cible pour le ou les chemins d'accès concernés par la modification. Cette option est obligatoire dans tous les cas.
-p Parent	Permet de préciser le nom d'unité logique de l'unité mère à utiliser lors de la qualification des chemins d'accès à modifier. Cette option est obligatoire lors de la modification des attributs, mais facultative lors de la modification de l'état opérationnel.
-P	Modifie définitivement les caractéristiques du chemin dans la classe d'objets ODM sans réellement modifier le chemin. La modification prend effet sur le chemin la prochaine fois que le chemin est déconfiguré, puis configuré (éventuellement lors de l'amorçage suivant).
-w Connexion	Permet de préciser les informations de connexion à utiliser lors de la qualification des chemins d'accès à modifier. Cet indicateur est facultatif en cas de modification de l'état opérationnel. En cas de modification des attributs, elle est facultative si l'unité ne contient qu'un seul chemin d'accès vers le parent indiqué. S'il existe plusieurs chemins d'accès entre le parent et l'unité, cette option est obligatoire afin d'identifier le chemin d'accès spécifique à modifier.
-s OpStatus	Permet d'indiquer l'état opérationnel auquel doivent passer les chemins d'accès spécifiés. L'état opérationnel d'un chemin d'accès est géré au niveau du pilote de périphérique. Il détermine si le chemin sera pris en compte lors de la sélection du chemin. Les valeurs admises pour cet indicateur sont les suivantes : activer Marquez le statut opérationnel comme activé pour la sélection de chemin MPIO. Lors de la sélection de chemin d'accès, un chemin d'accès activé pourra être utilisé. Notez que l'activation d'un chemin est le seul moyen de récupérer un chemin à partir d'une condition failed . désactiver Marquez le statut opérationnel comme désactivé pour la sélection de chemin MPIO. Lors de la sélection de chemin d'accès, un chemin d'accès désactivé ne pourra pas être utilisé. Cette option est obligatoire en cas de modification de l'état opérationnel. Lorsqu'elle est utilisée avec l'indicateur -a Attribut=Valeur , une erreur d'utilisation est générée.

Security

Contrôle des privilèges: seuls l'utilisateur root et les membres du groupe system ont un accès en exécution à cette commande.

Evénements d'audit :

Evénement	Informations
DEV_Change	Ligne de commande chpath .

Exemples

Pour désactiver les chemins d'accès entre scsi0 et l'unité de disques hdisk1, entrez :
```
chpath -l hdisk1 -p scsi0 -s disable
```
Le système affiche un message similaire à celui-ci :
```
paths disabled
```
ou
```
some paths disabled
```
Le premier message indique que tous les chemins PATH_AVAILABLE de scsi0 à hdisk1 ont été désactivés. Le deuxième message indique que seuls certains des chemins PATH_AVAILABLE de scsi0 à hdisk1 ont été désactivés.

Fichiers

Article	Descriptif
/usr/sbin/chpath	Contient la commande chpath .

Informations connexes

La commande lspath , la commande mkpath , la commande rmpath .