lshost
Use o comando lshost para gerar uma lista com informações concisas sobre todos os hosts visíveis para o sistema e informações detalhadas sobre um único host.
Sintaxe
Parâmetros
- -filtervalue attribute=value
- (Opcional) Especifica uma lista de um ou mais filtros. Apenas objetos com um valor que corresponda ao valor de atributo do filtro são retornados. Se uma capacidade for especificada, as unidades também deverão ser incluídas.
- -nohdr
- (Opcional) Por padrão, os títulos são exibidos para cada coluna de
dados em uma visualização de estilo conciso e para cada item de dados em
uma visualização de estilo detalhado. O parâmetro
-nohdr suprime a exibição desses títulos.Nota: Se não houver dados para serem exibidos, os títulos não serão exibidos.
- -delim delimiter
- (Opcional) Por padrão, em uma visualização concisa, todas as colunas
de dados são separadas por espaços. A largura de cada coluna é configurada com a largura máxima
de cada item de dados. Em uma visualização detalhada, cada item de dados tem sua própria linha e,
se os cabeçalhos forem exibidos, os dados serão separados do cabeçalho
por um espaço. O parâmetro -delim substitui esse comportamento.
A entrada válida para o parâmetro -delim
é um caractere de um byte. Se for inserido
-delim :na linha de comandos, o caractere dois pontos (:) separa todos os itens de dados em uma visualização concisa; por exemplo, o espaçamento das colunas não ocorre. Em uma visualização detalhada, os dados são separados de seu cabeçalho pelo delimitador especificado. - object_id | object_name
- (Opcional) Especifica o nome ou ID de um objeto. Quando esse parâmetro é usado, é retornada a visualização detalhada do objeto específico, e quaisquer valores especificados pelo parâmetro -filtervalue são ignorados. Se não especificar o parâmetro object_id | object_name, será exibida a visualização concisa de todos os objetos que correspondem aos requisitos de filtragem especificados pelo parâmetro -filtervalue.
- -filtervalue?
- (Opcional) Especifica que você quer que o relatório exiba algum ou
todos que estão na lista de atributos de filtro válidos. Os atributos
de filtro válidos para o comando lshost são:
- host_cluster_id
- host_cluster_name
- host_name
- host_id
- id
- iogrp_count
- name
- port_count
- site_id
- site_name
- status
- type
- protocolo
Para obter mais informações sobre os atributos de filtragem, consulte Atributos dos Parâmetros -filtervalue.
Description
Esse comando retorna uma lista concisa ou uma visualização detalhada de hosts visíveis para o sistema.
Para portas Fibre Channel (FC), o campo node_logged_in_count fornece o número
de nós nos quais a porta do host está conectada. Para portas de Internet Small Computer System
Interface (iSCSI), o campo node_logged_in_count fornece o número de sessões iSCSI a partir do nome qualificado
de iSCSI (IQN) do host.
É possível mapear um host iSCSI para volumes que são acessíveis
por meio de diversos grupos de E/S. Hosts iSCSI podem acessar volumes
que são acessíveis por meio de diversos grupos de E/S (e grupos de
E/S únicos). Um host iSCSI que é mapeado para um volume que está acessível por meio de múltiplos grupos de
E/S fica on-line se ele tiver ao menos uma sessão de iSCSI ativa com cada grupo de E/S do
conjunto de acesso. Se os volumes não são mapeados para um host iSCSI, ele é degraded.
A lista a seguir fornece diferentes estados para uma porta do host FC anexa à malha:
- ativo
- A porta do host ficará ativa se todos os nós com mapeamentos de volume tiverem um login para o nome da porta universal (WWPN) especificado e se pelo menos um nó tiver recebido comandos SCSI a partir do WWPN nos últimos 5 minutos.
- degraded
- A porta do host ficará degradada se um ou mais nós com mapeamentos de volume não tiverem um login para o WWPN especificado.
- inactive
- A porta do host ficará inativa se todos os nós com mapeamentos de volume tiverem um login para o WWPN especificado, mas nenhum nó tiver recebido quaisquer comandos da Small Computer System Interface (SCSI) a partir do WWPN nos últimos 5 minutos.
- off-line
- A porta do host ficará offline se um ou mais grupos de E/S com mapeamentos de volume não tiverem um login para o WWPN especificado.
A lista a seguir fornece os diferentes estados de uma porta do host FC de conexão direta:
- ativo
- A porta de host ficará ativa se um nó tiver um login para o WWPN especificado e se o nó tiver recebido comandos de SCSI a partir do WWPN nos últimos 5 minutos.
- inactive
- A porta do host ficará inativa se todos os nós com mapeamentos de volume tiverem um login para o WWPN especificado, mas nenhum nó tiver recebido quaisquer comandos da Small Computer System Interface (SCSI) a partir do WWPN nos últimos 5 minutos.
- off-line
- A porta do host ficará off-line se não existir nenhum login para o WWPN especificado.
A lista a seguir fornece os diferentes estados para
uma porta do host NVMe/FC de conexão de malha:
- ativo
- A porta do host estará ativa se todos os nós com mapeamentos de volume tiverem um login para o Nome Qualificado de NVMe (NQN) especificado e pelo menos um nó tiver recebido comandos NVMe de NQN nos últimos 5 minutos.
- degraded
- A porta do host estará degradada se um ou mais nós com mapeamentos de volume não tiverem um login para o NQN especificado.
- inactive
- A porta do host estará inativa se todos os nós com mapeamentos de volume tiverem um login para o NQN especificado, mas nenhum nó tiver visto nenhum comando NVMe do NQN nos últimos 5 minutos.
- off-line
- A porta do host estará off-line se um ou mais grupos de entrada/saída (E/S) com mapeamentos de volume não tiverem um login para o NQN especificado.
Nota: O comando lshost
apresenta uma lista de portas HBA do host que estão conectadas a nós. No entanto, existem situações em que as informações apresentadas podem incluir portas
HBA de host que não estão mais com login efetuado ou que até mesmo fazem parte da malha SAN. Por exemplo, uma porta HBA do host está desconectada de um comutador, mas lshost ainda mostra o WWPN conectado em todos os nós. Se esta
ação acontecer, a entrada incorreta será removida quando outro dispositivo for conectado à mesma porta do
comutador que continha anteriormente a porta
de HBA de host removida.
A lista a seguir fornece os diferentes estados para um determinado
iscsiname: - ativo
- O
iscsinameficará ativo se todos os grupos de E/S com mapeamentos de volume tiverem pelo menos uma sessão iSCSI associada para oiscsinameespecificado. - inactive
- O
iscsinameficará inativo se o host não possuir nenhum mapeamento de volume, mas pelo menos uma sessão de iSCSI para oiscsinameespecificado estiver presente. - off-line
- O
iscsinamefica off-line quando os volumes com acesso a um ou mais grupos de E/S são mapeados para um iscsiname especificado que não tem sessões iSCSI ou iSER associadas em todos os grupos de E/S relacionados.
A lista a seguir fornece os diferentes estados para host_status:
- on-line
- O host possui conectividade integral. Um host que usa apenas um estilo de conectividade estará on-line se
ele usar um destes tipos:
- Fibre Attach Fibre Channel (FAFC)
- Cada porta está ativa ou inativa e conectada a cada nó on-line em cada grupo de E/S no qual o host tem mapeamentos de volumes.
- Direct Attach Fibre Channel (DAFC)
- O host tem um login ativo ou inativo para cada nó em grupos de E/S para os quais o host tem mapeamentos de volume.
- Internet Small Computer System Interface (iSCSI)
- O host tem uma sessão de iSCSI em cada grupo de E/S com o qual o host tem mapeamentos de volume.
- NVMe sobre Fibre Channel (FC-NVMe)
- Todos os NQNs de host possuem associações NVMe com cada nó on-line em cada grupo de E/S no qual o host tem mapeamentos de volume.
- off-line
- O host não possui nenhuma conectividade. Isso pode ocorrer porque o host foi desligado e não está ativo. Lembre-se: Se um host iSCSI estiver conectado apenas a grupos de E/S para os quais ele não está configurado, o status do objeto do host associado será
offline. - degraded
- O host não está conectado integralmente, o que pode ser originado por um erro
de configuração ou uma falha de hardware. Isso pode causar perda de acesso durante qualquer atividade
de manutenção planejada e deve ser corrigido o mais breve possível. Lembre-se: Um host de iSCSI que não possui volumes mapeados fica
degradedse ele estiver com login efetuado para alguns, mas não todos, os grupos de E/S ao qual ele pertence. - mask
- As portas de E/S Fibre Channel (FC) (que existem em um nó) que os hosts podem acessar.
Esta tabela mostra as saídas possíveis:
| Atributo | Description |
|---|---|
| ID | Indica o ID do host exclusivo. O valor é um valor alfanumérico. |
| name | Indica o nome do host exclusivo. O valor é uma sequência alfanumérica. |
| port_count | Indica o número de portas. |
| type | Indica o tipo do host. |
| mask | Indica o valor da máscara com uma sequência binária de 64 bits. |
| iogrp_count | Indica o número de grupos de E/S. |
| status | Indica se o host está online ou offline. |
| protocolo | Indica se o host usa scsi ou
nvme para acessar o armazenamento. |
| WWPN | Indica o nome da porta universal (WWPN) com uma sequência hexadecimal de 16 caracteres. |
| SAS_WWPN | Indica o WWPN do serial-attached SCSI (SAS) com uma sequência hexadecimal de 16 caracteres. |
| nqn | Indica o Nome Qualificado do NVMe. |
| node_logged_in_count | Indica o número de nós nos quais o WWPN ou o NQN está com login efetuado. |
| state | Indica o estado do login do WWPN do SAS.
Os valores são:
|
| sas_wwpn_count | Indica o número de WWPNs do SAS configurados. |
| nqn_count | Indica o número de portas NQN do NVMe designadas para o host. |
| site_id | Identifica o ID do site para o host. Os valores
são 1, 2 ou branco. |
| site_name | Identifica o nome do site para o host. O valor deve ser uma sequência alfanumérica ou branco. |
| host_cluster_id | Indica o ID exclusivo para um cluster do host. |
| host_cluster_name | Indica o nome exclusivo para um cluster do host. |
| status_policy | Exibe os requisitos de conectividade que são usados para calcular o status do host. O valor é complete ou redundant. Para status_policy redundant:
|
| status_site | Exibe a conectividade do site host usada para calcular o status do host. O resultado é um dos valores a seguir:
|
| owner_id | Exibe o ID do grupo de propriedades. |
| owner_name | Exibe o nome do grupo de propriedades. |
Um exemplo de chamada
lshost
A saída do resultado:
id name port_count iogrp_count status mapping_count host_cluster_id host_cluster_name protocol site_id site_name owner_id owner_name
0 hostone 1 4 offline 0 1 vardyhost1 scsi 2 chelsea2 0 tenantA
1 host0 1 4 degraded 1 2 vardyhost2 nvme 1 chelsea1 0 tenantA
2 host1 1 4 online 2 3 vardyhost3 scsi 2 chelsea2 0 tenantA
Um exemplo de chamada detalhada
lshost 0
A saída resultante:
id 0
name ined
port_count 1
type openvms
mask 0000000000000000000000000000000000000000000000000000000000001101
iogrp_count 4
status online
WWPN 10000000C92BB490
node_logged_in_count 1
state inactive
site_id 2
site_name chelsea2
host_cluster_id 1
host_cluster_name jvardy8
protocolo scsi
status_policy complete
status_site all
owner_id 0
owner_name tenantA
Um Exemplo de Chamada
lshost 0
A saída resultante :
id 0
name host0
port_count 10
type generic
mask 1111111111111111111111111111111111111111111111111111111111111111
iogrp_count 4
status offline
SAS_WWPN 1000000000000009
node_logged_in_count 0
state offline
SAS_WWPN 1000000000000008
node_logged_in_count 0
state offline
site_id 2
site_name chelsea2
host_cluster_id 2
host_cluster_name boat3ng
protocolo scsi
status_policy complete
status_site all
owner_id 0
owner_name tenantA
Um Exemplo de Chamada
lshost 1
A saída do resultado:
id 1
name host1
port_count 2
type generic
mask 1111111111111111111111111111111111111111111111111111111111111111
iogrp_count 4
status offline
site_id
site_name
host_cluster_id
host_cluster_name
protocolo nvme
nqn nqn.2014-08.com.example:nvme.host.sys.xyz
node_logged_in_count 0
state offline
nqn nqn.2014-08.org.nvmexpress:uuid:f81d4fae-7dec-11d0-a765-00a0c91e6bf6
node_logged_in_count 0
state offline
status_policy complete
status_site all
owner_id 0
owner_name tenantA