Ubuntu Server Guide

Reporting Bugs in Ubuntu Server
The Ubuntu Project, and thus Ubuntu Server, uses Launchpad as its bug tracker. In order to file a bug, you
will need a Launchpad account. Create one here if necessary.
Reporting Bugs With apport-cli
The preferred way to report a bug is with the apport-cli command. It must be invoked on the machine
affected by the bug because it collects information from the system on which it is being run and publishes
it to the bug report on Launchpad. Getting that information to Launchpad can, therefore, be a challenge if
the system is not running a desktop environment in order to use a browser (common with servers) or if it
does not have Internet access. The steps to take in these situations are described below.
Note
The commands apport-cli and ubuntu-bug should give the same results on a CLI server. The
latter is actually a symlink to apport-bug which is intelligent enough to know whether a desktop
environment is in use and will choose apport-cli if not. Since server systems tend to be CLI-only
apport-cli was chosen from the outset in this guide.
Bug reports in Ubuntu need to be filed against a specific software package, so the name of the package
(source package or program name/path) affected by the bug needs to be supplied to apport-cli:
apport− c l i PACKAGENAME
22

---

Once apport-cli has finished gathering information you will be asked what to do with it. For instance, to
report a bug in vim:
$ apport− c l i vim
*** C o l l e c t i n g problem i n f o r m a t i o n
The c o l l e c t e d i n f o r m a t i o n can be s e n t t o t h e d e v e l o p e r s t o improve t h e
a p p l i c a t i o n . This might t a k e a few minutes .
. . .
*** Send problem r e p o r t t o t h e d e v e l o p e r s ?
A f t e r t h e problem r e p o r t has been s e n t , p l e a s e f i l l out t h e form i n t h e
a u t o m a t i c a l l y opened web bro ws er .
What would you l i k e t o do ? Your o p t i o n s a r e :
S : Send r e p o r t ( 2 . 8 KB)
V: View r e p o r t
K: Keep r e p o r t f i l e f o r s e n d i n g l a t e r o r c o p y i n g t o somewhere e l s e
I : Cancel and i g n o r e f u t u r e c r a s h e s o f t h i s program v e r s i o n
C: Cancel
P l e a s e c h o o s e ( S/V/K/ I /C) :
The first three options are described below:
• Send: submits the collected information to Launchpad as part of the process of filing a new bug report.
You will be given the opportunity to describe the bug in your own words.
*** Uploading problem i n f o r m a t i o n
The c o l l e c t e d i n f o r m a t i o n i s b e i n g s e n t t o t h e bug t r a c k i n g system .
This might t a k e a few minutes .
94%
*** To c o n t i n u e , you must v i s i t t h e f o l l o w i n g URL:
h t t p s : / / bugs . launchpad . n e t / ubuntu/+s o u r c e /vim/+ f i l e b u g /09 b2495a−e2ab −11
e3 −879b−68b5996a96c8 ?
You can l a u n c h a br ows er now , o r copy t h i s URL i n t o a b r ow s e r on a n o t h e r
computer .
C h o i c e s :
1 : Launch a br ow se r now
C : Cancel
P l e a s e c h o o s e ( 1 /C) :
1
The browser that will be used when choosing ‘1’ will be the one known on the system as www-browser
via the Debian alternatives system. Examples of text-based browsers to install include links, elinks,
lynx, and w3m. You can also manually point an existing browser at the given URL.
• View: displays the collected information on the screen for review. This can be a lot of information.
Press ‘Enter’ to scroll by a screenful. Press ‘q’ to quit and return to the choice menu.
23

---

• Keep: writes the collected information to disk. The resulting file can be later used to file the bug
report, typically after transferring it to another Ubuntu system.
What would you l i k e t o do ? Your o p t i o n s a r e :
S : Send r e p o r t ( 2 . 8 KB)
V: View r e p o r t
K: Keep r e p o r t f i l e f o r s e n d i n g l a t e r o r c o p y i n g t o somewhere e l s e
I : Cancel and i g n o r e f u t u r e c r a s h e s o f t h i s program v e r s i o n
C : Cancel
P l e a s e c h o o s e ( S/V/K/ I /C) : k
Problem r e p o r t f i l e : /tmp/ a p p o r t . vim . 1 pg92p02 . a p p o r t
To report the bug, get the file onto an Internet-enabled Ubuntu system and apply apport-cli to it. This
will cause the menu to appear immediately (the information is already collected). You should then
press ‘s’ to send:
apport− c l i a p p o r t . vim . 1 pg92p02 . a p p o r t
To directly save a report to disk (without menus) you can do:
apport− c l i vim −−s a v e a p p o r t . vim . t e s t . a p p o r t
Report names should end in .apport.
Note
If this Internet-enabled system is non-Ubuntu/Debian, apport-cli is not available so the bug
will need to be created manually. An apport report is also not to be included as an attachment
to a bug either so it is completely useless in this scenario.