lshost

Use o comando lshost para gerar uma lista com informações concisas sobre todos os hosts visíveis para o sistema em cluster (sistema) e com informações detalhadas sobre um único host.

Sintaxe

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>- lshost-- --+-----------------------------------+-- --------->
               '- -filtervalue -- attribute=value -'      

>--+----------+-- --+-----------------------+-- -- ------------->
   '- -nohdr -'     '- -delim -- delimiter -'         

>--+-----------------+--+---------------+----------------------><
   '- -filtervalue? -'  +- object_id ---+   
                        '- object_name -'   

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.
Nota: Alguns filtros permitem o uso de um curinga ao inserir o comando. The following rules apply to the use of wildcards with the Storwize V3700 command-line interface (CLI):
  • O caractere curinga é um asterisco (*).
  • O comando pode conter, no máximo, um curinga.
  • Ao usar um curinga, coloque a entrada do filtro entre aspas duplas ("" ), conforme a seguir:
    lshost -filtervalue
    "name=md*"
-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 a serem exibidos, os títulos não serão exibidos.
-delim delimitador
(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 para a largura máxima possível 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 do título 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 o parâmetro object_id | object_name não for especificado, 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
  • nome
  • port_count
  • status

Para obter mais informações sobre os atributos de filtragem, consulte Atributos dos Parâmetros -filtervalue.

Descrição

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 em que a porta do host está registrada. Para portas 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 através de diversos grupos de E/S. Os hosts iSCSI podem acessar volumes que são acessíveis através de diversos grupos de E/S (e grupos únicos de E/S). Um host iSCSI mapeado para um volume acessível através de diversos grupos de E/S está online se ele tem pelo menos uma sessão iSCSI ativa com cada grupo de E/S da configuração 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 cinco 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 cinco 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 pelo menos o nó tiver recebido comandos de SCSI a partir do WWPN nos últimos cinco 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 cinco minutos.
off-line
A porta do host ficará offline se não houver login para o WWPN especificado.
Se um host não tiver nenhum mapeamento de volume, ele será relatado como offline ou inativo.
Nota: O comando lshost apresenta uma lista de portas HBA do host que estão conectadas a nós. No entanto, há situações em que as informações apresentadas podem incluir portas de HBA de host que não estão mais conectadas ou que não fazem mais parte da malha SAN. Por exemplo, uma porta HBA do host é desconectada de um comutador, mas lshost ainda mostra o WWPN conectado a todos os nós. Se isso acontecer, a entrada incorreta é removida quando outra é conectada à mesma porta do comutador que antes continha a porta de HBA de host removida.
A lista a seguir fornece os diferentes estados para um determinado iscsiname:
ativo
O iscsiname ficará ativo se todos os grupos de E/S com mapeamentos do volume tiverem pelo menos uma sessão iSCSI associada para o iscsiname especificado.
inactive
O iscsiname ficará inativo se o host não possuir nenhum mapeamento de volume, mas pelo menos uma sessão de iSCSI para o iscsiname especificado estiver presente.
off-line
O iscsiname ficará offline se um mais grupos de E/S com mapeamentos de volume não tiverem uma sessão de iSCSI associada para o iscsiname especificado.
A lista a seguir fornece os diferentes estados para host_status:
on-line
O host possui conectividade integral. Um host usando apenas um estilo de conectividade estará online se usar um destes:
Fibre Attach Fibre Channel (FAFC)
Cada porta está ativa ou inativa e é registrada em cada nó online de cada grupo de E/S em que o host tem mapeamentos de volume.
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.
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 de iSCSI só for registrado em grupos de E/S para o qual não está configurado, o status do objeto de host associado ficará 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 uma perda de acesso durante qualquer atividade de manutenção planejada e deve ser corrigido o mais rápido possível.
Lembre-se: Um host de iSCSI que não possui volumes mapeados fica degraded se 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 do Fiber Channel (FC) (que existem em um nó) que os hosts possam acessar.
Tabela 1 mostra as possíveis saídas:
Tabela 1. Saída de lshost
Atributo Descrição
id Indica o ID de host exclusivo com um valor alfanumérico.
nome Indica o nome do host exclusivo com um valor alfanumérico.
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 estiver online ou offline.
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.
node_logged_in_count Indica o número de nós em que o WWPN está com login efetuado
estado Indica o estado do login do WWPN do SAS:
  • off-line
  • inativo
  • ativo
sas_wwpn_count Indica o número de WWPNs do SAS configurados.
host_cluster_id Indica o ID exclusivo para um cluster do host.
host_cluster_name Indica o nome exclusivo para um cluster do host.

Um Exemplo de Chamada

lshost

A saída resultante:

id name    port_count iogrp_count status mapping_count host_cluster_id  host_cluster_name  
  0  hostone 1          4           offline              0               vardyhost1
  1  host0   1          4           degraded             1               vardyhost2
  2  host1   1          4           online               2               vardyhost3

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

host_cluster_id 1
host_cluster_name jvardy8

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

host_cluster_id 2
host_cluster_name boat3ng