Live manual Debian Live

# Debian Live Manual

# Cómo informar acerca de errores.

661

# 14. Informes de errores.

662

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.

663

Para los impacientes:

664

- 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›.

665

- 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.

666

- 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.

667

14.1 Problemas conocidos

668

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

669

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.

670

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 .

671

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).

672

14.2 Hacer la investigación

673

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.

674

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.

675

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.

676

14.3 Reconstruir desde cero

677

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.

678

14.4 Utilizar paquetes actualizados

679

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.

680

14.5 Recopilar información

681

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.

682

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

683

- Arquitectura del sistema anfitrión

684

- Distribución del sistema anfitrión.

685

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

686

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

687

- Arquitectura del sistema en vivo.

688

- Distribución del sistema en vivo.

689

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

690

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

691

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

692

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).

693

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

694

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.

695

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).

696

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`.

697

14.6 Aislar el fallo si es posible

698

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.

699

14.7 Utilizar el paquete correcto sobre el que informar del error

700

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.

701

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

702

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

703

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í.

704

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.

705

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

706

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.

707

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`.

708

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.

709

14.7.3 En tiempo de arranque

710

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.

711

14.7.4 En tiempo de ejecución

712

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

713

14.8 Dónde informar de los fallos

714

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.

715

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.