Manual de Live Systems

Informar dels errors

Informar dels errors

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.

Per als impacients

●  Sempre consultar primer les actualitzacions del estat de la imatge a la nostra pàgina web a http://live-systems.org/ per a veure els problemes coneguts.

●  Abans d'enviar un informe d'errors, sempre tractar de reproduir l'error amb les versions més recents de la branca de live-build, live-boot, live-config i live-tools què utilitzeu (com la darrera versió 4.x de live-build si s'utilitza live-build 4).

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

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.

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-systems.org/.

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 per a més detalls).

Reconstruir des de zero

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.

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.

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 a treure el màxim profit del informe d'errors, es requereix com a mínim la informació següent:

●  Arquitectura del sistema amfitrió

●  Distribució del sistema amfitrió

●  Versió de live-build al sistema amfitrió

●  Versió de debootstrap 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ó per a més detalls).

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

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.

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

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.

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.

Utilitzar el paquet correcte per a 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.

A l'hora de construir mentre bootstrapping

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 a l'eina bootstraping en si mateixa.

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.

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

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.

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

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.

En el moment d'arrencar

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.

En temps d'execució

Si un paquet s'ha instal·lat correctament, però falla quan s'executa el sistema Live, això és probablement un error al sistema en viu. No obstant això:

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

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 .

On informar dels errors

El ${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.

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.



License: Aquest programa és un programari lliure: es pot redistribuir i/o modificar sota els termes de la Llicència Pública General de la GNU com és publicada per la Free Software Foundation, ja sigui la versió 3 de la Llicència, o (si ho preferiu) qualsevol versió posterior.

Aquest programa es distribueix amb l'esperança que sigui útil, però sense cap garantia, fins i tot sense la garantia implícita de COMERCIALITZACIÓ o ADEQUACIÓ PER A PROPÒSITS DETERMINATS. Vegeu la Llicència General Pública de la GNU per a més detalls.

Haurieu de rebre una còpia de la Llicència Pública General de la GNU amb aquest programa. Si no és així, consulteu http://www.gnu.org/licenses/.

El text complet de la Llicència Pública General de la GNU es pot trobar a /usr/share/common-licenses/GPL-3.


SiSU Spine (object numbering & object search) 2022