Cómo informar de todos los nodos y enlaces en una interfaz de línea de comandos en el Intel® Ethernet Fabric Suite

Documentación

Información y documentación sobre productos

000088353

15/11/2021

¿Cómo se utilizan ethreport herramientas para enumerar todos los componentes del sistema que funcionan en el Intel® Ethernet Fabric Suite (Intel® EFS)?

El comando ethreport proporciona potentes capacidades de análisis e informes de Fabric. Debe ejecutarse en un host conectado al Intel® Ethernet Fabric Suite con el conjunto de herramientas Intel® Ethernet Fabric Suite FastFabric instalado.

ethreport puede generar cientos de informes diferentes. Los informes generados comúnmente incluyen lo siguiente:

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 se pueden ejecutar sin opciones. En este modo, proporciona una breve lista de los nodos en la estructura, según el informe de 10.000 unidades.

A continuación, se muestra una muestra de un ethreport para una estructura pequeña:

# 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 diversos niveles de detalle. El aumento de los detalles se muestra como una nueva indentación de la información adicional. La opción -d para ethreport controla el nivel de detalle. El valor predeterminado es 2. Se permiten valores de 0-n . El detalle máximo por informe varía, pero la mayoría tiene menos de cinco niveles de detalle.

Nota

Varios tipos de informes pueden incluir contadores de puertos si ambos están disponibles (mediante el uso del indicador stats o la entrada de un archivo de instantáneas) y se utiliza un nivel de detalle suficiente. Normalmente, un nivel de detalle entre 5 y 8 es lo suficientemente alto como para incluir contadores por puerto en los resultados del informe. Algunos informes, como errores o el uso de indicadores como -F linkqual, ya implican el uso de -d 8.

Por ejemplo, cuando se ejecuta el informe anterior en el nivel de detalle 0, el resultado es el siguiente:

# 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

En el siguiente ejemplo, se muestra un resumen de los componentes fabric. Este informe es muy similar a ethfabricinfo. Al siguiente nivel de detalle, el informe tiene más detalles:

# 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

Todos los ejemplos anteriores se realizaron con un único informe: el informe de "nodos breves". Este es solo uno de los muchos informes de topología que ethreport puede generar.

Otros informes resumen el estado actual de la estructura. Utilice estos informes para analizar la configuración de la estructura y verificar que la instalación sea coherente con el diseño y la configuración deseados.

Puede encontrarlos y toda la información de línea de comandos en Intel® Ethernet Fabric Suite Guía del usuario de FastFabric.

¿Cómo se utilizan ethextractlink herramientas para enumerar todos los enlaces del sistema que funcionan en la Intel® Ethernet Fabric Suite?

El comando ethextractlink genera un archivo CSV que enumera todos o algunos de los enlaces de la estructura. ethextractlink es un extremo frontal de la herramienta ethreport . El resultado de esta herramienta puede importarse a una hoja de cálculo o extraerlos de otros scripts.

Sintaxis: ethextractlink [ethreport options]

Ejemplos:

# 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"

 

Tema relacionado
Guías de usuario y paquetes para Intel® Ethernet Fabric Suite (Intel® EFS)