Live manual Debian Live

# Debian Live Manual

# Informar dels errors

694

# 14. Informar dels errors

695

Live systems està lluny de ser perfecte, però volem que sigui el més perfecte possible - amb la vostra ajuda. No dubtar d'informar sobre un error. És millor omplir un informe dues vegades que mai. No obstant això, aquest capítol inclou recomanacions sobre com presentar bons informes d'errors.

696

Per als impacients

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

- Intentar donar la informació més específica possible sobre l'error. Això inclou (almenys) la versió de live-build, live-boot, live-config i live-tools i la distribució del sistema en viu que s'està construint.

700

14.1 Problemes coneguts

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 això és massa difícil, no construir un sistema basat en testing o unstable, sinó més aviat, utilitzar stable. live-build sempre construeix la versió stable per defecte.

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 Fer la recerca

706

Abans de presentar l'informe d'errors, cercar a la web el missatge d'error o símptoma que s'està rebent. Ja que és molt poc probable que sigui l'única persona que té un problema en particular. Sempre hi ha una possibilitat que hagi estat discutit en un altre lloc i hi hagi una possible solució, pegat o s'hagi proposat una solució alternativa.

707

S'ha de prestar especial atenció a la llista de correu dels sistemes en viu, així com a la pàgina web, ja que és probable que continguin la informació més actualitzada. Si aquesta informació existeix, incloure una referènca a aquesta en l'informe d'errors.

708

A més, s'hauria de comprovar les llistes d'errors actuals de live-build, live-boot, live-config i live-tools per a veure si ja s'ha informat sobre alguna cosa semblant .

709

14.3 Reconstruir des de zero

710

Per a assegurar-se que un error en particular no és causat per un sistema mal construït, reconstruir sempre tot el sistema en viu a partir de zero per veure si l'error és reproduïble.

711

14.4 Fer servir paquets actualitzats

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ó

714

Proporcionar informació suficient amb l'informe. Incloure, com a mínim, la versió exacta de live-build i els passos per a reproduir-lo. Utilitzar el sentit comú i proporcionar tota altra informació pertinent si es pensa que aixó pot ajudar a resoldre el problema.

715

Per a treure el màxim profit del informe d'errors, es requereix com a mínim la informació següent:

716

- Arquitectura del sistema amfitrió

717

- Distribució del sistema amfitrió

718

- Versió de live-build al sistema amfitrió

719

- Versió de debootstrap al sistema amfitrió

720

- Arquitectura del sistema en viu

721

- Distribució del sistema en viu

722

- Versió de live-boot al sistema amfitrió

723

- Versió de live-config al sistema amfitrió

724

- Versió de live-tools al sistema amfitrió

725

Es pot generar un log del procés de construcció mitjançant l'ordre `tee`. Recomanem fer-ho automàticament amb un script `auto/build` (veure Gestió d'una configuració per a més detalls).

726

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

727

Durant l'arrencada, live-boot i live-config emmagatzemen els seus logs a `/var/log/live/`. Comprovar aquest fitxers per a detectar missatges d'error.

728

A més, per a descartar altres errors, sempre és una bona idea comprimir el directori `config/` i pujar-lo a algun lloc (no enviar-lo com arxiu adjunt a la llista de correu), perquè puguem tractar de reproduir els errors que s'han trobat. Si això és difícil (per exemple, a causa de la mida del arxiu) es pot utilitzar la sortida de `lb config --dump` que produeix un resum del arbre de configuració (és a dir, fa un llistat dels fitxers dins els subdirectoris de `config/`, però no els inclou).

729

Recordar que s'ha d'enviar qualsevol log que es produeixi amb la configuració regional en anglès, per exemple, executar les ordres de live-build començant per `LC_ALL=C` o `LC_ALL=en_US`.

730

14.6 Aïllar el cas que falla, si és possible

731

Si pot ser, aïllar el cas que falla al canvi més petit possible que fa que no funcioni. No sempre és fàcil fer això, per tant, si no es possible fer-ho pel informe, no preocupar-se. No obstant això, si es planeja bé el cicle de desenvolupament, i s'utilitzen petits conjunts de canvis suficients per iteració, es pot ser capaç d'aïllar el problema mitjançant la construcció d'una configuració 'base' més senzilla que s'ajusti a la configuració desitjada més el conjunt de canvis que fa que no funcioni. Si es dificil classificar quins canvis fan que falli, pot ser que s'inclogui massa en cada conjunt de canvis i s'ha de desenvolupar en petits increments.

732

14.7 Utilitzar el paquet correcte per a informar de l'error

733

En general, s'ha d'informar dels errors en temps de construcció contra el paquet live-build, dels errors durant l'arrencada contra live-boot i dels errors de temps d'execució contra live-config. Si no s'està segur de quin paquet és l'adequat o es necessita més ajuda abans d'enviar un informe d'errors, informar contra el pseudopaquet debian-live. Nosaltres ens farem càrrec d'ell i el reassignarem on sigui procedent.

734

No obstant això, estarem molt agraïts si s'intenta limitar la recerca segons el lloc on apareix l'error.

735

14.7.1 A l'hora de construir mentre bootstrapping

736

live-build crea primer un sistema Debian bàsic amb debootstrap. Si un error apareix aquí, comprovar si l'error està relacionat amb un paquet específic de Debian (el més probable), o si està relacionat amb l'eina debootstrap en si mateixa.

737

En ambdós casos, això no és un error del sistema en viu, sinó de Debian en si mateix i, probablement, no ho podem arreglar directament. Informar del error sobre l'eina de debootstrapping o el paquet que falla.

738

14.7.2 A l'hora de construir, durant la instal·lació de paquets

739

live-build instal·la paquets addicionals del arxiu de Debian i en funció de la distribució Debian utilitzada i de l'estat diari de l'arxiu, pot fallar. Si un error apareix aquí, comprovar si l'error és també reproduïble en un sistema normal.

740

Si aquest és el cas, no es tracta d'un error del sistema en viu, sinó de Debian - Informar d'això sobre el paquet que falla. Executar debootstrap per separat de la construcció del sistema Live o executar `lb bootstrap --debug` per a tenir més informació.

741

A més, si es fa servir un mirall local i/o qualsevol tipus de proxy i s'està experimentant algun problema, sempre s'ha de mirar de reproduir-lo fent un bootstrapping a partir d'un mirall oficial.

742

14.7.3 En el moment d'arrencar

743

Si la imatge no arrenca, informar a la llista de correu, juntament amb la informació sol·licitada a Recopilar informació. No oblidar-se d'esmentar, com/quan la imatge falla, ja sigui amb virtualització o maquinari real. Si s'utilitza una tecnologia de virtualització d'algun tipus, sempre fer la prova amb maquinari real abans d'informar d'un error. Proporcionar una captura de pantalla de l'error és també molt útil.

744

14.7.4 En temps d'execució

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 On informar dels errors

747

El Debian Live Project manté un registre de tots els errors en el sistema de seguiment d'errors de Debian (BTS). per a obtenir informació sobre la utilització del sistema, es pot consultar ‹https://bugs.debian.org/›. També es poden enviar els informes dels errors mitjançant l'ordre `reportbug` del paquet amb el mateix nom.

748

Tenir en compte que els errors trobats en les distribucions derivades de Debian (com Ubuntu i altres) no han de ser enviats al BTS de Debian tret que puguin ser reproduïts també en sistemes Debian utilitzant paquets oficials de Debian.