Live manual Debian Live

# Debian Live Manual

# Informar dels errors

661

# 14. Informar dels errors

662

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.

663

Per als impacients

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

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

667

14.1 Problemes coneguts

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

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

673

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.

674

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.

675

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 .

676

14.3 Reconstruir des de zero

677

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.

678

14.4 Fer servir paquets actualitzats

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ó

681

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.

682

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

683

- Arquitectura del sistema amfitrió

684

- Distribució del sistema amfitrió

685

- Versió de live-build al sistema amfitrió

686

- Versió de debootstrap al sistema amfitrió

687

- Arquitectura del sistema en viu

688

- Distribució del sistema en viu

689

- Versió de live-boot al sistema amfitrió

690

- Versió de live-config al sistema amfitrió

691

- Versió de live-tools al sistema amfitrió

692

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

693

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

694

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.

695

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

696

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

697

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

698

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.

699

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

700

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.

701

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

702

14.7.1 A l'hora de construir mentre bootstrapping

703

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.

704

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.

705

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

706

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.

707

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

708

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.

709

14.7.3 En el moment d'arrencar

710

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.

711

14.7.4 En temps d'execució

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

714

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.

715

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.