comando do lsmpio
Propósito
Exibe informações sobre os dispositivos de armazenamento MultiPath I/O (MPIO).
Sintaxe
lsmpio [ ' -l nome_do_dispositivo ] [ ' -o ]
lsmpio ' -S [ ' -l nome_do_dispositivo ] [ ' -d ]
lsmpio ' -z [ ' -l nome_do_dispositivo ]
lsmpio ' -q [ ' -l nome_do_dispositivo ]
lsmpio -a [ -r ] [ -e ] [ -z ]
lsmpio -h
Descrição
O comando lsmpio exibe informações sobre os dispositivos de armazenamento AIX® MPIO. Este comando pode ser usado apenas para dispositivos de armazenamento AIX MPIO que são controlados por módulos de controle de caminho (PCMs) que estão habilitados para o suporte de comandos lsmpio . Alguns dispositivos de armazenamento do AIX® MPIO não suportam as consultas de comandos lsmpio . No entanto, todos os dispositivos de armazenamento AIX MPIO suportam consultas de status operacional do Path.
O comando lsmpio exibe os seguintes tipos de informações:
Status operacional do caminho
Você pode executar o comando lsmpio sem nenhum sinalizador ou com a sinalização -l para exibir o status operacional do caminho.
# lsmpio
name path_id status path_status parent connection
===============================================================================
hdisk1234 0 Enabled Opt,Sel,Deg,Rsv fscsi0 500a098186a7d4ca,0008000000000000
hdisk1234 1 Enabled Non fscsi0 500a098196a7d4ca,0008000000000000
hdisk1234 2 Enabled Opt,Sel fscsi1 500a098186a7d4ca,0008000000000000
hdisk1234 3 Enabled Non fscsi1 500a098196a7d4ca,0008000000000000lspath -F "path_id status parent connection"Os valores válidos da coluna "
status são Enabled (Ativado), Disabled( Desativado), Failed (Falha) ou Missing (Ausente). O campo estendido " path_status pode conter uma ou mais abreviações de status de três letras para fornecer um status de caminho mais detalhado.Nota: Nem todos os campos de
path_status estendidos são aplicáveis a todos os dispositivos de armazenamento MPIO. Alguns valores path_status aparecem apenas se a malha de rede de área de armazenamento (SAN) suportar notificação sobre congestionamento SAN.Os valores possíveis para o campo "
path_status são os seguintes:- Opt
- Indica que o caminho do disco MPIO é um caminho otimizado. Este valor indica um caminho de disco MPIO que se conecta a um controlador preferencial em um dispositivo que possui vários controladores. O PCM seleciona um dos caminhos de disco MPIO preferidos para operações de E/S, sempre que possível.
- Non
- Indica que o caminho do disco MPIO é um caminho não otimizado. Em um dispositivo com caminhos de disco preferenciais MPIO, esse caminho não é considerado como caminho preferencial. O PCM evita a seleção desse caminho para operações de E/S, a menos que todos os caminhos preferidos falhem.
Chg
- Indica que as características de acesso do disco MPIO estão mudando no destino de armazenamento. Esse estado é temporário até que o caminho faça a transição para um novo estado.
- Los
- Indica que o caminho do disco MPIO perdeu o acesso aos dados permanentemente e não pode mais ser usado no host. O destino do armazenamento deve ser avaliado ou diagnosticado quanto a possíveis problemas.
- Act
- Indica que o caminho do disco MPIO é um caminho ativo em um dispositivo que possui controladores ativos e passivos. O PCM seleciona caminhos de disco MPIO ativos para operações de E/S em tal dispositivo.
- Pas
- Indica que o caminho do disco MPIO é um caminho passivo em um dispositivo que possui controladores ativos e passivos. O PCM evita a seleção de caminhos passivos.
- Sel
- Indica que o caminho do disco MPIO está sendo selecionado para operações de E/S, no momento em que o comando " lsmpio deve ser executado.
- Rsv
- Indica que o caminho do disco MPIO sofreu um conflito de reserva inesperado. Esse valor pode indicar um erro de uso ou de configuração, com vários hosts acessando o mesmo disco.
- Fal.
- Indica que o caminho do disco MPIO experimentou uma falha. É possível que um caminho tenha um valor de status de caminho de Ativado e ainda tenha um valor de status de caminho estendido de Fai. Esse cenário indica que as operações enviadas nesse caminho de disco MPIO estão falhando, mas o AIX MPIO não marcou o caminho como Falha. Em alguns casos, AIX MPIO deixa um caminho para o dispositivo no estado Ativado, mesmo quando todos os caminhos de disco MPIO estão apresentando erros.
- Deg
- Indica que o caminho do disco MPIO está em um estado degradado. Este cenário indica que o caminho do disco MPIO estava sendo usado para operações de E/S. Essas operações experimentaram erros, fazendo com que o PCM evite temporariamente o uso do caminho. Quaisquer erros adicionais podem fazer com que o caminho do disco MPIO falhe.
- Fech.
- Indica que o caminho do disco MPIO está fechado. Se todos os caminhos de disco MPIO para um dispositivo estiverem fechados, o dispositivo será considerado fechado. Se apenas alguns caminhos de disco MPIO forem fechados, então esses caminhos podem ter erros experimentados durante a última vez em que o dispositivo foi aberto. O MPIO AIX periodicamente tenta recuperar caminhos fechados até que o caminho do dispositivo esteja aberto.
- PFa
- Indica que a porta remota falhou. Quando o PCM recebe um evento que indica que a porta remota usada pelo caminho de disco MPIO não faz mais parte da malha SAN, o PCM marca o caminho como um caminho com falha. O PCM limpa o estado PFa quando a porta remota se junta novamente à malha SAN.
- PCn
- Indica que a malha SAN relatou congestionamento de tráfego de rede para a porta remota que é utilizada pelo caminho do disco MPIO. O PCM não utiliza este caminho de disco MPIO se outros caminhos de disco MPIO sem o congestionamento de tráfego de rede estão disponíveis para o dispositivo MPIO. O PCM limpa automaticamente o estado PCn se a malha SAN não relatar nenhum evento recente de congestionamento de tráfego de rede.
- PDg
- Indica uma porta remota degradada. A porta degradada pode experimentar muitos erros mesmo que o caminho do disco MPIO para a porta remota permaneça ativo. Tal porta degradada não pode processar dados. O PCM evita esse caminho de disco. Para limpar o status degradado da porta, você deve primeiro desativar a porta degradada no switch ao qual a porta pertence e, em seguida, ativar essa porta. Se o estado "
PDgocorrer repetidamente em um caminho, investigue as portas e as fibras usadas pelo caminho para identificar qualquer problema com o hardware da SAN. - LCn
- Indica que o link que está associado com o adaptador AIX está congestionado porque grande quantidade de dados está sendo enviada para ou a partir do adaptador AIX . O PCM evita tais caminhos de disco MPIO se outros caminhos de disco MPIO sem o congestionamento de link estiverem disponíveis. O PCM limpa automaticamente o estado LCn se a malha SAN não relatar nenhum evento recente de congestionamento de link.
- Adiado
- Indica um caminho recém-adicionado a um disco aberto no momento. O caminho de disco MPIO não pode ser aberto e usado imediatamente por causa de restrições internas. No entanto, o caminho do disco pode ser aberto e usado quando o disco for reaberto na próxima vez.
- CtlrRstErr
- Indica que o controlador de memória não volátil expressa (NVMe) no destino associado ao caminho de disco MPIO pode não ter sido reiniciado. É necessária uma reinicialização antes de ativar o controlador.
- CtlrRdyErr
- Indica que o controlador NVMe no destino que está associado ao caminho de disco MPIO não pôde ser ativado (para torná-lo pronto). O controlador deve estar pronto para que o caminho funcione.
- HostDDErr
- Indica que o driver do host NVMe no AIX detectou um erro de software ou ficou sem recursos do sistema.
- Off-line
- Indica que o controlador NVMe foi definido como off-line manualmente, impedindo-o de ser usado para operações de E/S de disco.
- AdminCmdErr
- Indica que um comando NVMe Admin, como ' Identify, falhou. Certos comandos NVMe Admin são emitidos durante a inicialização do caminho do disco MPIO. Se o comando falhar, o caminho do disco MPIO será marcado como falho.
- FabCmdErr
- Indica que um comando do NVMe Fabrics, como ' Set Property, falhou. Certos comandos do NVMe Fabrics são emitidos durante a inicialização do caminho do disco MPIO. Se o comando falhar, o caminho do disco MPIO será marcado como falho.
- ConnectErr
- Indica que o comando ' Connect falhou. O comando " Connect é um comando Fabrics usado para formar uma associação entre o host e um controlador NVMe no dispositivo de destino. Uma conexão bem-sucedida é uma das primeiras etapas necessárias para estabelecer um caminho de disco MPIO funcional.
- AuthErr
- Indica que o dispositivo de destino exige que o host seja autenticado, mas a autenticação falhou.
- HbaErr
- Indica que um adaptador de barramento de host que contém uma unidade NVMe conectada localmente falhou ou que o slot PCIe em que ele reside falhou. Isso pode ocorrer quando a unidade NVMe causa erros repetidos no acesso à memória do sistema.
- CrqErr
- Indica que o comando ' Create I/O Queue falhou. Esse comando NVMe é usado para criar filas em uma unidade NVMe conectada localmente. O caminho de disco MPIO não poderá ser usado se as filas de E/S não estiverem associadas a ele.
- LinkDwnErr
- Indica que o link de canal de fibra na porta do host está inativo no momento.
- FCloginErr
- Indica que o login do Fiber Channel (FC) (PLOGI, ' FLOGI ou ' PRLI) falhou.
- CassErr
- Indica que o serviço " Create Association falhou. O serviço " Create Association é um serviço de link NVMe sobre FC para estabelecer uma associação de nível de transporte entre o host e um controlador NVMe. Essa associação é necessária antes que o caminho para um subsistema de armazenamento NVMe conectado ao FC possa ser estabelecido.
- CiocErr
- Indica que o serviço " Create I/O Connection falhou. O serviço " Create I/O Connection é um serviço de link NVMe sobre FC para estabelecer uma conexão de E/S em nível de transporte entre o host e um controlador NVMe. Essa conexão é necessária antes que o caminho para um subsistema de armazenamento NVMe conectado ao FC possa ser estabelecido.
- FCDDErr
- Indica que o driver do Fiber Channel no AIX encontrou um erro de software ou ficou sem recursos do sistema.
- EndpntMiss
- Indica que uma ou mais portas do subsistema de armazenamento NVMe estão faltando na malha FC. A conectividade física do subsistema de armazenamento pode ter sido prejudicada.
Status estendido adicional do NVMe
Quando o status do caminho de disco MPIO é "
Failed, o status estendido a seguir pode ser visto como um detalhe adicional sobre o motivo da falha do caminho:| Status | Descrição |
|---|---|
Offline |
Indica que o caminho do disco foi definido manualmente como off-line. Você não deve definir manualmente o caminho para offline, a menos que aconselhá-se por suporte técnico. |
FCloginErr, LinkDwnErr, CassErr, CiocErr, EndpntMiss |
Indica várias condições de erro do NVMe sobre Fiber Channel. A condição mais provável é " CassErr, o que significa que o serviço " Create Association para o controlador de destino falhou. Isso normalmente significa que o host (NQN) não está mapeado corretamente para o dispositivo de destino. |
CtlrRstErr, CtlrRdyErr, AdminCmdErr, ConnectErr, AuthErr, FabCmdErr, HbaErr, CrqErr |
Indica várias condições de erro do NVMe que são úteis para o pessoal de suporte técnico. |
FCDDErr, HostDDErr |
Indica erros do driver como exceder os limites de recursos internos. |
Estatísticas de caminho
A sinalização -S , juntamente com a sinalização opcional -d , faz com que o comando lsmpio exiba estatísticas de caminho normais ou detalhadas. A sinalização opcional -l restringe a exibição para conter estatísticas de apenas um dispositivo de armazenamento MPIO. As estatísticas incluem quantas vezes o caminho de disco MPIO foi selecionado para uma operação de E/S, quantos erros ocorreram no caminho de disco MPIO e quantas vezes o caminho de disco MPIO falhou. As informações detalhadas das estatísticas quebram as contagens de falha, em contagens de diferentes tipos de falhas.
Dados de consulta do dispositivo
O sinalizador -q do comando lsmpio faz com que o MPIO AIX consulte o dispositivo, utilizando os comandos Small Computer System Interface (SCSI) para recuperar e exibir informações sobre o dispositivo conectado. Como cada dispositivo consultado é aberto e consultado usando comandos SCSI, esta operação pode levar tempo para ser executado para muitos dispositivos.
Informações sobre o adaptador pai
A sinalização -a , juntamente com a sinalização opcional -r , faz com que o comando lsmpio exiba informações sobre os adaptadores de Fibre Channel que são usados pelos dispositivos de armazenamento do AIX MPIO. As informações incluem detalhes sobre o identificador do adaptador local, como o nome mundial de adaptadores de Fibre Channel e o estado atual do caminho do disco MPIO, se disponível. A sinalização -r adiciia informações sobre portas remotas, que são acessadas pelo adaptador Fibre Channel.
Você pode usar a bandeira -z para zerar todas as estatísticas a zero.
Sinalizações
| Item | Descrição |
|---|---|
| -a | Lista as informações do adaptador de canal de fibra principal. |
| -d | Exibe estatísticas detalhadas. Esse sinalizador só é válido com o sinalizador ' -S. |
| -e | Quando esta sinalização é usada com a sinalização -a , as contagens de erro para as portas do adaptador local são exibidas. Quando esta sinalização é usada com as bandeiras -a e -r , as contagens de erro para portas de adaptador local e portas remotas são exibidas. Estas contagens de erro indicam uma questão com a conectividade física entre o adaptador local e a porta de armazenamento remoto. As contagens de erro indicam erros recentes para diferentes intervalos de tempo. |
| -h | Exibe informações de uso do comando. |
| -l disk_name | Especifica um dispositivo. Se esta sinalização for incluída, o comando opera em um único dispositivo. Se esse sinalizador for omitido, o comando funcionará em todos os dispositivos AIX MPIO. Esse sinalizador pode ser usado sozinho para o status do caminho resumido ou com os sinalizadores ' -q, ' -S ou ' -z. |
| -o | Indica que o driver de disco AIX tenta acessar toda a E/S multipath (MPIO) que estão associadas aos discos MPIO especificados. A tentativa inclui acessar os caminhos do MPIO que foram marcados como falho quando o disco MPIO foi encerrado pela última vez. Esta sinalização fornece um status atualizado sobre o caminho MPIO. Atenção: Se você tentar acessar os caminhos de disco MPIO falidos, o tempo de resposta para o comando lsmpio pode ser mais lento. O tempo de resposta pode ser retardado por alguns segundos ou vários minutos dependendo de vários fatores como o número de discos MPIO que são impactados e o escopo do comando lsmpio .
|
| -q | Consulta as informações do dispositivo. Este comando usa comandos SCSI padrão para consultar o dispositivo para obter informações. As informações precisas retornadas variam, dependendo do tipo de dispositivo. |
| -r | Exibe as informações da porta remota. Esse sinalizador é usado junto com o sinalizador ' -a para exibir informações sobre portas remotas que são acessadas por um adaptador. As informações que são retornadas podem depender do protocolo de rede que é usado pelo adaptador. |
| -S | Exibe estatísticas de um ou todos os dispositivos. Esta sinalização exibe contadores básicos para uso de caminho e erros de caminho. Se o sinalizador ' -d for usado junto com esse sinalizador, ele exibirá estatísticas mais detalhadas. |
| -z | Redefine todas as estatísticas. Se esta bandeira for usada, ele faz com que o PCM reajuste todos os contadores estatísticos de volta a zero. Observação: Você pode usar o sinalizador ' -z com o sinalizador ' -a para redefinir a contagem de erros do adaptador.
|
Segurança
Atenção usuários do RBAC e usuários do Trusted AIX: Esse comando pode executar operações privilegiadas. Somente usuários privilegiados podem executar essas operações. Para obter mais informações sobre autorizações e privilégios, consulte Banco de dados de comandos privilegiados em Segurança. Para obter uma lista de privilégios e as autorizações associadas a esse comando, consulte o comando lssecattr ou o subcomando getcmdattr.
Exemplos
Exemplos de exibição de informações de MPIO:
- Para exibir as informações resumidas do dispositivo hdisk1234, digite o seguinte comando:
O sistema exibe uma saída similar à seguinte saída:lsmpio -l hdisk1234name path_id status path_status parent connection =============================================================================== hdisk1234 0 Enabled Opt,Sel,Deg,Rsv fscsi0 500a098186a7d4ca,0008000000000000 hdisk1234 1 Enabled Non fscsi0 500a098196a7d4ca,0008000000000000 hdisk1234 2 Enabled Opt,Sel fscsi1 500a098186a7d4ca,0008000000000000 hdisk1234 3 Enabled Non fscsi1 500a098196a7d4ca,0008000000000000 - Para exibir estatísticas detalhadas do dispositivo hdisk10, digite o seguinte comando:
O sistema exibe uma saída similar à seguinte saída:lsmpio -Sdl hdisk10Disk: hdisk10 Path statistics since Tue May 21 17:38:43 CDT 2013 Path 0: (fscsi0:500a098186a7d4ca,8000000000000) Path Selections: 0 Adapter Errors: 0 Software: 0 Hardware: 0 Transport Dead: 0 Transport Busy: 0 Transport Fault: 0 No Device Response: 0 Target Port ID Changed: 0 Command Timeouts: 0 Reservation Conflicts: 0 SCSI Queue Full: 0 SCSI Busy: 0 SCSI ACA Active: 0 SCSI Task Aborted: 0 SCSI Aborted Command: 0 SCSI Check Condition: 0 Medium Error: 0 Hardware Error: 0 Not Ready: 0 Other: 0 Last Error: N/A Last Error Time: N/A Path Failure Count: 0 Due to Adapter Error: 0 Due to I/O Error: 0 Due to Health Check: 0 Due to SCSI Sense: 0 Due to Qualifier Bit: 0 Due to Opening Error: 0 Last Path Failure: N/A Last Path Failure Time: N/AObservação: se algumas contagens de erros SCSI forem relatadas, isso não indica um problema nem indica que as operações de E/S falharam. Durante o processamento regular, erros temporários e recuperáveis podem ser relatados com frequência e, portanto, a operação de E/S pode ser tentada novamente. - Para exibir informações do adaptador MPIO com as informações da porta remota, digite o seguinte comando:
O sistema exibe uma saída similar à seguinte saída:lsmpio -arAdapter Driver: fscsi0 - AIX PCM Adapter WWPN: 10000000c94c7bd6 Link State: Up Paths Paths Paths Paths Remote Ports Enabled Disabled Failed Missing ID 500a098186a7d4ca 31 0 0 0 0x20a00 500a098196a7d4ca 31 0 0 0 0x20b00 500507630a18016b 19 0 0 0 0x31200 500507630a18416b 19 0 0 0 0x31300 500507630a18816b 19 0 0 0 0x31400 500507630a18c16b 19 0 0 0 0x31500 Adapter Driver: fscsi1 - AIX PCM Adapter WWPN: 10000000c94c7bd7 Link State: Up Paths Paths Paths Paths Remote Ports Enabled Disabled Failed Missing ID 500a098186a7d4ca 31 0 0 0 0x20a00 500a098196a7d4ca 31 0 0 0 0x20b00 500507630a18016b 19 0 0 0 0x31200 500507630a18416b 19 0 0 0 0x31300 500507630a18816b 19 0 0 0 0x31400 500507630a18c16b 19 0 0 0 0x31500 5001738000330150 1 0 0 0 0x10100 5001738000330162 1 0 0 0 0x10200 - Para consultar um dispositivo de armazenamento MPIO e exibir informações sobre ele, digite o seguinte comando:
O sistema exibe uma saída similar à seguinte saída:lsmpio -ql hdisk48Device: hdisk48 Vendor Id: IBM Product Id: 2107900 Revision: .160 Capacity: 10G Volume Serial: 600507630AFFC16B0000000000001505 (Page 83 NAA)Nota: A saída que é exibida é derivada dos dados de inquérito padrão e dos dados vitais do produto de identificação do dispositivo (VPD). Se o dispositivo representar um par de Peer-to-Peer Remote Copy (PPRC) (o atributo " san_rep_device tem um valor de sim), a exibição incluirá o número de série do volume para cada número de unidade lógica (LUN) no par PPRC e a ID específica do fornecedor que é compartilhada pelos dois LUNs do par PPRC, conforme mostrado na saída a seguir:Device: hdisk33 Vendor Id: IBM Product Id: 2107900 Revision: .160 Capacity: 10G Volume Serial: 600507630AFFC16B0000000000000113 (Page 83 NAA) Volume Serial: 600507630AFFC16B000000000000031F (Page 83 NAA) Vendor LUN Id: 3735544C37373130313133005022AD6A - Para exibir contagens de erro de porta locais e remotas, digite o seguinte comando:
A saída pode ser semelhante à amostra a seguir:lsmpio -areAdapter Driver: fscsi3 -> AIX PCM Adapter WWPN: 21000024ff6aee7d Link State: Up Connectivity Errors: Last 10 Minutes: 74 Last 60 Minutes: 222 Last 24 Hours: 12345 Connectivity Errors Last 10 Last 60 Last 24 Remote Ports Minutes Minutes Hours 5001738000330171 0 0 0 5001738000330173 0 0 0 500a098286a7d4ca 2 9 45 500a098196a7d4ca 72 213 12300