Como relatar todos os nós e links em uma interface de linha de comando no Intel® Ethernet Fabric Suite

Documentação

Documentação e informações do produto

000088353

15/11/2021

Como eu uso ethreport ferramentas para listar todos os componentes do sistema trabalhando no Intel® Ethernet Fabric Suite (Intel® EFS)?

O ethreport oferece recursos poderosos de análise de malha e relatórios. Deve ser executado em um host conectado ao Intel® Ethernet Fabric Suite com o Intel® Ethernet Fabric Suite FastFabric Toolset instalado.

ethreport pode gerar centenas de relatórios diferentes. Os relatórios comumente gerados incluem o seguinte:

ethreport -o comps -d 3
ethreport -o errors -o slowlinks
ethreport -o nodes -F mgmtifaddr:0x00066a00a000447b
ethreport -o nodes -F ifaddr:0x001175019800447b:port:1
ethreport -o nodes -F ifaddr:0x001175019800447b
ethreport -o nodes -F 'node:duster-eth2'
ethreport -o nodes -F 'node:duster-eth2:port:1'
ethreport -o nodes -F 'nodepat:d*'
ethreport -o nodes -F 'nodepat:d*:port:1'
ethreport -o nodes -F 'nodedetpat:compute*'
ethreport -o nodes -F 'nodedetpat:compute*:port:1'
ethreport -o nodes -F nodetype:NIC
ethreport -o nodes -F nodetype:NIC:port:1
ethreport -o nodes -F ifid:1
ethreport -o nodes -F ifid:1:node
ethreport -o nodes -F ifid:1:port:2
ethreport -o nodes -F chassisid:0x001175019800447b
ethreport -o nodes -F chassisid:0x001175019800447b:port:1
ethreport -o extlinks -F rate:100g
ethreport -o extlinks -F portstate:up
ethreport -o extlinks -F portphysstate:operational
ethreport -o extlinks -F 'portdetpat:*mgmt*'
ethreport -o links -F mtucap:2048
ethreport -o snapshot > file
ethreport -o topology > topology.xml
ethreport -o errors -X file

ethreport pode ser executado sem nenhuma opção. Neste modo, ele fornece uma breve lista dos nós na malha, o relatório brnodes.

Uma amostra de um ethreport para uma malha pequena é a seguinte:

# ethreport
Getting All Node Records...
Done Getting All Fabric Records
Node Type Brief Summary
4 Connected NICs in Fabric:
IfAddr Type Name
 Port IfID PortId MgmtIfAddr Speed
0x00006805caa382c0 NIC coyote-ens785f0
 1 0xa86501 6805caa382c0 0x00006805caa382c0 100Gb
0x00006805caa382d0 NIC goblin-ens785f0
 1 0xa86502 6805caa382d0 0x00006805caa382d0 100Gb
0x00006805caa38370 NIC ogre-ens785f0
 1 0xa86504 6805caa38370 0x00006805caa38370 100Gb
0x00006805caa383c8 NIC duster-ens785f0
 1 0xa86503 6805caa383c8 0x00006805caa383c8 100Gb
1 Connected Switches in Fabric:
IfAddr Type Name
 Port IfID PortId MgmtIfAddr Speed
0x0000fcbd6762d279 SW edge1
 0 0x7f9f6c 0x0000fcbd6762d279 None
 1 Ethernet1/1 100Gb
 2 Ethernet2/1 100Gb
 3 Ethernet3/1 100Gb
 4 Ethernet4/1 100Gb
 5 Ethernet5/1 100Gb
 6 Ethernet6/1 100Gb
 7 Ethernet7/1 100Gb
 8 Ethernet8/1 100Gb
 67 Management1 <100Gb

Cada ethreport permite vários níveis de detalhes. Cada vez mais detalhes são mostrados como mais uma indentação das informações adicionais. A opção -d para ethreport controla o nível de detalhes. O padrão é 2. Os valores 0-n são permitidos. O detalhe máximo por relatório varia, mas a maioria tem menos de cinco níveis de detalhes.

Nota

Vários tipos de relatório podem incluir contadores de porta se ambos os contadores estiverem disponíveis (através do uso do sinalizador de estatísticas ou da entrada de um arquivo de snapshot) e um nível de detalhes alto o suficiente é usado. Geralmente, um nível de detalhes entre 5 e 8 é alto o suficiente para incluir contadores por porta nas saídas de relatório. Alguns relatórios, como erros ou o uso de sinalizadores como -F linkqual, já implicam o uso de -d 8.

Por exemplo, quando o relatório anterior é executado no nível 0 de detalhes, a saída é a seguinte:

# ethreport -d 0
Getting All Fabric Records...
Done Getting All Fabric Records
Node Type Brief Summary
4 Connected NICs in Fabric
1 Connected Switches in Fabric

Um resumo dos componentes de malha é mostrado no exemplo a seguir. Este relatório é muito semelhante ao ethfabricinfo. No próximo nível de detalhes, o relatório tem mais detalhes:

# ethreport -d 1
Getting All Fabric Records...
Done Getting All Fabric Records
Node Type Brief Summary
4 Connected NICs in Fabric:
IfAddr Type Name
0x00006805caa38370 NIC ogre-eth2
0x00006805caa382d0 NIC goblin-eth2
0x00006805caa382c0 NIC coyote-eth2
0x00006805caa383c8 NIC duster-eth2
1 Connected Switches in Fabric:
IfAddr Type Name
0x0000fcbd6762d279 SW edge1

Os exemplos anteriores foram todos realizados com um único relatório: o relatório brnodes (Nós Breves). Este é apenas um dos muitos relatórios de topologia que ethreport pode gerar.

Outros relatórios resumem o estado atual da malha. Use esses relatórios para analisar a configuração da malha e verificar se a instalação é consistente com o design e a configuração desejados.

Você pode encontrá-las e todas as outras informações da linha de comando no guia do usuário Intel® Ethernet Fabric Suite FastFabric.

Como eu uso ethextractlink ferramentas para listar todos os links do sistema que funcionam no Intel® Ethernet Fabric Suite?

O ethextractlink produz um arquivo CSV que lista todos ou alguns dos links na malha. ethextractlink é a parte frontal da ferramenta ethreport de armazenamento. A saída desta ferramenta pode ser importada para uma planilha ou análise por outros scripts.

Sintaxe: ethextractlink [ethreport options]

Exemplos:

# List all the links in the fabric:
ethextractlink
# List all the links to a switch named "coresw1":
ethextractlink -F "node:coresw1"
# List all the links to end-nodes:
ethextractlink -F "nodetype:NIC"

 

Tópico relacionado
Baixe pacotes e guias de usuário para Intel® Ethernet Fabric Suite (Intel® EFS)