DebuggingUpdateManager
Size: 3499
Comment: Reorganized based of new template
|
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 7: | Line 8: |
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 at a minimimum 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 13: | Line 16: |
|| Tag || Use case || Link || || `gutsy2hardy` || Bugs related to upgrading from Gutsy Gibbon to Hardy Heron || [https://launchpad.net/ubuntu/+bugs?field.tag=gutsy2hardy link] || || `feisty2gutsy` || Bugs related to upgrading from Feisty Fawn to Gutsy Gibbon || [https://launchpad.net/ubuntu/+bugs?field.tag=feisty2gutsy link] || || `edgy2feisty`|| Bugs related to upgrading from Edgy Eft to Feisty Fawn || [https://launchpad.net/ubuntu/+bugs?field.tag=edgy2feisty link] || || `dapper2edgy`|| Bugs related to upgrades from Dapper Drake to Edgy Eft || [https://launchpad.net/ubuntu/+bugs?field.tag=dapper2edgy link] || || `cdrom-upgrade`|| Bugs related to an upgrade from CD-ROM or DVD media || [https://launchpad.net/ubuntu/+bugs?field.tag=cdrom-upgrade link] || |
||<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 || |
Line 20: | Line 24: |
The previously described tags are specific to the [:UpdateManager] application, if you need more general tags please visit [:Bugs/Tags] page. | The previously described tags are specific to the [[UpdateManager]] application, if you need more general tags please visit [[Bugs/Tags]] page. |
Line 24: | Line 28: |
For a distribution upgrade in '/var/log/dist-upgrade/' there are three log files that are helpful in debugging the issue: | For a distribution upgrade in {{{/var/log/dist-upgrade/}}} there are three log files that are helpful in debugging the issue: |
Line 28: | 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 38: | Line 42: |
* is a subset of '/var/log/apt/term.log' | * is a subset of {{{/var/log/apt/term.log}}} |
Line 40: | 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 46: | Line 63: |
||<rowbgcolor="#eeeeee"> '''Bug#''' || '''Description''' || '''Action''' || || https://bugs.edge.launchpad.net/ubuntu/+source/update-manager/+bug/107188 || Out of memory error on KDE || duplicate, no solution yet || |
||<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 50: | 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 54: | Line 73: |
* 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 56: | Line 79: |
= Also see = * DebuggingProcedures |
|
Line 61: | 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)