:B~ Informar dels errors

1~bugs Informar dels errors

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

Per als impacients

_* Sempre consultar primer les actualitzacions del estat de la imatge a la
nostra pàgina web a http://live.debian.net/ per veure els problemes
coneguts.

_* Sempre tractar de reproduir l'error amb *{les versions més recents}* de
live-build, live-boot, live-config i live-tools abans d'enviar un informe
d'errors.

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

2~ Problemes coneguts

Ja que les distribucions Debian *{testing}* i Debian *{unstable}* són blancs
mòbils, quan s'especifica una d'elles com sistema de destinació, no sempre
és possible construir amb èxit.

% FIXME:

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.

El problemes coneguts es mostren sota la secció 'status' a la nostra pàgina
web a http://live.debian.net/.

Està fora de l'abast d'aquest manual ensenyar a identificar correctament i
solucionar els problemes dels paquets de les distribucions en
desenvolupament, però, hi ha dues coses que sempre es pot provar: Si la
construcció falla quan la distribució de destinació és *{testing}*, provar
*{unstable}*. Si *{unstable}* tampoc funciona, tornar a *{testing}* i fer un
pin de la versió més recent del paquet que falla de *{unstable}* (veure {APT
pinning}#apt-pinning per més detalls).

2~ Reconstruir des de zero

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

2~ Fer servir paquets actualitzats

La utilització de paquets obsolets pot causar problemes significatius al
tractar de reproduir (i en última instància, arreglar) el
problema. Comprovar que el sistema de construcció està actualitzat i tots
els paquets inclosos en la imatge estan també actualitzats.

2~collect-information Recopilar informació

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.

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

_* Arquitectura del sistema amfitrió

_* Versió de live-build al sistema amfitrió

_* Versió de /{debootstrap}/ i/o /{cdebootstrap}/ al sistema amfitrió

_* Arquitectura del sistema en viu

_* Distribució del sistema en viu

_* Versió de live-boot al sistema amfitrió

_* Versió de live-config al sistema amfitrió

_* Versió de live-tools al sistema amfitrió

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ó}#managing-a-configuration per més detalls).

code{

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

}code

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

A més, per 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 del tamany 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).

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

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

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.

2~ Utilitzar el paquet correcte per informar de l'error

Si no és clar quin component és el responsable de l'error o si l'error és
general pel que fa als sistemes vius, es pot omplir un informe d'errors
sobre el pseudopaquet debian-live.

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

3~ A l'hora de construir mentre bootstrapping

live-build crea primer un sistema Debian bàsic amb /{debootstrap}/ o
/{cdebootstrap}/. Depenent de l'eina utilitzada i la distribució Debian que
s'està creant mitjançant el bootstrapping, pot fallar. 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 a l'eina bootstraping en si mateixa.

En ambdós casos, això no és un error de Debian Live, 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.

3~ A l'hora de construir, durant la instaŀlació de paquets

live-build instaŀ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.

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

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.

3~ En el moment d'arrencar

Si la imatge no arrenca, informar a la llista de correu, juntament amb la
informació soŀlicitada a {Recopilar informació}#collect-information. 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.

3~ En temps d'execució

Si un paquet s'ha instaŀlat correctament, però falla quan s'executa el
sistema en viu, això és probablement un error a Debian Live. No obstant
això:

2~ Fer la recerca

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.

S'ha de prestar especial atenció a la llista de correu de Debian Live, 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.

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

2~ On informar dels errors

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

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.

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.
