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
>>- 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 IBM Spectrum Virtualize command-line interface (CLI):
- O caractere curinga é um asterisco (*).
- O comando pode conter, no máximo, um curinga.
- Quando usar um caractere curinga, você deve colocar a entrada de 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 para 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 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 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 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
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 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 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 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.
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 conectadas ou nem 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 iscsiname ficará ativo se todos os grupos de E/S com mapeamentos de 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 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.
- 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 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 Fibre Channel (FC) (que existem em um nó) que os hosts podem acessar.
Tabela 1
mostra as possíveis saídas:
| Atributo | Descrição |
|---|---|
| id | Indica o ID do host exclusivo. O valor é um valor alfanumérico. |
| nome | 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. |
| 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 aos quais o WWPN está conectado. |
| estado | 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. |
| 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. |
Um Exemplo de Chamada
lshostA saída resultante:
id name port_count iogrp_count status mapping_count host_cluster_id host_cluster_name site_id site_name
0 hostone 1 4 offline 0 vardyhost1 2 chelsea3
1 host0 1 4 degraded 1 vardyhost2 1 chelsea1
2 host1 1 4 online 2 vardyhost3 2 chelsea2Um Exemplo de Chamada Detalhada
lshost 0A 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 jvardy8Um Exemplo de Chamada
lshost 0A 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