Live manual Debian Live

# Debian Live Manual

# Cómo informar acerca de errores.

694

# 14. Informes de errores.

695

Los sistemas en vivo están lejos de ser perfectos, pero queremos que sean lo más perfectos posible - con su ayuda. No dudar en informar de un error. Es mejor llenar un informe dos veces que no hacerlo nunca. Sin embargo, este capítulo incluye recomendaciones sobre cómo presentar buenos informes de errores.

696

Para los impacientes:

697

- First check whether the bugs has been reported already. You can see the full list of bugs that are assigned to the live-team at ‹https://bugs.debian.org/cgi-bin/pkgreport.cgi?maint=debian-live%40lists.debian.org›.

698

- Before submitting a bug report always try to reproduce the bug with the most recent versions of the packages of live-build, live-boot, live-config and live-tools that you're using.

699

- Se debe intentar proporcionar una información tan específica como sea posible acerca del error. Esto incluye (al menos) la versión de live-build, live-boot, live-config y live-tools utilizada y la distribución del sistema en vivo que se está construyendo.

700

14.1 Problemas conocidos

701

Currently known issues are listed in the BTS at ‹https://bugs.debian.org/cgi-bin/pkgreport.cgi?maint=debian-live%40lists.debian.org›.

702

Note: Since Debian testing and Debian unstable distributions are moving targets, when you specify either of them as the target system distribution, a successful build may not always be possible.

703

Si esto causa mucha dificultad, no se debe crear un sistema basado en testing o unstable, sino que debe utilizarse stable. live-build siempre crea, por defecto, la versión stable .

704

It is out of the scope of this manual to train you to correctly identify and fix problems in packages of the development distributions, however, you can always try the following: If a build fails when the target distribution is testing, try unstable. If unstable does work, revert to testing and pin the newer version of the failing package from unstable (see APT pinning for details).

705

14.2 Hacer la investigación

706

Antes de presentar el informe de errores, buscar en la web el mensaje de error en particular o el síntoma que se está percibiendo. Como es muy poco probable que sea la única persona que tiene ese problema en concreto, siempre existe la posibilidad de que se haya discutido en otras partes y exista una posible solución, parche o se haya propuesto una alternativa.

707

Se debe prestar especial atención a la lista de correo del sistema en vivo, así como a su página web, ya que seguramente tienen la información más actualizada. Si esa información existe, se debe incluir una referencia a ella en el informe de errores.

708

Además, se debe comprobar las listas de errores actuales de live-build, live-boot, live-config y live-tools y verificar si se ha informado ya de algo similar.

709

14.3 Reconstruir desde cero

710

Para asegurarse de que un error en particular no es causado por crear el sistema basándose en los datos de un sistema anterior, se debe reconstruir el sistema en vivo entero, desde el principio y comprobar si el error es reproducible.

711

14.4 Utilizar paquetes actualizados

712

Using outdated packages can cause significant problems when trying to reproduce (and ultimately fix) your problem. Make sure your build system is up-to-date and any packages included in your image are up-to-date as well. If possible, try to reproduce the bug with the newest code from source, see Installation for details.

713

14.5 Recopilar información

714

Se debe proporcionar información suficiente con el informe. Como mínimo, la versión exacta de live-build donde se encuentra el error y los pasos para reproducirlo. Se debe utilizar el sentido común e incluir cualquier información pertinente si se cree que podría ayudar a resolver el problema.

715

Para sacar el máximo provecho de un informe de errores, se requerirá al menos la siguiente información:

716

- Arquitectura del sistema anfitrión

717

- Distribución del sistema anfitrión.

718

- La versión de live-build del sistema anfitrión.

719

- Versión de debootstrap en el sistema anfitrión.

720

- Arquitectura del sistema en vivo.

721

- Distribución del sistema en vivo.

722

- Versión de live-boot en el sistema en vivo.

723

- Versión de live-config en el sistema en vivo.

724

- Versión de live-tools en el sistema en vivo.

725

Se puede generar un log del proceso de creación mediante el comando `tee`. Se recomienda hacer esto de forma automática con un script `auto/build` (ver Gestionar una configuración para más detalles).

726

# lb build 2>&1 | tee build.log

727

En el momento del arranque, live-boot y live-config guardan sus logs en `/var/log/live/`. Comprobar si hay algún mensaje de error en estos ficheros.

728

