DebuggingUpdateManager
|
Size: 2415
Comment:
|
Size: 6096
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| ||<tablestyle="float:right; font-size: 0.9em; width:30%; background:#F1F1ED; background-image: url('https://librarian.launchpad.net/1812570/bugsquad.png'); background-repeat: no-repeat; background-position: 98% 0.5ex; margin: 0 0 1em 1em; padding: 0.5em;">'''Contents'''[[BR]][[TableOfContents]]|| | <<Include(Debugging/Header)>> ||<tablestyle="float:right; font-size: 0.9em; width:30%; background:#F1F1ED; background-image: url('https://librarian.launchpad.net/1812570/bugsquad.png'); background-repeat: no-repeat; background-position: 98% 0.5ex; margin: 0 0 1em 1em; padding: 0.5em;"><<TableOfContents>>|| |
| Line 5: | Line 6: |
| Update-manager provides two services - the ability to upgrade packages within a release, and the ability to upgrade releases of Ubuntu. When looking at bug reports it is important to keep this in mind and identify whether it is a problem with a package upgrade or a release upgrade. | Update-manager provides two services - the ability to upgrade packages within a release, and the ability to upgrade a release of Ubuntu to the next one. When looking at bug reports it is important to keep this in mind and identify whether it is a problem with a package upgrade or a release upgrade. If there is a log attached to the bug (that should be default for gutsy2hardy upgrade failures) then check the main.log first and scroll right to the end. The error should be right there. If its a error from a package, then check out the term.log and search for "dpkg: error", that should have some additional information about the problem. |
| Line 9: | Line 12: |
| When filing a bug report regarding a problem with a distribution or release upgrade you should add every file in '/var/log/dist-upgrade/', there should be at least 3, as separate attachments. You should also tag your distribution upgrade bug with the release you are moving from and to - for example 'feisty2gutsy'. | When filing a bug report regarding a problem with a distribution or release upgrade at a minimum you should add every file in '/var/log/dist-upgrade/', there should be at least 3, as separate attachments. You should also tag your distribution upgrade bug with the release you are moving from and to - for example 'feisty2gutsy'. |
| Line 11: | Line 14: |
| = Debugging procedure = | = Bug Tags = |
| Line 13: | Line 16: |
| For a distribution upgrade in '/var/log/dist-upgrade/' there are three log files that are helpful in debugging the issue: | ||<rowbgcolor="#FFEBBB"> '''Tag''' || '''Use case''' || || [[https://launchpad.net/ubuntu/+bugs?field.tag=hardy2intrepid|`hardy2intrepid`]] || Bugs related to upgrades from Hardy Heron (8.04) to Intrepid Ibex (8.10) || || [[https://launchpad.net/ubuntu/+bugs?field.tag=gutsy2hardy|`gutsy2hardy`]] || Bugs related to upgrading from Gutsy Gibbon (7.10) to Hardy Heron (8.04) || || [[https://launchpad.net/ubuntu/+bugs?field.tag=feisty2gutsy|`feisty2gutsy`]] || Bugs related to upgrading from Feisty Fawn (7.04) to Gutsy Gibbon (7.10) || || [[https://launchpad.net/ubuntu/+bugs?field.tag=edgy2feisty|`edgy2feisty`]] || Bugs related to upgrading from Edgy Eft (6.10) to Feisty Fawn (7.04) || || [[https://launchpad.net/ubuntu/+bugs?field.tag=dapper2hardy|`dapper2hardy`]] || Bugs related to upgrades from Dapper Drake (6.06) to Hardy Heron (8.04) || || [[https://launchpad.net/ubuntu/+bugs?field.tag=cdrom-upgrade|`cdrom-upgrade`]] || Bugs related to an upgrade from CD-ROM or DVD media || The previously described tags are specific to the [[UpdateManager]] application, if you need more general tags please visit [[Bugs/Tags]] page. = Debugging Procedures = For a distribution upgrade in {{{/var/log/dist-upgrade/}}} there are three log files that are helpful in debugging the issue: |
| Line 17: | Line 32: |
| * contains information on how '/etc/apt/sources.list' was handled and updated | * contains information on how {{{/etc/apt/sources.list}}} was handled and updated |
| Line 27: | Line 42: |
| * is a subset of '/var/log/apt/term.log' | * is a subset of {{{/var/log/apt/term.log}}} |
| Line 29: | Line 44: |
= How to Triage = Help with triaging bugs for update-manager is very welcome. It accumulated a lot of reports over time. Some are bugs in update-manager, but some are bugs in packages where update-manager is just the messenger. To find out what exactly is the problem, we always need the log files in {{{/var/log/dist-upgrade/*}}}. Most of the time they provide enough information to know what went wrong. If they are missing, it is recommended to ask for them with a phrase like: {{{ Thanks for taking the time to report this bug and helping to make Ubuntu better. Could you please add the log files from '/var/log/dist-upgrade/' to this bug report as separate attachments? Thanks in advance. }}} If the log shows that the problem is a error from dpkg when processing a package, then please reassign the bug to the package that failed during the upgrade. Also add the relevant lines from when the package failed (found in term.log) as a comment to the bug. == How to Forward == Forwarding of update-manager bugs upstream is not necessary as update-manager is only used by Ubuntu and there is not a traditional upstream. |
|
| Line 35: | Line 63: |
| ||<rowbgcolor="#eeeeee"> '''Bug#''' || '''Description''' || '''Action''' || | ||<rowbgcolor="#eeeeee"> '''Bug''' || '''Description''' || '''Action''' || || [[https://bugs.launchpad.net/ubuntu/+source/update-manager/+bug/107188|107188]] || Out of memory error on KDE || duplicate, no solution yet || |
| Line 38: | Line 67: |
| ||<rowbgcolor="#eeeeee"> '''Bug#''' || '''Description''' || '''Action''' || | ||<rowbgcolor="#eeeeee"> '''Bug''' || '''Description''' || '''Action''' || || [[https://bugs.launchpad.net/ubuntu/+source/update-manager/+bug/280236|280236]] || hangs if a script fails to run || Make bug report a duplicate and ensure reporter updates to 1:0.93.22 || |
| Line 42: | Line 73: |
| * The distribution upgrade will halt if the system has custom, non-Ubuntu, kernel installed. * The distribution upgrade will warn the user if there is not enough free space in '/boot' on their system. |
* When running a development release of Ubuntu you will frequently receive messages when trying to run update-manager that it could not calculate the upgrade. This is expected and happens due to the amount of changes occuring in the repository. * Occasionally update-manager will indicate that it received a 403 message when trying to retrieve a package. If this message occurs when trying to retrieve a package from archive.ubuntu.com or security.ubuntu.com this can be due to a regression in a package that was available there and was subsequently removed. If this message is received when trying to retrieve a package from a mirror it is probably an issue with that mirror. |
| Line 45: | Line 77: |
| = Also see = * DebuggingProcedures |
* The distribution upgrade will warn the user if there is not enough free space on any parition (e.g. '/boot') on their system. The space must be freed and the upgrade restarted. |
| Line 50: | Line 80: |
| CategoryBugSquad | CategoryBugSquad CategoryDebugging |
This page is part of the debugging series — pages with debugging details for a variety of Ubuntu packages. |
Introduction
Update-manager provides two services - the ability to upgrade packages within a release, and the ability to upgrade a release of Ubuntu to the next one. When looking at bug reports it is important to keep this in mind and identify whether it is a problem with a package upgrade or a release upgrade.
If there is a log attached to the bug (that should be default for gutsy2hardy upgrade failures) then check the main.log first and scroll right to the end. The error should be right there. If its a error from a package, then check out the term.log and search for "dpkg: error", that should have some additional information about the problem.
How to file
When filing a bug report regarding a problem with a distribution or release upgrade at a minimum you should add every file in '/var/log/dist-upgrade/', there should be at least 3, as separate attachments. You should also tag your distribution upgrade bug with the release you are moving from and to - for example 'feisty2gutsy'.
Bug Tags
Tag |
Use case |
Bugs related to upgrades from Hardy Heron (8.04) to Intrepid Ibex (8.10) |
|
Bugs related to upgrading from Gutsy Gibbon (7.10) to Hardy Heron (8.04) |
|
Bugs related to upgrading from Feisty Fawn (7.04) to Gutsy Gibbon (7.10) |
|
Bugs related to upgrading from Edgy Eft (6.10) to Feisty Fawn (7.04) |
|
Bugs related to upgrades from Dapper Drake (6.06) to Hardy Heron (8.04) |
|
Bugs related to an upgrade from CD-ROM or DVD media |
The previously described tags are specific to the UpdateManager application, if you need more general tags please visit Bugs/Tags page.
Debugging Procedures
For a distribution upgrade in /var/log/dist-upgrade/ there are three log files that are helpful in debugging the issue:
- 'main.log'
- contains the version of release upgrade and the lsb-release (version of Ubuntu)
contains information on how /etc/apt/sources.list was handled and updated
- contains log information regarding the free space calculation
- contains an overview of the whole process
- may contain python back traces
- 'apt.log'
- contains a dump of the package problem resolver
- it is useful when update-manager says it can not upgrade
- it is also useful for identifying 3rd party repositories that are problematic
- it usually reveals information about incorrect dependencies
- 'term.log'
is a subset of /var/log/apt/term.log
- errors can be found by looking for the string 'dpkg: error'
How to Triage
Help with triaging bugs for update-manager is very welcome. It accumulated a lot of reports over time. Some are bugs in update-manager, but some are bugs in packages where update-manager is just the messenger. To find out what exactly is the problem, we always need the log files in /var/log/dist-upgrade/*. Most of the time they provide enough information to know what went wrong. If they are missing, it is recommended to ask for them with a phrase like:
Thanks for taking the time to report this bug and helping to make Ubuntu better. Could you please add the log files from '/var/log/dist-upgrade/' to this bug report as separate attachments? Thanks in advance.
If the log shows that the problem is a error from dpkg when processing a package, then please reassign the bug to the package that failed during the upgrade. Also add the relevant lines from when the package failed (found in term.log) as a comment to the bug.
How to Forward
Forwarding of update-manager bugs upstream is not necessary as update-manager is only used by Ubuntu and there is not a traditional upstream.
Known bugs
Description of known issues, how to recognise them and stock responses/actions.
Open
Bug |
Description |
Action |
Out of memory error on KDE |
duplicate, no solution yet |
Closed
Bug |
Description |
Action |
hangs if a script fails to run |
Make bug report a duplicate and ensure reporter updates to 1:0.93.22 |
Non-bugs
- When running a development release of Ubuntu you will frequently receive messages when trying to run update-manager that it could not calculate the upgrade. This is expected and happens due to the amount of changes occuring in the repository.
- Occasionally update-manager will indicate that it received a 403 message when trying to retrieve a package. If this message occurs when trying to retrieve a package from archive.ubuntu.com or security.ubuntu.com this can be due to a regression in a package that was available there and was subsequently removed. If this message is received when trying to retrieve a package from a mirror it is probably an issue with that mirror.
- The distribution upgrade will warn the user if there is not enough free space on any parition (e.g. '/boot') on their system. The space must be freed and the upgrade restarted.
DebuggingUpdateManager (last edited 2014-12-07 22:23:09 by penalvch)