Recopilación de información de asistencia para problemas de Intel® Ethernet Fabric Suite

Documentación

Resolución de problemas

000088354

16/11/2021

¿Cómo se utiliza el comando ethcapture ?

El comando ethcapture captura información crítica del sistema en un archivo zipped. El archivo "fábrica" resultante se debe enviar a asistencia al cliente junto con cualquier informe de problema de Fabric Ethernet Intel® con respecto a este sistema.

Nota

El archivo de captura de host resultante puede requerir cantidades significativas de espacio en el host. El tamaño real varía, pero los tamaños pueden ser varios megabytes. Intel recomienda asegurarse de que haya un espacio en disco adecuado disponible en el sistema host.

Sintaxis: ethcapture [-d detail] output_tgz_file

Opciones:

--help: Produce el texto de ayuda completa.

-d detail: captura el nivel de detalle:

1 (local): obtiene información local del host. Este es el valor predeterminado si no se ingresan opciones.

2 (Fabric): Además de Local, también obtiene información básica de Fabric mediante consultas al análisis de errores de SM y fabric mediante ethreport.

3 (Análisis): Además de Fabric, también obtiene resultados de ethallans. Si todavía no se ha ejecutar ethallanalysis , se ejecuta como parte de la captura.

Nota

Los niveles de detalle 2 a 3 se pueden utilizar cuando se presentan problemas operacionales de estructura. Si el problema es específico del nodo, el nivel de detalle 1 debería ser suficiente. Los niveles de detalle 2 a 3 requieren una estructura operativa. Por lo general, su representante de asistencia solicita un nivel de detalle determinado. Si un nivel de detalle dado tarda demasiado tiempo o no se recopila, intente un nivel de detalle más bajo. Para los niveles de detalle 2 a 3, la información adicional solo está disponible en un nodo con Intel® Ethernet Fabric Suite FastFabric Toolset instalado.

output_tgz_file: Especifica el nombre de un archivo que creará ethcapture. El nombre de archivo especificado se sobrescribe si ya existe. Intel recomienda utilizar el sufijo.tgz en el nombre de archivo proporcionado. Si el nombre de archivo proporcionado no tiene un sufijo .tgz, se agrega el sufijo .tgz.

Ejemplos:

ethcapture mycapture.tgz
ethcapture -d 3 030127capture.tgz

 

¿Cómo se utiliza el comando ethpacaptureall ?

El comando ethcaptureall captura información compatible con un informe de problemas de todos los hosts y cargas en este sistema.

Cuando se realiza un ethcaptureall de host, se ejecuta ethcapture para crear el archivo de captura especificado en ~root en cada host (con el sufijo .tgz agregado según sea necesario). Los archivos se cargan y descomprimen en un nombre de directorio coincidente en upload_dir/hostname/ en el sistema local. El nombre de archivo predeterminado es hostcapture.

Las capturas subidas se combinan en un archivo de .tgz con el nombre de archivo especificado y el sufijo .all.tgz agregado.

Opciones:

--help: Produce el texto de ayuda completa.

-p: Realiza una carga de captura en paralelo en todos los hosts.

-f hostfile: especifica el archivo con los hosts en el clúster. El valor predeterminado es el archivo /etc/ethtools/hosts .

-h hosts: Especifica la lista de hosts en los que se debe realizar una captura.

-d upload_dir: Especifica el directorio al que se cargará. El valor predeterminado es uploads. Si no se especifica, se utiliza la variable de entorno UPLOADS_DIR .

-D detail_level: especifica el nivel de detalle de la captura que se pasó al host ethcapture.

1 (local): Obtiene información local de cada host.

2 (Fabric): Además de Local, también obtiene información básica de Fabric mediante consultas al análisis de errores de fabric y fabric mediante ethreport.

3 (Análisis): Además de Fabric, también obtiene resultados ethallanalysis . Si todavía no se ha ejecutar ethallanalysis , se ejecuta como parte de la captura.

Nota

Para los niveles de detalle 2-3, la información adicional solo se recopila en el nodo que ejecuta el comando ethcaptureall .

file: Especifica el nombre para el archivo de captura. El sufijo .tgz se anexa si no se especifica en el nombre.

Ejemplos:

ethcaptureall
# Creates a hostcapture directory in upload_dir/hostname/ for each host in
/etc/eth-tools/hosts file, then creates hostcapture.all.tgz.

ethcaptureall mycapture
# Creates a mycapture directory in upload_dir/hostname/ for each host in
/etc/eth-tools/hosts file, then creates mycapture.all.tgz.

ethcaptureall -h 'arwen elrond' 030127capture
# Gets the list of hosts from arwen elrond file and creates
030127capture.tgz file.

Variables de entorno

Este comando también utiliza las siguientes variables de entorno:

  • HOSTS: Lista de hosts que se utiliza si no se proporciona -h opción.
  • HOSTS_FILE: Archivo que contiene una lista de hosts utilizados a falta de -f y -h.
  • UPLOADS_DIR: Directorio al que cargar, utilizado a falta de -d.
  • FF_MAX_PARALLEL: Cuando se utiliza la opción -p , se realizan operaciones simultáneas máximas.

Más información

Al realizar ethcaptureall en hosts, se utiliza SSH internamente. El comando ethcaptureall requiere que se configure SSH sin contraseña entre el host que ejecuta Intel® Ethernet Fabric Suite Conjunto de herramientas FastFabric y los hosts con los que está funcionando ethcaptureall . El comando ethsetupssh puede ayudar a configurar SSH sin contraseñas.

Nota

Los archivos de captura de host resultantes pueden requerir una cantidad considerable de espacio en el host Intel® Ethernet Fabric Suite conjunto de herramientas FastFabric. El tamaño real varía, pero los tamaños pueden ser varios megabytes por host. Intel recomienda que se asegure de que haya un espacio adecuado disponible en el Intel® Ethernet Fabric Suite sistema de conjunto de herramientas FastFabric. En muchos casos, es posible que no sea necesario ejecutar ethcaptureall en todos los hosts; en cambio, un subconjunto representativo puede ser suficiente. Consulte con su representante de asistencia para obtener más información.