Mandato chpath
Finalidad
Cambia el estado operativo de las vías de acceso a un dispositivo con capacidad para
E/S multivía (MPIO), o cambia un atributo asociado con una vía de acceso a un dispositivo
con capacidad para MPIO.
Sintaxis
chpath -dev Nombre -op EstadoOp [
-pdev Padre ] [
-conn Conexión ]
chpath -dev Nombre -pdev Padre [
-conn Conexión ] [
-perm ] -attr Atributo=Valor...
Descripción
El mandato chpath cambia el estado operativo de las vías de
acceso al dispositivo especificado (el distintivo -dev Nombre) o cambia uno o varios atributos asociados con una vía de
acceso específica al dispositivo especificado. La sintaxis necesaria es ligeramente
diferente en función del cambio realizado.
La primera sintaxis mostrada anteriormente cambia el estado operativo de una o varias
vías de acceso a un dispositivo específico. El conjunto de vías de acceso que deben
cambiarse se obtiene tomando el conjunto de vías de acceso coincidentes con los
siguientes criterios:
- El dispositivo destino coincide con el dispositivo especificado.
- El dispositivo padre coincide con el padre especificado (-pdev Padre), si se ha especificado el padre.
- La conexión coincide con la conexión especificada (-conn Conexión), si se ha especificado la conexión.
- El estado de la vía de acceso es PATH_AVAILABLE
El estado operativo de una vía de acceso hace referencia a la utilización de la misma
como parte de la selección de vías MPIO. El valor de enable indica
que la vía de acceso debe utilizarse, mientras que disable indica que la vía no debe
utilizarse. Debe tener en cuenta que el hecho de establecer una vía en disable
influye sobre la E/S futura, no sobre la E/S que ya está en proceso. Así, una vía de
acceso puede estar inhabilitada pero seguir teniendo E/S significativa hasta el momento
en que toda la E/S que ya estaba en proceso se haya completado. Por ello, si se
especifica -op disable para una vía de acceso y existe E/S
significativa en la vía de acceso, se visualizará este hecho.
La inhabilitación de una vía de acceso afecta a la selección de vías a nivel de
controlador de dispositivos. El indicador path_status (estado de vía) de la vía no cambia en la base de datos de
configuración del dispositivo. Debe utilizarse el mandato lspath
para visualizar el estado operativo actual de la vía de acceso.
La segunda sintaxis mostrada anteriormente cambia uno o varios atributos específicos
de vía de acceso asociados con una vía determinada a un dispositivo específico. Tenga en
cuenta que pueden cambiarse varios atributos en una sola invocación del mandato
chpath, pero todos los atributos deben estar asociados con una
única vía. En otras palabras, no puede cambiar atributos de varias vías en una sola
invocación del mandato chpath. Para cambiar atributos de varias
vías, son necesarias invocaciones separadas de chpath, una para cada una de las vías que deban cambiarse.
Distintivos
| -attr Atributo=Valor |
Identifica el atributo que debe cambiarse y el valor nuevo del
atributo. El Atributo es el nombre de un atributo específico de vía de acceso.
El Valor es el valor que debe sustituir al valor actual del Atributo. El parámetro
Atributo=Valor puede utilizar uno o varios pares atributo-valor
para un distintivo -attr. Si utiliza un distintivo -attr con varios pares
atributo-valor, la lista de pares debe especificarse entre apóstrofos con espacios en
blanco entre los pares. Por ejemplo, si especifica -attr Atributo=Valor se listará un par atributo-valor por distintivo, mientras que si
especifica -attr 'Atributo1=Valor1 Atributo2=Valor2' se listará más
de un par atributo-valor. |
| -dev Nombre |
Especifica el nombre de dispositivo lógico del dispositivo destino
de las vías afectadas por el cambio. Este distintivo es obligatorio en todos los casos. |
| -pdev Padre |
Indica el nombre de dispositivo lógico del dispositivo padre que
debe utilizarse al calificar las vías de acceso que deben cambiarse. Este distintivo es
obligatorio al cambiar atributos, pero es opcional al cambiar el estado operativo. |
| -perm |
Cambia las características de la vía sin cambiar realmente la vía
de acceso. El cambio entrará en vigor en la vía la próxima vez que se desconfigure y
luego se configure (posiblemente durante el próximo inicio). |
| -conn Conexión |
Indica la información de conexión que
debe utilizarse al calificar las vías de acceso que deben cambiarse. Este distintivo es
opcional al cambiar el estado operativo.
Al cambiar atributos, es opcional si el dispositivo sólo tiene una vía al padre indicado. Si
hay varias vías de acceso desde el padre al dispositivo, este distintivo es obligatorio
para identificar la vía específica que se cambia. |
| -op EstadoOp |
Indica el estado operativo al que deben cambiarse las vías de
acceso indicadas. El estado operativo de una vía de acceso se mantiene a nivel de
controlador de dispositivo. Determina si la vía se tendrá en cuenta al realizar la
selección de vías. Los valores permitidos para este distintivo son:
- enable
- Marca el estado operativo como habilitado para la selección de vías MPIO. Una vía
con este estado se considerará apta para el uso al realizar la selección de vías.
Tenga en cuenta que la habilitación de una vía es el único modo de recuperar una vía de
una condición anómala.
- disable
- Marca el estado operativo como inhabilitado para la selección de vías MPIO. Una vía
con este estado no se considerará apta para el uso al realizar la selección de vías.
Este distintivo es obligatorio al cambiar el estado operativo.
Si se utiliza junto con el distintivo -attr
Atributo=Valor, se genera un error de utilización. |
Estado de salida
Consulte Estado de salida de los mandatos del servidor de E/S virtual.
Ejemplos
- Para inhabilitar las vías de acceso entre scsi0 y el
dispositivo de disco hdisk1, especifique:
chpath -dev hdisk1 -pdev scsi0 -op disable
El sistema visualiza un mensaje similar a uno de los siguientes:
paths disabled
o bien
some paths disabled
El primer mensaje indica que
todas las vías de acceso cuyo estado era PATH_AVAILABLE de
scsi0 a hdisk1 se han inhabilitado satisfactoriamente.
El segundo mensaje indica que sólo algunas de las vías cuyo estado era
PATH_AVAILABLE de scsi0 a
hdisk1 se han inhabilitado satisfactoriamente.
Información relacionada
Los mandatos cfgdev,
chdev,
lsdev,
lsmap,
lspath,
mkpath ,
mkvdev,
rmdev y
rmpath.