Live manual Debian Live

# Debian Live Manual

# Zgłaszanie błędów

661

# 14. Zgłaszanie błędów

662

Systemy live są dalekie od doskonałości, ale chcemy, uczynić je jak najbliższe perfekcji - z Waszą pomocą. Nie wahaj się zgłosić błąd. Lepiej jest wypełnić raport dwa razy niż wcale. Ten rozdział zawiera zalecenia dotyczące sposobu składania raportów o błędach.

663

Dla niecierpliwych:

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

- Spróbuj podać jak najwięcej specyficznych informacji, jak to tylko możliwe o błędzie. Obejmuje to (co najmniej) wersję używanych live-build, live-boot, live-config i live-tools oraz dystrybucję systemu live którą kompilujesz.

667

14.1 Znane problemy

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

Jeśli budowanie systemu opartego na testing lub unstable powoduje u Ciebie zbyt wiele trudności, raczej wykorzystaj wydanie stable. live-build zawsze ustawia domyślnie wydanie 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 Spróbuj wykonać parę kroków

673

Przed zgłoszeniem błędu, proszę poszukaj w internecie danego komunikatu o błędzie lub objawu jaki otrzymujesz. Ponieważ jest mało prawdopodobne, że jesteś jedyną osobą, która zmaga się ze szczególnym problem. Zawsze jest szansa, że został on już omówiony w innym miejscu i zaproponowano już możliwe rozwiązanie, obejście lub patch.

674

Należy zwrócić szczególną uwagę na listę mailingową systemów live, jak również strona główna, ponieważ zawierają one prawdopodobnie najbardziej aktualne informacje. Jeśli takowa informacja istnieje, zawsze należy zawrzeć odniesienie do niej w swoim raporcie o błędzie.

675

Ponadto, należy sprawdzić aktualne wykazy błędów dla live-build, live-boot, live-config i live-tools, aby zobaczyć, czy coś podobnego nie zostało już zgłoszone.

676

14.3 Przebuduj od zera

677

Aby upewnić się, że dany błąd nie jest spowodowany nie w pełni wyczyszczonym budowanym systemem, proszę zawsze odbudować cały system live od podstaw, aby sprawdzić, czy błąd jest powtarzalny.

678

14.4 Używaj aktualnych pakietów

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 Zbierz potrzebne informacje

681

Proszę dostarczyć wystarczającą ilość informacji z raportem. Obejmujące co najmniej, dokładną wersję live-build, gdzie napotkano błąd i kroki, jak go odtworzyć. Proszę użyć zdrowego rozsądku i przedstawić wszelkie inne istotne informacje, jeśli uważasz, że może to pomóc w rozwiązaniu problemu.

682

Aby w pełni wykorzystać Twój raport o błędzie, będziemy potrzebować przynajmniej następujących informacji:

683

- Architektura systemu hosta

684

- Dystrybucja systemu hosta

685

- Wersja live-build na systemie hosta

686

- Version of debootstrap on the host system

687

- Architektura systemu live

688

- Dystrybucja systemu live

689

- Wersja live-boot na systemie live

690

- Wersja live-config na systemie live

691

- Wersja live-tools na systemie live

692

Można wygenerować log procesu kompilacji przy użyciu polecenia `tee`. Polecamy robić to automatycznie przy użyciu skryptu `auto/build` (patrz Zarządzanie konfiguracją w celu uzyskania szczegółów).

693

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

694

W czasie uruchamiania live-boot i live-config przetrzymują swoje logi w `/var/log/live/`. Sprawdź je w poszukiwaniu błędów.

695

Dodatkowo, aby wykluczyć inne błędy, zawsze dobrym pomysłem jest, aby spakować do archiwum tar swój katalog `config/` i przesłać go gdzieś (nie należy wysłać go jako załącznik do listy), tak aby można spróbować odtworzyć napotkane błędy. Jeśli sprawia to trudność (np. ze względu na rozmiar) można użyć wyjścia z polecenia `lb config --dump`, które tworzy podsumowanie drzewa konfiguracyjnego (czyli np. listę plików w podkatalogach `config/`, ale bez załączania ich).

696

Pamiętaj, aby wysłać wszystkie dzienniki i logi, które zostały wyprodukowane z ustawień regionalnych angielskich, np. uruchom polecenia live-build ze zmiennymi `LC_ALL=C` lub `LC_ALL=en_US`.

697

14.6 Wyizoluj prawdopodobną wadę, jeśli to możliwe