Además, para descartar otros errores, siempre es una buena idea comprimir en un .tar el directorio `config/` y subirlo a algún lugar, para que el equipo de Debian Live pueda reproducir el error (No se debe enviar como documento adjunto a la lista de correo). Si esto es difícil (por ejemplo, debido a su tamaño) se puede utilizar la salida del comando `lb config --dump` que produce un resumen del árbol de configuración (es decir, listas de archivos de los subdirectorios de `config /` pero no los incluye).

729

Hay que recordar que los informes a enviar se deben hacer en ingles, por lo que para generar los logs en este idioma se debe utilizar la variante local English, p.ej. ejecutar los comandos de live-build o cualquier otro precedidos de `LC_ALL=C` o `LC_ALL=en_US`.

730

14.6 Aislar el fallo si es posible

731

Si es posible, aislar el caso del fallo al menor cambio posible que lo produzca. No siempre es fácil hacer esto, así que si no se consigue para el informe, no hay que preocuparse. Sin embargo, si se planea el ciclo de desarrollo bién, con conjuntos de cambios lo bastante pequeños por iteración, puede ser posible aislar el problema mediante la construcción de una simple «base» de configuración que se ajuste a la configuración actual deseada, más el conjunto del cambio que falla añadido. Si resulta difícil determinar que cambios produjeron el error, puede ser que se haya incluido demasiado en cada conjunto de cambios y se deba desarrollar en incrementos más pequeños.

732

14.7 Utilizar el paquete correcto sobre el que informar del error

733

En general, se debe informar sobre los errores en tiempo de creación contra el paquete live-build. De los fallos en tiempo de arranque contra el paquete live-boot, y de los errores en tiempo de ejecución contra el paquete live-config. Si no se está seguro de qué paquete es el adecuado o se necesita más ayuda antes de presentar un informe de errores, lo mejor es enviar un informe contra el pseudo-paquete debian-live. Nosotros nos encargaremos de reasignarlo donde sea apropiado.

734

Sin embargo, se agradece si se intenta limitar la búsqueda a donde aparece el error.

735

14.7.1 En la preinstalación (bootstrap) en tiempo de creación.

736

live-build crea primero un sistema Debian básico con debootstrap. Si un error aparece en este momento, se debe comprobar si está relacionado con un paquete específico de Debian (es lo más probable), o si está relacionado con la herramienta de preinstalación en sí.

737

En ambos casos, esto no es un error en el sistema en vivo, sino de Debian en sí mismo, por lo cual nosotros probablemente no podamos solucionarlo directamente. Informar del error sobre la herramienta de preinstalación o el paquete que falla.

738

14.7.2 Mientras se instalan paquetes en tiempo de creación.

739

live-build instala paquetes adicionales del archivo de Debian que pueden fallar en función de la distribución Debian utilizada y del estado diario del archivo Debian. Se debe comprobar si el error es reproducible en un sistema Debian normal, si el fallo aparece en esta etapa.

740

Si este es el caso, esto no es un error en el sistema en vivo, sino de Debian - se debe informar sobre el paquete que falla. Se puede obtener más información ejecutando debootstrap de forma separada del sistema de creación en vivo o ejecutando `lb bootstrap --debug`.

741

Además, si se está utilizando una réplica local y/o cualquier tipo de proxy y se experimenta un problema, se debe intentar reproducir siempre preinstalando desde una réplica oficial.

742

14.7.3 En tiempo de arranque

743

Si la imagen no arranca, se debería informar a la lista de correo, junto con la información solicitada en Recopilar información. No hay que olvidar mencionar, cómo y cuándo la imagen falla, si es utilizando virtualización o hardware real. Si se está utilizando una tecnología de virtualización de cualquier tipo, se debe probar la imagen en hardware real antes de informar de un error. Proporcionar una captura de pantalla del error también es muy útil.

744

14.7.4 En tiempo de ejecución

745

If a package was successfully installed, but fails while actually running the Live system, this is probably a bug in live-config.

746

14.8 Dónde informar de los fallos

747

El Debian Live Project realiza un seguimiento de todos los errores en el sistema de seguimiento de errores de Debian (BTS). Para obtener información sobre cómo utilizar el sistema, consultar ‹https://bugs.debian.org/›. También se puede enviar los errores mediante el comando `reportbug` del paquete con el mismo nombre.

748

Hay que tener en cuenta que los errores que se encuentran en las distribuciones derivadas de Debian (como Ubuntu y otras) no deben enviarse al BTS de Debian a menos que también se puedan reproducir en un sistema Debian usando paquetes oficiales de Debian.