Commande chpath

Fonction

Modifie l'état opérationnel des chemins d'accès d'une unité MPIO (MultiPath I/O), ou un attribut associé à un chemin d'accès vers une unité MPIO.

Syntaxe

chpath -dev Nom -op EtatOp [ -pdev Parent ] [ -conn Connexion ]

chpath -dev Nom -pdev Parent [ -conn Connexion ] [ -perm ] -attr Attribut=Valeur...

Description

La commande chpath permet de modifier l'état opérationnel des chemins d'accès vers l'unité spécifiée (option -dev Nom) ou de modifier un ou plusieurs attributs associés à un chemin d'accès particulier vers 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'é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 enable indique que le chemin d'accès doit être utilisé, alors que "disable" indique qu'il ne doit pas l'être. Il convient de noter qu'attribuer la valeur "disable" à un chemin d'accès a un impact sur les entrées-sorties ultérieures, et non sur les entrée-sorties 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. Si -op disable est spécifié pour un chemin d'accès et qu'une entrée-sortie est en suspens sur ce chemin d'accès, cela sera affiché.

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.

Options

-attr 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 d'accès. "Valeur" est la valeur qui doit remplacer la valeur en cours de l'attribut. Le paramètre Attribut=Valeur peut utiliser une ou plusieurs paires valeur-attribut pour une option -attr. Si vous utilisez une option -attr avec plusieurs paires valeur-attribut, la liste des paires doit être placée entre guillemets avec des espaces entre chaque paire. Par exemple, -attr Attribut=Valeur permet de lister une paire attribut-valeur par option, alors que -attr 'Attribut1=Valeur1 Attribut2=Valeur2' permet d'en lister plusieurs.
-dev 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.
-pdev 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.
-perm Permet de modifier les caractéristiques du chemin d'accès sans réellement modifier le chemin d'accès. La modification prend effet suite à la la déconfiguration puis à la reconfiguration du chemin d'accès (éventuellement au réamorçage suivant).
-conn Connexion Permet de préciser les informations de connexion à utiliser lors de la qualification des chemins d'accès à modifier. Cette option est facultative 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.
-op EtatOp 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 d'accès va être pris en compte lors de la sélection de chemin d'accès. Les valeurs admises pour cette option sont les suivantes :
enable
L'état opérationnel est activé pour la sélection de chemin d'accès 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 d'accès est le seul moyen de récupérer un chemin d'accès qui a échoué.
disable
L'état opérationnel est désactivé pour la sélection de chemin d'accès 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 conjointement avec l'option -attr Attribut=Valeur, une erreur de syntaxe est générée.

Etat de sortie

Pour plus d'informations, voir Etat de sortie des commandes liées au serveur d'E-S virtuel.

Exemples

  1. Pour désactiver les chemins d'accès entre scsi0 et l'unité de disque hdisk1, entrez : 
    chpath -dev hdisk1 -pdev scsi0 -op disable
    Le système affiche un message similaire à celui-ci : 
    paths disabled
    ou 
    some paths disabled
    Le premier message indique que la désactivation de tous les chemins d'accès PATH_AVAILABLE de scsi0 à hdisk1 a abouti. Le second message indique que certains chemins d'accès PATH_AVAILABLE de scsi0 à hdisk1 uniquement ont été désactivés avec succès.

Rubriques connexes

Commandes cfgdev, chdev, lsdev, lsmap, lspath, mkpath, mkvdev, rmdev et rmpath.

Envoyer un commentaire | Evaluer la page