698

Jeśli to możliwe, należy wyizolować przypadek do najmniejszej zmiany, które generuje błąd. Nie zawsze jest łatwo to zrobić, więc jeśli nie możesz dodać takiej informacji do raportu, nie martw się. Jednakże, jeśli użytkownik dobrze planuje swój cykl rozwoju, przy użyciu małych zestawów zmian na iterację, można być w stanie wyizolować problem poprzez budowę prostszej konfiguracji "bazy", która blisko pasuje do rzeczywistej konfiguracji oraz tylko uszkodzony zestaw zmian do niej dodany. Jeśli masz trudności z sortowaniem, które z Twoich zmian wygenerowały błąd, może to znaczyć, że uwzględniono za dużo w każdym zestawie zmian i powinno się raczej kształcić w mniejszych krokach.

699

14.7 Wybierz odpowiedni pakiet dla którego zgłaszasz błąd

700

Ogólnie rzecz biorąc, należy zgłaszać błędy podczas kompilacji: jako dotyczące pakietu live-build, błędy podczas uruchamiania: live-boot oraz błędy w czasie działania systemu live: jako dotyczące live-config. Jeśli nie jesteś pewien, który pakiet będzie odpowiedni lub potrzebujesz więcej pomocy, przed złożeniem zgłoszenia błędu, zgłoś raport dotyczący pseudo-pakietu debian-live. Zajmiemy się wtedy nim i przypiszemy do odpowiedniego pakietu.

701

Jednak będziemy wdzięczni, jeśli postarasz się zawęzić pole możliwości, w których może pojawiać się błąd.

702

14.7.1 W czasie budowania podczas ładowania początkowego (bootstrapping)

703

live-build first bootstraps a basic Debian system with debootstrap. If a bug appears here, check if the error is related to a specific Debian package (most likely), or if it is related to the bootstrapping tool itself.

704

W obu przypadkach nie jest to błąd w systemie live, ale w samym Debianie i prawdopodobnie nie możemy naprawić go bezpośrednio. Proszę zgłosić taki błąd jako dotyczący narzędzia ładowania początkowego (ang. bootstraping tool) lub uszkodzonego pakietu.

705

14.7.2 W czasie budowania podczas instalacji pakietów

706

live-build instaluje dodatkowe pakiety z archiwum Debiana i w zależności od używanej dystrybucji Debian i codziennego stanu archiwum, może się to nie powieść. Jeśli błąd pojawi się w tym miejscu, należy sprawdzić, czy błąd jest powtarzalny w normalnym systemie.

707

Jeśli jest to przypadek, gdzie błąd nie występuje w systemie live, ale w Debianie - zgłoś go jako dotyczący wadliwego pakietu. Uruchomienie debootstrap niezależnie od samej kompilacji systemu live lub uruchomianie `lb bootstrap - debug` daje więcej informacji.

708

Ponadto, w przypadku korzystania z lokalnego serwera lustrzanego i/lub jakichkolwiek serwerów proxy i doświadczania problemów prosimy zawsze najpierw spróbować odtworzyć czyności z użyciem oficjalnego serwera lustrzanego.

709

14.7.3 W czasie uruchamiania

710

Jeśli obraz nie uruchamia się, należy zgłosić go do listy wraz z informacjami wymaganymi w Zbierz potrzebne informacje. Nie zapomnij wspomnieć, jak/kiedy dokładnie obraz nie zadziałał, czy był użyty za pomocą wirtualizacji lub rzeczywistego sprzętu. Jeśli korzystasz z technologii wirtualizacji w jakiejkolwiek formie, proszę zawsze uruchomić go na prawdziwym sprzęcie przed zgłoszeniem błędu. Zapewnienie zrzutu ekranu awarii jest również bardzo pomocne.

711

14.7.4 W czasie gdy system jest już uruchomiony

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 Gdzie zgłaszać błędy

714

Debian Live Project śledzi wszystkie błędy w systemie śledzenia błędów (BTS). Aby uzyskać informacje na temat korzystania z tego systemu, zobacz ‹https://bugs.debian.org/›. Możesz też przesłać błędy używając polecenia #{reportbug} z pakietu o tej samej nazwie.

715

Należy pamiętać, że błędy znalezione w dystrybucji pochodzących od Debiana (takich jak Ubuntu, i inne) nie powinny być zgłaszane do BTS Debiana, chyba że błędy te mogą być odtworzone w Debianie przy użyciu oficjalnych pakietów Debiana.