DebuggingUbiquity

Revision 47 as of 2012-02-24 16:24:25

Clear message

Debugging Central

This page is part of the debugging series — pages with debugging details for a variety of Ubuntu packages.

Crash report handling

Many Ubiquity bugs arrive in the form of cut-and-pastes from its crash helper dialog. In simple cases, these are often enough to completely diagnose the bug and allow a developer to fix it, which is why the crash dialog exists. However, if the crash occurs in install.py (the component of Ubiquity that actually constructs and configures the newly-installed system), then in Dapper a combination of technical awkwardness and lack of developer time means that the traceback from the crash dialog often ends like this:

RuntimeError: Install failed with exit code 1; see /var/log/installer/syslog and /var/log/syslog

(Edgy installations will produce a more verbose traceback.)

This traceback is moderately useless on its own, and you must not mark bugs as duplicates on the basis that they both contain a traceback such as this. In Dapper, the real error is hidden in /var/log/installer/syslog, so if the reporter didn't attach that, ask for it, and for /var/log/syslog and /var/log/partman as well for good measure. Look for the traceback from the crash dialog in /var/log/installer/syslog and then trace up a little bit; the real error should be there, often in the form of a subprocess exiting non-zero.

Standard text for asking for log files in Dapper:

Could you please attach /var/log/installer/syslog, /var/log/syslog, and /var/log/partman to this bug, following the directions in http://wiki.ubuntu.com/DebuggingUbiquity/AttachingLogs? Thanks in advance.

Standard text for asking for log files in >= Edgy:

Could you please attach /var/log/syslog and /var/log/partman to this bug, following the directions in http://wiki.ubuntu.com/DebuggingUbiquity/AttachingLogs? Thanks in advance.

Don't ask for /var/log/installer/syslog if the version of ubiquity in the log is 1.1.12 or greater (Edgy or later). Those versions of ubiquity send all log messages apart from certain detailed partitioning log messages to /var/log/syslog, and /var/log/installer/syslog no longer exists.

Please do not assign ubiquity bugs to anyone unless you're a ubiquity developer or you manage a ubiquity developer. Please don't reject ubiquity bugs unless you're a ubiquity developer. In general, please try to refrain from causing unnecessary extra bug mail noise for ubiquity developers or from taking items off their to-do lists without consulting them first.

Known bugs

Before filing new bugs, check that it is not already listed in Launchpad

Non-bugs

Certain hardware failures can often be reported as installer bugs. This includes faulty CDs, CD drives hard drives and memory.

Notes

The 'kernel command line' line of the syslog file contains information about the boot parameters used.

  • Images created by unetbootin contain 'initrd=/ubninit' and / or 'BOOT_IMAGE=/ubnkern'

Bugs should be tagged indicating the step where the issue occurred if possible. The possible steps are:

  • ubi-console-setup
  • ubi-language
  • ubi-migrationassistant
  • ubi-network
  • ubi-partman
  • ubi-prepare
  • ubi-tasks
  • ubi-timezone
  • ubi-usersetp - "Who are you?"
  • ubi-webcam
  • ubi-wireless


Also see:


CategoryBugSquad CategoryDebugging