Comando chpath

Propósito

Altera o status operacional de caminhos para um dispositivo compatível com MultiPath I/O (MPIO) ou altera um atributo associado a um caminho para um dispositivo compatível com MPIO.

Sintaxe

chpath -Eu Nome -s OpStatus [ -p Pai ] [ -w Conexão ] [ -i PathID ]

chpath -l Nome -p Pai [ -w Conexão ] [ -P ] -a Atributo=Valor [ -a Atributo=Valor ... ] [ -g ]

chpath -l Nome -i PathID [ -P ] -a Atributo=Valor [ -a Atributo=Valor ...]

chpath -h

Descrição

O comando chpath altera o status operacional de caminhos para o dispositivo especificado (a bandeira -l Name ) ou ele altera um, ou mais, atributos associados a um caminho específico para o dispositivo especificado. A sintaxe requerida é um pouco diferente dependendo da mudança que está sendo feita.

A primeira sintaxe mostrada acima altera o status operacional de um ou de mais caminhos para um dispositivo específico. O conjunto de caminhos a serem alterados é obtido utilizando-se o conjunto de caminhos que correspondem aos critérios a seguir:

O dispositivo de destino corresponde ao dispositivo especificado.
O dispositivo pai corresponde ao pai especificado (-p Pai), se um pai é especificado.
A conexão corresponde à conexão especificada (-w Connection), se uma conexão for especificada.
O status do caminho é PATH_AVAILABLE.

O status operacional de um caminho refere-se ao uso do caminho como parte da seleção de caminho MPIO. O valor de ativar indica que o caminho deve ser usado enquanto desativar indica que o caminho não deve ser usado. Deve-se notar que a configuração de um caminho para desativar impacta a E/S futura, não a E/S já em andamento. Sendo assim, um caminho pode estar desativado, mas ainda ter E/S pendente até o momento em que toda a E/S que já estava em andamento ser concluída. Como tal, se -s desativar for especificado para um caminho e a E/S estiver pendente no caminho, este fato será de saída.

A desativação de um caminho afeta a seleção de caminho no nível de driver de dispositivo. O path_status do caminho não é alterado no banco de dados de configuração do dispositivo. O comando lspath deve ser usado para ver o status operacional atual de um caminho.

A segunda sintaxe mostrada acima altera um ou mais atributos específicos do caminho associados a um determinado caminho para um determinado dispositivo. Observe que vários atributos podem ser alterados em uma única chamada do comando chpath, mas todos os atributos devem estar associados a um único caminho. Em outras palavras, não é possível alterar atributos em vários caminhos em uma única chamada do comando chpath. Para alterar atributos em diversos caminhos, chamadas separadas de chpath são necessárias; uma para cada um dos caminhos que devem ser alterados.

Sinalizações

Item	Descrição
-a Atributos=Valor	Identifica o atributo a ser alterado, assim como o novo valor do atributo. O Atributo é o nome de um atributo específico do caminho. O Valor é o valor que é para substituir o valor atual para o Atributo. Mais de uma instância do -a Atributos=Valor pode ser especificado a fim de alterar mais de um atributo.
-g	Força a operação de caminho de mudança a ocorrer em um dispositivo bloqueado.
-h	Exibe a mensagem de uso do comando.
-i PathID	Indica o ID do caminho que é afetado pela mudança. Esta bandeira é usada para identificar com exclusividade um caminho.
-l Nome	Especifica o nome do dispositivo lógico do dispositivo de destino para o(s) caminho(s) afetado(s) pela mudança. Esse sinalizador é obrigatório em todos os casos.
-p Pai	Indica o nome do dispositivo lógico do dispositivo-pai para uso na qualificação de caminhos a serem alterados. Esse sinalizador é obrigatório ao alterar atributos, mas é opcional ao alterar o status operacional.
-P	Altera as características do caminho permanentemente na classe de objeto ODM sem realmente alterar o caminho.. A mudança leva a afetar no caminho na próxima vez que o caminho estiver desconfigurado e depois configurado (possivelmente na próxima inicialização).
-w Conexão	Indica as informações de conexão para uso na qualificação dos caminhos a serem alterados. Esse sinalizador é opcional ao alterar o status operacional. Ao alterar atributos, será opcional se o dispositivo tiver apenas um caminho para o pai indicado. Se houver vários caminhos do pai para o dispositivo, esse sinalizador será obrigatório para identificar o caminho específico que está sendo alterado.
-s OpStatus	Indica o status operacional para o qual os caminhos indicados devem ser alterados. O status operacional de um caminho é mantido no nível do driver de dispositivo. Ele determina se o caminho será considerado ao realizar a seleção de caminho. Os valores permitidos para essa sinalização são: ativar Marque o status operacional como ativado para seleção de caminho MPIO. Um caminho com esse status será considerado para uso ao executar a seleção de caminho. Note que ativar um caminho é a única maneira de recuperar um caminho a partir de uma condição falha . desativar Marque o status operacional como desativado para seleção de caminho MPIO. Um caminho com esse status não será considerado para uso ao executar a seleção de caminho. Esse sinalizador é obrigatório ao alterar o status operacional. Quando usado em conjunto com a sinalização -a Attribute=Value , um erro de uso é gerado.

Segurança

Controle de privilégio: Apenas o usuário root e os membros do grupo system executaram o acesso a este comando.

Eventos de auditoria:

Evento	Informações
DEV_Change	A linha de comando chpath .

Exemplos

Para desativar os caminhos entre scsi0 e o dispositivo de disco hdisk1, insira:
```
chpath -l hdisk1 -p scsi0 -s disable
```
O sistema exibe uma mensagem semelhante a uma das seguintes:
```
paths disabled
```
ou
```
some paths disabled
```
A primeira mensagem indica que todos os caminhos PATH_AVAILABLE a partir de scsi0 para hdisk1 foram desativados com sucesso. A segunda mensagem indica que apenas alguns dos caminhos PATH_AVAILABLE a partir de scsi0 para hdisk1 foram desativados com sucesso.

Arquivos

Item	Descrição
/usr/sbin/chpath	Contém o comando chpath .

Informações relacionadas

O comando lspath , comando mkpath , comando rmpath .